11.8.1.4 Specifying window-access object properties
You specify properties for window-access objects
by assigning values to object-property keywords in section [JavaHelpOptions]. Table 11
§11.8.1.4.1 Changing window type, size, or position via access object
§11.8.1.4.2 Specifying link properties via window-access object
11.8.1.4.1 Changing window type, size, or position via access object
For window type, size, and position you can do the following:
Specify pop-up window size but not position
Specify secondary window size and position
Override secondary window type
Specify pop-up window size but not position
Only one type of pop-up window can be defined, so in the absence of overrides, all pop-up window-access properties apply to all pop-up links and windows. The only way to specify different sizes for different pop-up windows is by inserting special markers before individual pop-up hotspots; see §11.8.1.5 Overriding window-access properties with markers.
Pop-up window position is not configurable; a pop-up window always pops up immediately under the link.
Specify secondary window size and position
The secondary-window size and position settings
listed in Table 11
Override secondary window type
The default value for [JavaHelpOptions]SecName
is empty (see Table 11
§7.7 Jumping to secondary windows in Help systems
§11.8.1.1 Assigning default window parameters for JavaHelp 2
Table 11
One comma, no space between pixel values; these settings override corresponding helpset parameters |
||||
Default is the secondary window assigned in [SecWindows] to a given jump-hotspot format |
||||
11.8.1.4.2 Specifying link properties via window-access object
You can specify a button, a text string, or a
graphic for JavaHelp 2 to display as a window-access object for a pop-up
link or a secondary-window jump. If you specify a text string, you can
assign values to font keywords to apply a limited amount of formatting.
Table 11
Prefix base keywords with “Pop” or “Sec”
You must supply a prefix for each of the object-property
base keywords listed in Table 11
• For a pop-up window, prefix the keyword with Pop; for example:
PopGraphic = ../graphics/popicon.gif
• For a secondary window, prefix the keyword with Sec; for example:
Table 11
When Type=Button (default), the value of keyword Text is the label When Type=Graphic, the value of keyword Text (or keyword Graphic) is the location of the image file When Type=Text, Font* properties apply to the value of keyword Text |
||
|
When Type=Graphic, value is the relative URL of the GIF or JPEG file |
||
|
When Type=Text, Font* properties apply to the value of keyword Text When Type=Graphic, value can be the location of the image (which can be specified as a value either for keyword Text or for keyword Graphic) |
||
Pop-up window default is SansSerif Secondary window default is Serif Not all FontFamily values work the way you might expect them to work |
||
|
bigger increases the size by one index |
||
blue (default), black, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, yellow |
||
* Prefix the base keyword with one of the following: |
||
Despite the limited font-tweaking possibilities
listed in Table 11
Multiple markers for each hotspot
To actually create a text hotspot with context-specific content, you would have to insert a collection of markers, all different, before every pop-up link or secondary-window jump in a file, to handle the varying text content and properties—to the limited extent that you can do so. See §11.8.1.5 Overriding window-access properties with markers.
Not all “special” characters work
Keep in mind that JavaHelp does not support the “undefined” characters with ASCII decimal values from 128 through 159, even though these characters are used heavily in Windows for quotes, bullets, and so forth. See §13.16.2 Replacing high ASCII characters for W3C validation.
