BSCOutline Frequently Asked Questions

This document is intended to provide answers to any question you may have regarding the Java outline applet BSCOutline.
If you don't find the answer to your question in this document then please send an e-mail to Outline@byte-sized.com
  1. I can't get the tree to look right, what an I doing wrong?
  2. I'm getting string errors when I use the DataX Lines in the applet tag instead of an out file, why?
  3. I've just tried to register but the register form asked for my domain, I don't want to disclose this info/it's on an intranet!
  4. Is BSCOutline 100% pure Java?
  5. I can't get the applet to work properly in Internet Explorer 4, Why?
  6. When I run BSCOutline on my machine locally, I get an "AppletSecurityException" Error
  7. Can you customise BSCOutline for my needs?
  8. Why is there only one .CLASS file, all the other outline control have three or four .CLASS files?
  9. Can I reduce the download time any further for my users?
  10. What code do I need to place in my HTML page for the applet?
  11. I just purchased the source code, How can I download it?
  12. I'd like to find out about your commercial redistribution program.
  13. Why does my outline have Byte-Sized Computing at the top?
  14. Can I use the BSCOutline on multiple web-sites?
  15. I can't seem to get the font parameter to set correctly.
  16. My web-site has two domains. How can I use the applet so that the nag lines don't appear on one of the domains.
  17. Is there any way that I can synchronize the outline with the contents of the text frame?
  18. How do I keep it from opening a new browser? I just want it to stay in the same browser when it links somewhere and I am not using frames.
  19. I have folders that are open at startup of BSCOutline. How can you make sure folders initialize Closed?
  20. How can I get the tree to resize properly if I use width=100%, Is this a bug??
  21. I sometimes get a grey box instead of the applet if I use percentages, Is this a bug??
  22. How to I turn on Java Logging??
  23. I'm using IIS or Windows Server 2003 and the applet will not work, why?

Q: I can't get the tree to look right, what an I doing wrong?
A: Most of these problems are caused by errors in the .out file. This is a common problem and seems to stem from not visualising what you will get(not being able to see the wood for the trees!). Try indenting the lines in the .out file by the number of spaces of the level of the tree. i.e. If the node is at level 2 put two spaces before the 2, if it's at level 3 then put three spaces etc. This makes it very easy to see if you are going to get what you expect. e.g. 1       "First Folder"   2       "Level 2 Folder"    3      "Level 3 Document"    3      "Level 3 Document"   3      "Level 3 Folder"    4     "Level 4 Document"    4     "Level 4 Document"   3      "Level 3 Folder"    4     "Level 4 Document"    4     "Level 4 Document" 1        "Level 1 Folder"   2       "Level 2 Document"   2       "Level 2 Document"
Return to Top
Q: I'm getting string errors when I use the DataX Lines in the applet tag instead of an out file, why?
A: BSCOutline uses the | character for it's delimeters in the PARAM tag. Make sure there is a "|" at the end of the data line. e.g. <PARAM NAME=Data1 VALUE="1|1|Web Site|interest.htm|"> Note the Pipe at the end! ------------------------^
Return to Top
Q: I've just tried to register but the register form asked for my domain, I don't want to disclose this info/it's on an intranet!
A: We NEED the hostname on which the applet is intended to be run. We calculate your registration code based on this name. Without it we cannot provide you a registration code to disable the top two "nag" lines. Typically we need whatever you type to get to the page... e.g. for -> http://www.byte-sized.com/home.htm We need -> www.byte-sized.com for -> http://intranet.mycompany/home.htm We need -> intranet.mycompany
Return to Top
Q: Is BSCOutline 100% pure Java?
A: Yes, BSCOutline is written entirely in Java and extends only classes contained in Sun's Abstract Windows Toolkit, a part of the standard Java distribution. Thus it runs in any browser, on any platform that is 100% Java compatible.
Return to Top
Q: I can't get the applet to work properly in Internet Explorer 4, Why?
A: The problem is most likely that you have set the width and height of the applet in percentages, IE4 doesn't like the width or height of the applet in percentages. Put number of pixels instead of percentage, that should fix the problem.
Return to Top
Q: When I run BSCOutline on my machine locally, I get an "AppletSecurityException" Error
A: This is a known problem with some versions of Internet Explorer and happens with most applets. Microsoft has updated the Java Virtual Machine (VM) to overcome this. Please download the latest VM from Microsoft. Alternatively if you copy the .class file into your C:\WINDOWS\JAVA\CLASSES directory it will work around the problem.
Return to Top
Q: Can you customise BSCOutline for my needs?
A: We most certainly can! Please send us an e-mail with your requirements and we will send a quotation.
Return to Top
Q: Why is there only one .CLASS file, all the other outline control have three or four .CLASS files?
A: BSCOutline has been written into ONE .CLASS file to keep the download time to a minimum. Each file requested by a users' browser required a separate connection to the server. One of the most noticable problems with most outline applets is that they take so long to show something useful on the users screen.
Return to Top
Q: Can I reduce the download time any further for my users?
A: You can reduce the download time for Microsoft Internet Explorer users by packing the .CLASS file into a .cab file. You will need to add the following to your <APPLET> tag. <PARAM NAME="CABBASE" VALUE="BSCOutline.cab">
Return to Top
Q: What code do I need to place in my HTML page for the applet?
A: Below is an example <APPLET> tag. You will need to place a similar tag into your HTML page. <APPLET CODE=BSCOutline.class NAME=Outline WIDTH=240 HEIGHT=360> <PARAM NAME=Icon1 VALUE="fold1c.gif"> <PARAM NAME=Icon1O VALUE="fold1o.gif"> <PARAM NAME=Icon2 VALUE="fold2c.gif"> <PARAM NAME=Icon2O VALUE="fold2o.gif"> <PARAM NAME=Icon3 VALUE="doc1.gif"> <PARAM NAME=Icon4 VALUE="doc2.gif"> <PARAM NAME=Icon5 VALUE="doc3.gif"> <PARAM NAME=Icon6 VALUE="doc4.gif"> <PARAM NAME=OutlineFile VALUE="example.out"> <PARAM NAME=FontFace value="Arial"> <PARAM NAME=FontStyle value=2> <PARAM NAME=FontSize VALUE=12> <PARAM NAME=FontColour VALUE="006600"> <PARAM NAME=BackColour VALUE="D0D0C0"> <PARAM NAME=SelectColour VALUE="FFFF00"> <PARAM NAME=Target VALUE="outlineframe"> <PARAM NAME=ShowLines VALUE=1> <PARAM NAME=ShowIcons VALUE=1> </APPLET>
Return to Top
Q: I just purchased the source code, How can I download it?
A: The source code will be e-mailed directly to you when we recieve your payemnt. Thanks for purchasing! Please be patient, we will normally send out the source code within 24 hours of payment confirmation.
Return to Top
Q: I'd like to find out about your commercial redistribution program.
A: The Redistribution Lience is what you need, Please send us an e-mail with the details.
Return to Top
Q: Why does my outline have Byte-Sized Computing at the top?
A: This is only on the shareware version. It has been put there as an incentive to register. Registered users will get code to disable these two lines.
Return to Top
Q: Can I use the BSCOutline on multiple web-sites?
A: Most Licences are for single web domains, that is you can use it anywhere on www.mydomain.com. If you wish to use it on multiple domains, please register multiple copies!
Return to Top
Q: I can't seem to get the font parameter to set correctly.
A: You probably specified a font name that isn't available under your Operating System; this is one of those cross-platform differences that can bite you if you over-specify for one platform, like specifying "Arial" as a font and expecting it to work on something other than Windows. Font names which are pretty cross-platform independant are :- Dialog SansSerif Serif Monospaced Helvetica TimesRoman Courier DialogInput
Return to Top
Q: My web-site has two domains. How can I use the applet so that the nag lines don't appear on one of the domains.
A: OK say that you have two domains pointing to the same site... e.g. www.byte-sized.com and www.bscoutline.com
Once you have registered one of the domain names e.g. www.byte-sized.com put a codebase parameter in the applet tag to point to the correct domain name in the following form...
CODEBASE=codebaseURL Specifies the base URL of the applet (the directory in which the applet is located). <APPLET CODEBASE="http://www.byte-sized.com/applets/" CODE=BSCOutline.class WIDTH=100 HEIGHT=200> <PARAM NAME=.... ... ... ... </APPLET>
Return to Top
Q: Is there any way that I can synchronize the outline with the contents of the text frame?
A: Call the SetState function in the applet, it takes the same parameters as the InitialState parameter. e.g. <INPUT TYPE=BUTTON VALUE="Set State" ONCLICK="BSCOutline.SetState('0|0|0|1|2|5|')">
Return to Top
Q: How do I keep it from opening a new browser? I just want it to stay in the same browser when it links somewhere and I am not using frames.
A: Set the Target parameter to "_self" or "_top" or "_parent"
Return to Top
Q: I have folders that are open at startup of BSCOutline. How can you make sure folders initialize Closed?
A: Use the InitialState paramater to define which nodes are open at startup, this parameter is explained in the help file.
Return to Top
Q: How can I get the tree to resize properly if I use width=100%, Is this a bug??
A: Yes this is a bug, but NOT in BSCOutline! The problem is the browser implementation of Java.
One way around this is to force the browser to reload the applet when the frame is resized. The following code can be used to achieve this... e.g. <SCRIPT><!--Reload if resized --> function init() { setTimeout("window.onresize = redo", 1000); } function redo() { location.reload(); } window.onload = init; </SCRIPT>
Return to Top
Q: I sometimes get a grey box instead of the applet if I use percentages, Is this a bug??
A: Yes this is a bug, but NOT in BSCOutline! The problem is the browser implementation of Java.
Percentages do not work properly in all browsers, as such we do not recommend using them.
Return to Top
Q: I sometimes get a grey box but I am not using percentages, What is happening??
A: Sometimes the errors in the .out file or HTML page are so severe that BSCOutline cannot even display the error message!
Never fear, the error messages are also logged in the Java Log and are displayed in the Java Console.
Both of these can be turned on in the browser options. In Internet Explorer it is located under "Tools" "Internet Options" "Advanced"
Once the logging and console is enabled you can view the error messages using "View" "Java Console".
Return to Top
Q: I'm using IIS or Windows Server 2003 and the applet will not work, why?
A: Windows Server 2003 appears the be restricted in the MIME types that it accepts, as such it will not serve the .out file.
The remedy is to either add a new MIME type for the .out file (as text type) or to rename the .out file as .txt and use that instead.
Copyright © 2008 Byte-Sized Computing Limited
Byte-Sized Computing Limited
Registered in England and Wales 11th April 2000. Registered number 03970389