SCROLLBAR Property

PLBCMP GUI Only

The SCROLLBAR property specifies the type of scrollbar provided with an object. The property uses the following format:

SCROLLBAR[={value}]

Note the following:

1. SCROLLBAR may be used in CREATE, SETPROP, or GETPROP statements.

2. If the SCROLLBAR property is specified without an assignment, the action is the same as if SCROLLBAR=1 were given.

3. {value} is a decimal number, a Numeric Variable, an Expression, or a keyword as defined in PLBEQU.INC. The supported values and keywords are:

 

Value	Keyword	Scrollbars are ...
0	$NONE	not displayed. (default)
1	$SCRBOTH	both horizontal and vertical.
2	$SCRHORZ	horizontal.
3	$SCRNONE	not displayed.
4	$SCRVERT	vertical.

 

4. When defining scrollbars with DATALIST object, the HORZEXTENT property must be defined.

5. When using the PL/B Web Server:

1. The HTML scrollbar implementation does not support the property values of $SCRHORZ and $SCRVERT where a single scrollbar orientation is forced. These property values execute the same as the $SCRBOTH property value. The PWS runtime cannot force a single scrollbar with a given orientation.

2. The HTML scrollbar support is implemented using a class style for automatic rendering by the client browser. The use of the auto mode style gives the most flexibility so the client browser only shows the required scrollbars for any orientation. The scrollbar classes can be found in the 'plbwebbasic.css' HTTP_ROOT file as 'sb1', 'sb2', 'sb3', and 'sdb4'.

6. When using the HTMLCONTROL object, the SCROLLBAR property allows horizontal and vertical scrollbars to be created when an overflow condition is detected. The scrollbar behaviors depend on the type of PL/B runtime being used,

 

When using a PL/B Web Server, the SCROLLBAR values are described as follows:

 

Value	Keyword	Scrollbars are ...
0	$NONE	not displayed. (default)
1	$SCRBOTH	automatically displayed including both the horizontal and vertical scrollbars.
2	$SCRHORZ	horizontal
3	$SCRNONE	not displayed.
4	$SCRBOTH	Vertical

 

When using a Windows Plbwin, Plbnet, or Plbserve runtime, the scrollbar behaviors are controlled by the Windows IWebBrowser2 ActiveX control. In this case, the Windows IWebBrowser2 ActiveX control enables or disables both horizontal and vertical scrollbars together. Therefore, the 'SCROLLBAR' property values for the Windows HTMLCONTROL have the following behaviors:

 

Value	Keyword	Scrollbars are ...
0	$NONE	not displayed. (default)
1	$SCRBOTH	automatically displayed including both the horizontal and vertical scrollbars when an overflow condition is detected by the Windows IWebBrowser2 ActiveX control.
2	$SCRHORZ	displayed the same as $SCRBOTH.
3	$SCRNONE	not displayed.
4	$SCRBOTH	displayed the same as $SCRBOTH.

See Also: Object Properties, Object IO Instructions, Object Definitions