new Options()
The ScrollBar.Options type defines different options you can apply on the control.
Every option of the ScrollBar.Options type has associated a property of the control. For instance, the option:
cursors {string}, specifies the mouse cursor to be displayed when pointing over a part of the controlis associated with the property:
Cursors {string}, specifies the mouse cursor to be displayed when pointing over a part of the controlwhich means that the following statements are equivalent:
oScrollBar.Options = {cursors: "crosshair(lo,up,b),pointer(t)"}where oScrollBar is an object of ScrollBar type
oScrollBar.SetOptions({cursors: "crosshair(lo,up,b),pointer(t)"})
oScrollBar.Cursors = "crosshair(lo,up,b),pointer(t)"
oScrollBar.SetCursors("crosshair(lo,up,b),pointer(t)")
Members
(static) adjustThumbPos :boolean
The adjustThumbPos field specifies whether the thumb's position is automatically shown on the exactly scroll bar's value, while user drags the control's thumb.
Type:
- boolean
Example
false {boolean}, no adjustment for the thumb's position is performed while user drags it. Once the drag ends, the thumb is positioned at scroll's newly value.
true {boolean}, thumb's position is automatically adjusted at exactly scroll's value, while user drags it
adjustThumbPos
(static) allowKeys :boolean
The allowKeys field specifies whether the scroll-bar changes its value/position on keys.
Type:
- boolean
Example
null {null}, indicates that exontrol.Def.ScrollBar.allowKeys field defines the allowKeys property. By default, the exontrol.Def.ScrollBar.allowKeys is false, which indicates that no keys support
false {boolean}, no keys support for the scroll bar
true {boolean}, the scroll's value can be changed using keys such as: "ArrowLeft"/"ArrowUp", "ArrowRight"/"ArrowDown", "PageUp", "PageDown", "Home" and "End". The owner canvas element must include the "tabindex" attribute, else the scroll bar receives no key events at all. The tabindex global attribute indicates if its element can be focused, and if/where it participates in sequential keyboard navigation (usually with the Tab key, hence the name).
allowKeys
(static) allowScrollDirect :number
The allowScrollDirect field specifies whether the control scrolls directly to the value from the cursor, while user right-clicks the control.
The allowScrollDirect property can be any of the following values:
- 0, no button
- 1, primary button (usually left)
- 2, secondary button (usually right)
- 4, auxilary button (usually middle or mouse wheel button)
- 8, 4th button (typically the "Browser Back" button)
- 16, 5th button (typically the "Browser Forward" button)
Type:
- number
Example
null {null}, indicates that exontrol.Def.ScrollBar.allowScrollDirect field defines the allowScrollDirect property. By default, the exontrol.Def.ScrollBar.allowScrollDirect is: 2 (right mouse button)
0 {number}, disables the allowScrollDirect feature
4 {number}, indicates that the scroll jumps to value directly once the user clicks the middle-button of the mouse
allowScrollDirect
(static) buttonSize :number
The buttonSize field indicates the size of the buttons within a scroll bar.
Type:
- number
Example
null {null}, indicates that exontrol.Def.ScrollBar.buttonSize field defines the buttonSize property. By default, the exontrol.Def.ScrollBar.buttonSize is 16.
0 {number}, the scroll displays no buttons
18 {number}, defines the scroll's buttons to 18-pixels
buttonSize
(static) cursors :string
The cursors field specifies the mouse cursor to be displayed when pointing over a part of the control.
The format of cursors property is:
"cursor(part),cursor(part),..."where:
- "cursor", defines the CSS mouse cursor to display while cursor hovers the part
- "part", defines the name of the part the cursor is applied on (as defined bellow)
- "l" (exLeftBPart, <) indicates the left or top button of the scroll bar
- "l1" (exLeftB1Part) indicates the first additional button, in the left or top area
- "l2" (exLeftB2Part) indicates the second additional button, in the left or top area
- "l3" (exLeftB3Part) indicates the third additional button, in the left or top area
- "l4" (exLeftB4Part) indicates the forth additional button, in the left or top area
- "l5" (exLeftB5Part) indicates the fifth additional button, in the left or top area
- "t" (thumb), indicates the scroll's thumb
- "r" (exRightBPart, >) indicates the right or down button
- "r1" (exRightB1Part) indicates the first additional button in the right or down side
- "r2" (exRightB2Part) indicates the second additional button in the right or down side
- "r3" (exRightB3Part) indicates the third additional button in the right or down side
- "r4" (exRightB4Part) indicates the forth additional button in the right or down side
- "r5" (exRightB5Part) indicates the fifth additional button in the right or down side
- "r6" (exRightB6Part) indicates sixth additional button in the right or down side
- "lo" (exLowerBackPart), specifies the control's lower-background part (area between the left/top button and the thumb)
- "up" (exUpperBackPart), specifies the control's upper-background part (area between the thumb and the right/bottom button)
- "b" (exBackgroundPart), specifies the control's background part (union between the exLowerBackPart("lo") and the exUpperBackPart("up") parts)
Type:
- string
Example
null {null}, indicates that the exontrol.Def.ScrollBar.cursors field defines the cursors property. By default, the exontrol.Def.ScrollBar.cursors is "auto(l1,l2,l3,l4,l5,l,lo,t,up,r,r1,r2,r3,r4,r5,r6)", or the "auto" mouse cursor is displayed for any part of the control
"crosshair(lo,up,b),pointer(t)" {string}, indicates that the "crosshair" mouse cursor is shown once the cursor hovers the control "upper", "lower" or "background" part, and "pointer" mouse cursor while cursor hovers the "thumb" part
cursors
(static) disableNoScroll :ScrollBar.DisableNoScrollEnum
The disableNoScroll field specifies whether the scroll bar's parts are enabled/shown or disabled/hidden, when no scroll is possible.
The ScrollBar.DisableNoScrollEnum type supports the following values:
- exHideNoScroll (0), specifies that the scroll bar is hidden if no scroll is possible (while it is hosted by an exontrol.W)
- exDisableNoScroll (1), specifies that the scroll bar's buttons are disabled when no scroll is possible.
- exShowNoScroll (2), specifies that the scroll bar is visible even no scroll is possible
Type:
Example
null {null}, indicates that exontrol.Def.ScrollBar.disableNoScroll field defines the disableNoScroll property. By default, the exontrol.Def.ScrollBar.disableNoScroll is ScrollBar.DisableNoScrollEnum.exDisableNoScroll
2 or ScrollBar.DisableNoScrollEnum.exShowNoScroll {number}, specifies that the scroll bar is visible even no scroll is possible
disableNoScroll
(static) enableParts :string
The enableParts fields defines the enabled parts of the scroll bar, separated by comma.
The parts of the control are:
- "l" (exLeftBPart, <) indicates the left or top button of the scroll bar
- "l1" (exLeftB1Part) indicates the first additional button, in the left or top area
- "l2" (exLeftB2Part) indicates the second additional button, in the left or top area
- "l3" (exLeftB3Part) indicates the third additional button, in the left or top area
- "l4" (exLeftB4Part) indicates the forth additional button, in the left or top area
- "l5" (exLeftB5Part) indicates the fifth additional button, in the left or top area
- "t" (thumb), indicates the scroll's thumb
- "r" (exRightBPart, >) indicates the right or down button
- "r1" (exRightB1Part) indicates the first additional button in the right or down side
- "r2" (exRightB2Part) indicates the second additional button in the right or down side
- "r3" (exRightB3Part) indicates the third additional button in the right or down side
- "r4" (exRightB4Part) indicates the forth additional button in the right or down side
- "r5" (exRightB5Part) indicates the fifth additional button in the right or down side
- "r6" (exRightB6Part) indicates sixth additional button in the right or down side
- "lo" (exLowerBackPart), specifies the control's lower-background part (area between the left/top button and the thumb)
- "up" (exUpperBackPart), specifies the control's upper-background part (area between the thumb and the right/bottom button)
- "b" (exBackgroundPart), specifies the control's background part (union between the exLowerBackPart("lo") and the exUpperBackPart("up") parts)
Type:
- string
Example
null {null}, specifies that the exontrol.Def.ScrollBar.enableParts field defines the enableParts property. By default, the exontrol.Def.ScrollBar.enableParts is "l,t,r,b", which indicates that only "left-button", "thumb", "right-button" and "background" parts are enabled
"l,t,r" {string}, indicates that only "left-button", "thumb" and "right-button" parts are enabled. In other words, the "background" part is disabled which indicates the no page up or page down is available once the user clicks the upper or lower-background of the scroll
enableParts
(static) horizonalOverlayShapes :string
The horizonalOverlayShapes field defines the overlay shapes each part applies, when the scroll-bar's mode is exHorizontal. An overlay shape is displayed over the background and foreground shapes, such as "arrows" of the buttons.
The format of horizonalOverlayShapes property is:
"shape(part),shape(part),..."where:
- "shape", defines the name of the property of exontrol.Shapes.ScrollBar.overlay object to be applied on the part
- "part", defines the name of the part the shape is applied on (as defined bellow)
- "l" (exLeftBPart, <) indicates the left or top button of the scroll bar
- "l1" (exLeftB1Part) indicates the first additional button, in the left or top area
- "l2" (exLeftB2Part) indicates the second additional button, in the left or top area
- "l3" (exLeftB3Part) indicates the third additional button, in the left or top area
- "l4" (exLeftB4Part) indicates the forth additional button, in the left or top area
- "l5" (exLeftB5Part) indicates the fifth additional button, in the left or top area
- "t" (thumb), indicates the scroll's thumb
- "r" (exRightBPart, >) indicates the right or down button
- "r1" (exRightB1Part) indicates the first additional button in the right or down side
- "r2" (exRightB2Part) indicates the second additional button in the right or down side
- "r3" (exRightB3Part) indicates the third additional button in the right or down side
- "r4" (exRightB4Part) indicates the forth additional button in the right or down side
- "r5" (exRightB5Part) indicates the fifth additional button in the right or down side
- "r6" (exRightB6Part) indicates sixth additional button in the right or down side
- "lo" (exLowerBackPart), specifies the control's lower-background part (area between the left/top button and the thumb)
- "up" (exUpperBackPart), specifies the control's upper-background part (area between the thumb and the right/bottom button)
- "b" (exBackgroundPart), specifies the control's background part (union between the exLowerBackPart("lo") and the exUpperBackPart("up") parts)
Type:
- string
Example
null {null}, specifies that the exontrol.Def.ScrollBar.horizonalOverlayShapes field defines the horizonalOverlayShapes property. By default, the exontrol.Def.ScrollBar.horizonalOverlayShapes is "leftLite(l),rightLite(r)".
"left(l)" {string}, indicates that "l" (left-button) applies the overlay shape defined by exontrol.Shapes.ScrollBar.overlay.left
"left(l),right(r)" {string}, defines arrows for scroll-rectangular or scroll-circle
horizonalOverlayShapes
(static) horizonalShapes :string
The horizonalShapes field defines the shapes each part of the control applies, when the scroll-bar's mode is exHorizontal.
The format of horizonalShapes property is:
"shape(part),shape(part),..."where:
- "shape", defines the name of the property of exontrol.Shapes.ScrollBar.background/exontrol.Shapes.ScrollBar.foreground object to be applied on the part
- "part", defines the name of the part the shape is applied on (as defined bellow)
- "l" (exLeftBPart, <) indicates the left or top button of the scroll bar
- "l1" (exLeftB1Part) indicates the first additional button, in the left or top area
- "l2" (exLeftB2Part) indicates the second additional button, in the left or top area
- "l3" (exLeftB3Part) indicates the third additional button, in the left or top area
- "l4" (exLeftB4Part) indicates the forth additional button, in the left or top area
- "l5" (exLeftB5Part) indicates the fifth additional button, in the left or top area
- "t" (thumb), indicates the scroll's thumb
- "r" (exRightBPart, >) indicates the right or down button
- "r1" (exRightB1Part) indicates the first additional button in the right or down side
- "r2" (exRightB2Part) indicates the second additional button in the right or down side
- "r3" (exRightB3Part) indicates the third additional button in the right or down side
- "r4" (exRightB4Part) indicates the forth additional button in the right or down side
- "r5" (exRightB5Part) indicates the fifth additional button in the right or down side
- "r6" (exRightB6Part) indicates sixth additional button in the right or down side
- "lo" (exLowerBackPart), specifies the control's lower-background part (area between the left/top button and the thumb)
- "up" (exUpperBackPart), specifies the control's upper-background part (area between the thumb and the right/bottom button)
- "b" (exBackgroundPart), specifies the control's background part (union between the exLowerBackPart("lo") and the exUpperBackPart("up") parts)
Type:
- string
Example
null {null}, specifies that the exontrol.Def.ScrollBar.horizonalShapes field defines the horizonalShapes property. By default, the exontrol.Def.ScrollBar.horizonalShapes is "hThumbLite(t)".
"hThumbLite(t)" {string}, defines a lite-scroll, or shotly it applies the exontrol.Shapes.ScrollBar.background.hThumbLite and exontrol.Shapes.ScrollBar.foreground.hThumbLite on "thumb" part
"button(l1,l2,l3,l4,l5,l,r,r1,r2,r3,r4,r5,r6),hThumb(t),back(lo,b,up)" {string}, defines a rectangular-scroll
"buttonCircle(l1,l2,l3,l4,l5,l,r,r1,r2,r3,r4,r5,r6),hThumbCircle(t),hBackCircle(b)" {string}, defines a circular-scroll
"button(l1,l2,l3,l4,l5,l,r,r1,r2,r3,r4,r5,r6)" {string} indicates that all l1-r6 applies the exontrol.Shapes.ScrollBar.background.button and exontrol.Shapes.ScrollBar.foreground.button shapes.
horizonalShapes
(static) ignoreLargeChange :number
The ignoreLargeChange field specifies whether the large change value is ignored when getting the maximum value.
Type:
- number
Example
null {null}, indicates that exontrol.Def.ScrollBar.ignoreLargeChange field defines the ignoreLargeChange property. By default, the exontrol.Def.ScrollBar.ignoreLargeChange is false.
false {boolean}, specifies that the scroll's value goes from min to max
true {boolean}, specifies that the scroll's value goes from min to (max - page)
ignoreLargeChange
(static) largeChange :number
The largeChange field specifies the amount by which the scroll box position changes when the user clicks the scroll's background or presses the PAGE UP or PAGE DOWN keys.
Type:
- number
Example
null {null}, specifies that the exontrol.Def.ScrollBar.largeChange field defines the largeChange property. By default, the exontrol.Def.ScrollBar.largeChange is 10.
0 {number}, no change once the user clicks the scroll's background or presses the PAGE UP or PAGE DOWN keys.
10 {number}, increases or decreases the scroll's value by 10 when the user clicks the scroll's background or presses the PAGE UP or PAGE DOWN keys.
largeChange
(static) locked :boolean
The locked field indicates whether the control is locked(protected) or unlocked.
Type:
- boolean
Example
false {boolean}, unlocks the control
true {boolean}, locks the control (the user can not click or drag any part of the control)
locked
(static) max :number
The max field specifies scroll bar's maximum value.
Type:
- number
Example
100 {number}, indicates that the scroll's value is always less than 100
max
(static) min :number
The min field specifies scroll bar's minimum value.
Type:
- number
Example
0 {number}, indicates that the scroll's value is always greater than 0
min
(static) mode :ScrollBar.ModeEnum
The mode field defines the mode the scroll bar displays its parts
The ScrollBar.ModeEnum type supports the following values:
- exAuto (-1), indicates that the size of the scroll bar determines what mode is displayed as: if the scroll bar's width is greater than its height, then a horizontal scroll is displayed, else a vertical scroll bar is shown
- exVertical (0), indicates that the control displays a vertical scroll bar
- exHorizontal (1), indicates that the control displays a horizontal scroll bar
Type:
Example
-1 or ScrollBar.ModeEnum.exAuto {number}, specifies that the scroll bar shows as vertical or horizontal depending on its size
0 or ScrollBar.ModeEnum.exVertical {number}, always displays a vertical scroll bar
1 or ScrollBar.ModeEnum.exHorizontal {number}, always displays a horizontal scroll bar
mode
(static) orderParts :string
The orderParts field defines the order of the scroll bar parts, separated by comma.
The parts of the control are:
- "l" (exLeftBPart, <) indicates the left or top button of the scroll bar
- "l1" (exLeftB1Part) indicates the first additional button, in the left or top area
- "l2" (exLeftB2Part) indicates the second additional button, in the left or top area
- "l3" (exLeftB3Part) indicates the third additional button, in the left or top area
- "l4" (exLeftB4Part) indicates the forth additional button, in the left or top area
- "l5" (exLeftB5Part) indicates the fifth additional button, in the left or top area
- "t" (thumb), indicates the scroll's thumb
- "r" (exRightBPart, >) indicates the right or down button
- "r1" (exRightB1Part) indicates the first additional button in the right or down side
- "r2" (exRightB2Part) indicates the second additional button in the right or down side
- "r3" (exRightB3Part) indicates the third additional button in the right or down side
- "r4" (exRightB4Part) indicates the forth additional button in the right or down side
- "r5" (exRightB5Part) indicates the fifth additional button in the right or down side
- "r6" (exRightB6Part) indicates sixth additional button in the right or down side
- "lo" (exLowerBackPart), specifies the control's lower-background part (area between the left/top button and the thumb)
- "up" (exUpperBackPart), specifies the control's upper-background part (area between the thumb and the right/bottom button)
- "b" (exBackgroundPart), specifies the control's background part (union between the exLowerBackPart("lo") and the exUpperBackPart("up") parts)
Type:
- string
Example
null {null}, specifies that the exontrol.Def.ScrollBar.orderParts field defines the orderParts property. By default, the exontrol.Def.ScrollBar.orderParts is "l1,l2,l3,l4,l5,l,t,r,r1,r2,r3,r4,r5,r6"
"t,l,r" {string}, indicates that the left/top and right/bottom buttons are displayed right/bottom after the thumb part
orderParts
(static) smallChange :number
The smallChange field specifies the amount by which the scroll box position/value changes when the user clicks a scroll arrow or presses an arrow key.
Type:
- number
Example
null {null}, specifes that the exontrol.Def.ScrollBar.smallChange field defines the smallChange property. By default, the exontrol.Def.ScrollBar.smallChange is 1.
0 {number}, no change once the user clicks the left/top or right/bottom buttons
1 {number}, increases or decreases the scroll's value by 1 when the user clicks a scroll arrow or presses an arrow key
smallChange
(static) tfi :string|object
The tfi field applies font attributes to captions within the control. The tfi field can be defined using a string representation such as "b monospace 16" or as an object such as {bold: true, fontName: "monospace", fontSize: 16}.
The tfi field as string supports any of the following keywords (each keyword can be specified using first letters only such as "b" for "bold) separated by space characters:
- bold, displays the text in bold (equivalent of <b> tag)
- italic, displays the text in italics (equivalent of <i> tag)
- underline, underlines the text (equivalent of <u> tag)
- strikeout, specifies whether the text is strike-through (equivalent of <s> tag)
- <fontName name>, specifies the font's family (equivalent of <font name> tag)
- <fontSize size>, specifies the size of the font (equivalent of <font ;size> tag)
- <fgColor CSSColor>, specifies the text's foreground color (equivalent of <fgcolor> tag)
- <bgColor CSSColor>, specifies the text's background color (equivalent of <bgcolor> tag)
- <shaColor CSSColor;width;offset>, defines the text's shadow (equivalent of <sha color;width;offset> tag)
- <outColor CSSColor>, shows the text with outlined characters (CSScolor) (equivalent of <out color> tag)
- <graColor CSSColor;mode;blend>, defines a gradient text (equivalent of <gra color;mode;blend> tag)
Any other word within the tfi field that's not recognized as a keyword is interpreted as:
- name of the font (not a number), specifies the font's family (equivalent of <font name> tag)
- size of the font (number), specifies the size of the font (equivalent of <font ;size> tag)
The tfi field as object supports any of the following fields:
- bold {boolean}, displays the text in bold (equivalent of <b> tag)
- italic {boolean}, displays the text in italics (equivalent of <i> tag)
- underline {boolean}, underlines the text (equivalent of <u> tag)
- strikeout {boolean}, specifies whether the text is strike-through (equivalent of <s> tag)
- fontName {string}, specifies the font's family (equivalent of <font name> tag)
- fontSize {number}, specifies the size of the font (equivalent of <font ;size> tag)
- fgColor {string}, specifies the text's foreground color (CSScolor) (equivalent of <fgcolor> tag)
- bgColor {string}, specifies the text's background color (CSScolor) (equivalent of <bgcolor> tag)
- shaColor {object}, specifies an object of {color, width, offset} type that defines the text's shadow (equivalent of <sha color;width;offset> tag), where:
- color {string}, defines the color of the text's shadow (CSScolor)
- width {number}, defines the size of the text's shadow
- offset {number}, defines the offset to show the text's shadow relative to the text
- outColor {string}, shows the text with outlined characters (CSScolor) (equivalent of <out color> tag)
- graColor {object}, specifies an object of {color, mode, blend} type that defines a gradient text (equivalent of <gra color;mode;blend> tag), where:
- color {string}, defines the gradient-color (CSScolor)
- mode {number}, defines the gradient mode as a value between 0 and 4
- blend {number}, defines the gradient blend as a value between 0 and 1
CSSColor or CSS legal color values can be specified by the following methods:
- Hexadecimal colors, is specified with: #RRGGBB, where the RR (red), GG (green) and BB (blue) hexadecimal integers specify the components of the color. All values must be between 00 and FF. For example, #0000ff value is rendered as blue, because the blue component is set to its highest value (ff) and the others are set to 00.
- Hexadecimal colors with transparency, is specified with: #RRGGBBAA, where AA (alpha) value must be between 00 and FF. For example, #0000ff80 defines a semi-transparent blue.
- RGB colors, is specified with the RGB(red, green, blue) function. Each parameter (red, green, and blue) defines the intensity of the color and can be an integer between 0 and 255. For example, rgb(0,0,255) defines the blue color.
- RGBA colors, are an extension of RGB color values with an alpha channel as RGBA(red, green, blue, alpha) function, where the alpha parameter is a number between 0.0 (fully transparent) and 1.0 (fully opaque). For example, rgba(0,0,255,0.5) defines a semi-transparent blue.
- HSL colors, is specified with the HSL(hue, saturation, lightness) function, where hue is a degree on the color wheel (from 0 to 360) - 0 (or 360) is red, 120 is green, 240 is blue. saturation is a percentage value; 0% means a shade of gray and 100% is the full color. lightness is also a percentage; 0% is black, 100% is white. HSL stands for hue, saturation, and lightness - and represents a cylindrical-coordinate representation of colors. For example, hsl(240, 100%, 50%) defines the blue color.
- HSLA colors, are an extension of HSL color values with an alpha channel - which specifies the opacity of the object as HSLA(hue, saturation, lightness, alpha) function, where alpha parameter is a number between 0.0 (fully transparent) and 1.0 (fully opaque). For example, hsla(240, 100%, 50%,0.5) defines a semi-transparent blue.
- Predefined/Cross-browser color names, 140 color names are predefined in the HTML and CSS color specification. For example, blue defines the blue color.
Type:
- string | object
Example
null {null}, the tfi field is ignored
"bold monospace 16 <fg blue>" {string}, defines Monospace font of 16px height, bold and blue
{bold: true, fontName: "monospace", fontSize: 16, fgColor: "blue"} {object}, defines Monospace font of 16px height, bold and blue
tfi
(static) thumbSize :number
The thumbSize field indicates the size to display the scroll bar's thumb.
Type:
- number
Example
null {null}, indicates that exontrol.Def.ScrollBar.thumbSize field defines the thumbSize property. By default, the exontrol.Def.ScrollBar.thumbSize is -1 (thumb's size automatically is computed based on scroll's margins (min, max and page))
-1 {number}, indicates that the thumb's size automatically is computed based on scroll's margins (min, max and page)
0 {number}, the scroll displays no thumb
128 {number}, defines the scroll's thumb to 128-pixels
thumbSize
(static) value :number
The value field specifies scroll bar's value.
The range of value is:
- between min and max, if the ignoreLargeChange property is true
- between min and max - largeChange, if the ignoreLargeChange property is false
Type:
- number
Example
25 {number}, changes the scroll's value to 25. The "onchange" event occurs, once the scroll's value is changed.
value
(static) verticalOverlayShapes :string
The verticalOverlayShapes field defines the overlay shapes each part applies, when the scroll-bar's mode is exVertical. An overlay shape is displayed over the background and foreground shapes.
The format of verticalOverlayShapes property is:
"shape(part),shape(part),..."where:
- "shape", defines the name of the property of exontrol.Shapes.ScrollBar.overlay object to be applied on the part
- "part", defines the name of the part the shape is applied on (as defined bellow)
- "l" (exLeftBPart, <) indicates the left or top button of the scroll bar
- "l1" (exLeftB1Part) indicates the first additional button, in the left or top area
- "l2" (exLeftB2Part) indicates the second additional button, in the left or top area
- "l3" (exLeftB3Part) indicates the third additional button, in the left or top area
- "l4" (exLeftB4Part) indicates the forth additional button, in the left or top area
- "l5" (exLeftB5Part) indicates the fifth additional button, in the left or top area
- "t" (thumb), indicates the scroll's thumb
- "r" (exRightBPart, >) indicates the right or down button
- "r1" (exRightB1Part) indicates the first additional button in the right or down side
- "r2" (exRightB2Part) indicates the second additional button in the right or down side
- "r3" (exRightB3Part) indicates the third additional button in the right or down side
- "r4" (exRightB4Part) indicates the forth additional button in the right or down side
- "r5" (exRightB5Part) indicates the fifth additional button in the right or down side
- "r6" (exRightB6Part) indicates sixth additional button in the right or down side
- "lo" (exLowerBackPart), specifies the control's lower-background part (area between the left/top button and the thumb)
- "up" (exUpperBackPart), specifies the control's upper-background part (area between the thumb and the right/bottom button)
- "b" (exBackgroundPart), specifies the control's background part (union between the exLowerBackPart("lo") and the exUpperBackPart("up") parts)
Type:
- string
Example
null {null}, specifies that the exontrol.Def.ScrollBar.verticalOverlayShapes field defines the verticalOverlayShapes property. By default, the exontrol.Def.ScrollBar.verticalOverlayShapes is "upLite(l),downLite(r)".
"up(l)" {string}, indicates that l applies the overlay shape defined by exontrol.Shapes.ScrollBar.overlay.up
"up(l),down(r)" {string}, defines arrows for scroll-rectangular or scroll-circle
verticalOverlayShapes
(static) verticalShapes :string
The verticalShapes field defines the shapes each part of the control applies, when the scroll-bar's mode is exVertical.
The format of verticalShapes property is:
"shape(part),shape(part),..."where:
- "shape", defines the name of the property of exontrol.Shapes.ScrollBar.background/exontrol.Shapes.ScrollBar.foreground object to be applied on the part
- "part", defines the name of the part the shape is applied on (as defined bellow)
- "l" (exLeftBPart, <) indicates the left or top button of the scroll bar
- "l1" (exLeftB1Part) indicates the first additional button, in the left or top area
- "l2" (exLeftB2Part) indicates the second additional button, in the left or top area
- "l3" (exLeftB3Part) indicates the third additional button, in the left or top area
- "l4" (exLeftB4Part) indicates the forth additional button, in the left or top area
- "l5" (exLeftB5Part) indicates the fifth additional button, in the left or top area
- "t" (thumb), indicates the scroll's thumb
- "r" (exRightBPart, >) indicates the right or down button
- "r1" (exRightB1Part) indicates the first additional button in the right or down side
- "r2" (exRightB2Part) indicates the second additional button in the right or down side
- "r3" (exRightB3Part) indicates the third additional button in the right or down side
- "r4" (exRightB4Part) indicates the forth additional button in the right or down side
- "r5" (exRightB5Part) indicates the fifth additional button in the right or down side
- "r6" (exRightB6Part) indicates sixth additional button in the right or down side
- "lo" (exLowerBackPart), specifies the control's lower-background part (area between the left/top button and the thumb)
- "up" (exUpperBackPart), specifies the control's upper-background part (area between the thumb and the right/bottom button)
- "b" (exBackgroundPart), specifies the control's background part (union between the exLowerBackPart("lo") and the exUpperBackPart("up") parts)
Type:
- string
Example
null {null}, specifies that the exontrol.Def.ScrollBar.verticalShapes field defines the verticalShapes property. By default, the exontrol.Def.ScrollBar.verticalShapes is "vThumbLite(t)".
"vThumbLite(t)" {string}, defines a lite-scroll, or shotly it applies the exontrol.Shapes.ScrollBar.background.vThumbLite and exontrol.Shapes.ScrollBar.foreground.vThumbLite on "thumb" part
"button(l1,l2,l3,l4,l5,l,r,r1,r2,r3,r4,r5,r6),vThumb(t),back(lo,b,up)" {string}, defines a rectangular-scroll
"buttonCircle(l1,l2,l3,l4,l5,l,r,r1,r2,r3,r4,r5,r6),vThumbCircle(t),vBackCircle(b)" {string}, defines a circular-scroll
"button(l1,l2,l3,l4,l5,l,r,r1,r2,r3,r4,r5,r6)" {string} indicates that all l1-r6 applies the exontrol.Shapes.ScrollBar.background.button and exontrol.Shapes.ScrollBar.foreground.button shapes.
verticalShapes
(static) visibleParts :string
The visibleParts fields defines the visible parts of the scroll bar, separated by comma.
The parts of the control are:
- "l" (exLeftBPart, <) indicates the left or top button of the scroll bar
- "l1" (exLeftB1Part) indicates the first additional button, in the left or top area
- "l2" (exLeftB2Part) indicates the second additional button, in the left or top area
- "l3" (exLeftB3Part) indicates the third additional button, in the left or top area
- "l4" (exLeftB4Part) indicates the forth additional button, in the left or top area
- "l5" (exLeftB5Part) indicates the fifth additional button, in the left or top area
- "t" (thumb), indicates the scroll's thumb
- "r" (exRightBPart, >) indicates the right or down button
- "r1" (exRightB1Part) indicates the first additional button in the right or down side
- "r2" (exRightB2Part) indicates the second additional button in the right or down side
- "r3" (exRightB3Part) indicates the third additional button in the right or down side
- "r4" (exRightB4Part) indicates the forth additional button in the right or down side
- "r5" (exRightB5Part) indicates the fifth additional button in the right or down side
- "r6" (exRightB6Part) indicates sixth additional button in the right or down side
- "lo" (exLowerBackPart), specifies the control's lower-background part (area between the left/top button and the thumb)
- "up" (exUpperBackPart), specifies the control's upper-background part (area between the thumb and the right/bottom button)
- "b" (exBackgroundPart), specifies the control's background part (union between the exLowerBackPart("lo") and the exUpperBackPart("up") parts)
Type:
- string
Example
null {null}, specifies that the exontrol.Def.ScrollBar.visibleParts field defines the visibleParts property. By default, the exontrol.Def.ScrollBar.visibleParts is "l,t,r,b", which indicates that only "left-button", "thumb", "right-button" and "background" parts are visible
"t,b" {string}, indicates that only "thumb", "background" parts are visible
visibleParts
(static) wheelChange :number
The wheelChange field specifies the amount by which the scroll box position changes when the user rotates the mouse wheel.
Type:
- number
Example
null {null}, specifes that the exontrol.Def.ScrollBar.wheelChange field defines the smallChange property. By default, the exontrol.Def.ScrollBar.wheelChange is 1.
0 {number}, no change while the user rotates the mouse wheel.
1 {number}, increases or decreases the scroll's value by 1 when the user rotates the mouse wheel
wheelChange