TREE VIEW
Refer to TREE-VIEW for details about properties, styles and events of this control.
Properties
(name)
Specifies the control name. This property is set automatically when the control is drawn
action
Specifies the value for the Action property
additional properties
Allows the user to specify additional properties and styles. The text you write here is generated as is and may generate compile errors if not correct.
background-bitmap
Opens a dialog box that allows the user to select an image file to load into the control.
background-bitmap-scale
Allows the user to choose if the background-bitmap must be scaled to fit the control area. The Background-Bitmap-Scale property is generated according to this choice.
background-color
Opens a dialog that allows the user to choose the control background color.
bitmap
Opens a dialog box that allows the user to select an image file to load into the control. It’s also possible to generate an image from a series of characters represented with a given font
bitmap-width
Specifies the value for the Bitmap-Width property
border
Allows the user to choose one of the following styles:
3-D
BOXED
NO-BOX
border color
Opens a dialog that allows the user to choose the control border color.
border width
Opens a dialog that allows the user to choose the control border width.
buttons
TRUE...The Buttons style is generated
FALSE...The Buttons style is not generated
color
Opens a dialog that allows the user to choose the control color.
column
Specifies the X coordinate of the control as expressed in cells. This property is set automatically when the control is drawn.
column pixels
Specifies the X coordinate of the control as expressed in pixels. This property is set automatically when the control is drawn.
css-base-style-name
css-style-name
Specify the CSS style associated with the control. It works only in a WebDirect environment.
custom-data
Specifies the value for the Custom-Data property.
destroy type
AUTOMATIC...neither the Temporary nor Permanent styles are generated
TEMPORARY...Temporary style is generated
PERMANENT...Permanent style is generated
enabled
NONE...The Enabled property is not generated
TRUE... Enabled=1 is generated
FALSE...Enabeld=0 is generated
event list
Opens a dialog that allows you to choose which events must be added to the event list of this control.
exclude event list
NONE... The Exclude-Event-List property is not generated.
0... Exclude-Event-List=0 is generated.
1... Exclude-Event-List=1 is generated.
font
Opens a dialog that allows the user to choose the control font.
foreground-color
Opens a dialog that allows the user to choose the control foreground color.
gradient-color-1
Opens a dialog that allows the user to choose the window gradient start color.
 
gradient-color-2
Opens a dialog that allows the user to choose the window gradient end color.
 
gradient-orientation
Specifies the gradient orientation. Possible values are:
None
0: NORTH-TO-SOUTH
1: NORTHEAST-TO-SOUTHWEST
2: EAST-TO-WEST
3: SOUTHEAST-TO-NORTHWEST
4: SOUTH-TO-NORTH
5: SOUTHWEST-TO-NORTHEAST
6: WEST-TO-EAST
7: NORTHWEST-TO-SOUTHEAST
height-in-cells
TRUE...The Height-In-Cells style is generated
FALSE... The Height-In-Cells style is not generated
help-id
Specifies the control Help-id.
hint
Specifies the value for the Hint property.
id
Specifies the control id. This property is set automatically when the control is drawn.
key
Specifies the value for the Key property.
layout-data
Opens a dialog that allows the user to choose the control resize rules.
If the option "Follows Layout-Manager defaults" is checked, the Layout-Data property is not generated.
line
Specifies the Y coordinate of the control as expressed in cells. This property is set automatically when the control is drawn
line pixels
Specifies the Y coordinate of the control as expressed in pixels. This property is set automatically when the control is drawn
lines
Specifies the control height as expressed in cells. This property is set automatically when the control is drawn
lines at root
TRUE...The Lines-At-Root style is generated
FALSE...The Lines-At-Root style is not generated
lines pixels
Specifies the control height as expressed in pixels. This property is set automatically when the control is drawn
lines unit
DEFAULT... Either CELLS or nothing is generated after the Lines value depending on the window’s “cell” property setting
None... Neither CELLS nor PIXELS are generated after the Lines value
CELLS... CELLS is generated after the Lines value
PIXELS... PIXELS is generated after the Lines value
lock
TRUE...Locks the control on the Screen Designer so that you cannot move it anymore by dragging it with the mouse.
FALSE...You can move the control on the Screen Designer by dragging it with the mouse
mass-update
Specifies the value for the Mass-Update property
max-height
Specifies the control maximum height as expressed in cells
max-width
Specifies the control maximum width as expressed in cells
min-height
Specifies the control minimum height as expressed in cells
min-width
Specifies the control minimum width as expressed in cells
no-tab
TRUE...The No-Tab style is generated
FALSE...The No-Tab style is not generated
notify-mouse
TRUE...The Notify-Mouse style is generated
FALSE...The Notify-Mouse style is not generated
pop up menu
Associates a pop-up menu with the control. The menu must have been drawn on the same screen.
search panel
Never visible... Search-Panel=-1 is generated
Visible on demand... Search-Panel is not generated
Always visible... Search-Panel=1 is generated
selection background color
Opens a dialog that allows the user to choose the selection background color.
 
selection color
Opens a dialog that allows the user to choose the selection color.
 
selection foreground color
Opens a dialog that allows the user to choose the selection foreground color.
 
selection mode
SINGLE-SELECTION...Alllow to selected only one item at a time
SINGLE-INTERVAL-SELECTION...Allow to select multiple contiguous items
MULTIPLE-INTERVAL-SELECTION...Allow to select multiple items even if they’re not contiguous
show lines
TRUE...The Show-Lines style is generated
FALSE...The Show-Lines style is not generated
show selection always
TRUE...The Show-Sel-Always style is generated
FALSE...The Show-Sel-Always style is not generated
size
Specifies the control width as expressed in cells. This property is set automatically when the control is drawn
size pixels
Specifies the control width as expressed in pixels. This property is set automatically when the control is drawn
size unit
DEFAULT... Either CELLS or nothing is generated after the Size value depending on the window’s "cell" property setting
None... Neither CELLS nor PIXELS are generated after the Size value
CELLS... CELLS is generated after the Size value
PIXELS... PIXELS is generated after the Size value
tab order
Sets the ordinal position of the control in the Screen Section. This property is set automatically when the control is drawn
tree item settings
Opens a dialog that allows the user to define items
value
Specifies the value for the Value property
visible
NONE...Visible property is not generated
TRUE... Visible=1 is generated
FALSE...Visible=0 is generated
width-in-cells
TRUE...The Width-In-Cells style is generated
FALSE... The Width-In-Cells style is not generated
Events
cmd-goto event
Allows the user to create a paragraph to handle the CMD-GOTO event in the Procedure Division
cmd-help event
Allows the user to create a paragraph to handle the CMD-HELP event in the Procedure Division
msg-begin-entry event
Allows the user to create a paragraph to handle the MSG-BEGIN-ENTRY event in the Procedure Division
msg-cancel-entry event
Allows the user to create a paragraph to handle the MSG-CANCEL-ENTRY event in the Procedure Division
msg-end-menu event
Allows the user to create a paragraph to handle the MSG-END-MENU event in the Procedure Division
msg-finish-entry
Allows the user to create a paragraph to handle the MSG-FINISH-ENTRY event in the Procedure Division
msg-init-menu event
Allows the user to create a paragraph to handle the MSG-INIT-MENU event in the Procedure Division
msg-menu-input event
Allows the user to create a paragraph to handle the MSG-MENU-INPUT event in the Procedure Division
msg-mouse-enter event
Allows the user to create a paragraph to handle the MSG-MOUSE-ENTER event in the Procedure Division
msg-mouse-exit event
Allows the user to create a paragraph to handle the MSG-MOUSE-EXIT event in the Procedure Division
msg-tv-dblclick event
Allows the user to create a paragraph to handle the MSG-TV-DBLCLICK event in the Procedure Division
msg-tv-expanded event
Allows the user to create a paragraph to handle the MSG-TV-EXPANDED event in the Procedure Division
msg-tv-expanding event
Allows the user to create a paragraph to handle the MSG-TV-EXPANDING event in the Procedure Division
msg-tv-selchanged event
Allows the user to create a paragraph to handle the MSG-TV-SELCHANGE event in the Procedure Division
msg-tv-selchange-out-next
Allows the user to create a paragraph to handle the MSG-TV-SELCHANGE-OUT-NEXT event in the Procedure Division
msg-tv-selchange-out-prev
Allows the user to create a paragraph to handle the MSG-TV-SELCHANGE-OUT-PREV event in the Procedure Division
msg-tv-selchanging event
Allows the user to create a paragraph to handle the MSG-TV-SELCHANGING event in the Procedure Division
msg-validate event
Allows the user to create a paragraph to handle the MSG-VALIDATE event in the Procedure Division
other event
Allows the user to create a custom paragraph
Exceptions
cmd-goto exception
Allows the user to create a paragraph to handle the CMD-GOTO event when the Accept terminates with crt status = 96. This is an alternative to the event procedures described above
cmd-help exception
Allows the user to create a paragraph to handle the CMD-HELP event when the Accept terminates with crt status = 96. This is an alternative to the event procedures described above
other exception
Allows the user to create a custom paragraph
Procedures
After procedure
Allows the user to create a paragraph to handle the control AFTER PROCEDURE
After procedure thru
Allows the user to optionally specify a THRU paragraph for the AFTER PROCEDURE.
Before procedure
Allows the user to create a paragraph to handle the control BEFORE PROCEDURE
Before procedure thru
Allows the user to optionally specify a THRU paragraph for the BEFORE PROCEDURE.
Event procedure
Allows the user to create a paragraph to handle the control EVENT PROCEDURE
Exception procedure
Allows the user to create a paragraph to handle the control EXCETPION PROCEDURE
Variables
background-bitmap-scale variable
Numeric variable that hosts the value for the Background-Bitmap-Scale property
background-color variable
Numeric variable that hosts the value for the Background-Color property
bitmap-width variable
Numeric variable that hosts the value for the Bitmap-Width property
border color variable
Numeric variable that hosts the value for the Border-Color property
color variable
Numeric variable that hosts the color value
column variable
Numeric variable that hosts the column value
css-style-name variable
Alphanumeric variable that hosts the css style associated with the control. It works only in a WebDirect environment.
enabled variable
Numeric variable that hosts the enabled state
foreground-color variable
Numeric variable that hosts the value for the Foreground-Color property
gradient-color-1 variable
Numeric variable that hosts the value for the Gradient-Color-1 property
gradient-color-2 variable
Numeric variable that hosts the value for the Gradient-Color-2 property
gradient-orientation variable
Numeric variable that hosts the value for the Gradient-Orientation property
help-id variable
Numeric variable that hosts the help id
hint variable
Alphanumeric variable that hosts the hint value.
id variable
Numeric variable that hosts the control id
key variable
Alphanumeric variable that hosts the value for the Key property
layout-data variable
Numeric variable that hosts the control resize rules
lines variable
Numeric variable that hosts the lines value
line variable
Numeric variable that hosts the line value
mass-update
Numeric variable that hosts the value for the Mass-Update property
max-height variable
Numeric variable that hosts the maximum height
max-width variable
Numeric variable that hosts the maximum width
min-height variable
Numeric variable that hosts the minimum height
min-width variable
Numeric variable that hosts the minimum width
search-panel variable
Numeric variable that hosts the value for the Search-Panel property
selection-background-color variable
Numeric variable that hosts the value for the Selection-Background-Color property
selection-color variable
Numeric variable that hosts the value for the Color property
selection-foreground-color variable
Numeric variable that hosts the value for the Selection-Foreground-Color property
selection-mode variable
Numeric variable that hosts the value for the Selection-Mode property
size variable
Numeric variable that hosts the size value
value variable
Numeric variable that hosts the value for the Value property
visible variable
Numeric variable that hosts the visible state