Properties of the TREE COLUMN Object

BACKGROUND_COLOR

RGB color used to draw the object's background.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write,
Execution mode	Read / Write.
Associated constants
_TCO_COL_SYSTEM	"system" color,
_TCO_COL_BLACK	"black" color,
_TCO_COL_BLUE	"blue" color,
_TCO_COL_CYAN	"cyan" color,
_TCO_COL_GREEN	"green" color,
_TCO_COL_MAGENTA	"magenta" color,
_TCO_COL_RED	"red" color,
_TCO_COL_WHITE	"white" color,
_TCO_COL_YELLOW	"yellow" color,
_TCO_COL_DARKBLUE	"dark blue" color,
_TCO_COL_DARKCYAN	"dark cyan" color,
_TCO_COL_DARKGREEN	"dark green" color,
_TCO_COL_PURPLE	"purple" color,
_TCO_COL_DARKRED	"dark red" color,
_TCO_COL_DARKYELLOW	"dark yellow" color,
_TCO_COL_GREY	"grey" color,
_TCO_COL_DARKGREY	"dark grey" color.
Conditions for use	None (property applicable to a specific element in the object).
Default value	_TCO_COL_SYSTEM

DRAG_DROP

Enables or disables the triggering of events that start drag and drop operations from the element on which the user has clicked.

The old version of drag and drop used the mouse to move an element from a starting position to an end position within the object's tree structure.

With the new version, data can be transferred to any other object that also supports drag and drop, including objects in a different application.

If the DRAG_DROP property of the element on which the user clicks is set to *TRUE, the object receives a DD_BeginDrag or BeginDragDrop event, depending on the drag and drop version used.

With the old version, the drag and drop operation is divided into With the old version, the drag and drop operation is divided into three steps::

Start the drag and drop procedure by clicking on the chosen element and keeping the left mouse button depressed. The mouse cursor's appearance will change. The object receives the BeginDragDrop event.
Move the chosen element (while still holding down the left mouse button). When the mouse cursor is moved over an element in the tree structure, either:
- the mouse cursor's appearance does not change, informing the user that the selected element can be released in that position,
- the mouse cursor appears as follows: ("no parking" sign). The user will not be able to release the selected element in that position.

end the drag and drop procedure by releasing the left mouse button while the cursor is over a permitted element.

We recommend using the new version.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write,
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None (property applicable to a specific element in the object).
Default value	*FALSE

DRAG_DROP_ACTION

Lets you specify whether, during a drag and drop operation, the user is authorized to drop the selected element onto the element currently under the mouse pointer.

Note: The DRAG_DROP_ACTION property only relates to the old version of Drag and drop. We recommend using the new version of the Drag and drop feature.

Adelia type	BOOL.
Accessibility
Layout design mode	None,
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	This property is only taken into account when the MoveDragDrop event is called.
Default value	*TRUE

EDIT_CODE

Specifies the format used to display the object's value.

Adelia type	NUM_BIN_2
Accessibility
Layout design mode	Read/Write
Execution mode	Read
Associated constants
_TCO_EDIT_CODE_NONE	No edit code.
_TCO_EDIT_CODE_BLV	No text displayed for the *LOVAL value
_TCO_EDIT_CODE_A	A (x.xxx,xxCR)
_TCO_EDIT_CODE_B	B (x.xxx,xxCR)
_TCO_EDIT_CODE_C	C (xxxx,xxCR)
_TCO_EDIT_CODE_D	D (xxxx,xxCR)
_TCO_EDIT_CODE_J	J (x.xxx,xx-)
_TCO_EDIT_CODE_K	K (x.xxx,xx-)
_TCO_EDIT_CODE_L	L (xxxx,xx-)
_TCO_EDIT_CODE_M	M (xxxx,xx-)
_TCO_EDIT_CODE_N	N (-x.xxx,xx)
_TCO_EDIT_CODE_O	O (-x.xxx,xx)
_TCO_EDIT_CODE_P	P (-xxxx,xx)
_TCO_EDIT_CODE_Q	Q (-xxxx,xx)
_TCO_EDIT_CODE_Y	Y (xx/xx/xx)
_TCO_EDIT_CODE_Z	Z (xxxxxx)
_TCO_EDIT_CODE_1	1 (x.xxx,xx)
_TCO_EDIT_CODE_2	2 (x.xxx,xx)
_TCO_EDIT_CODE_3	3 (xxxx,xx)
_TCO_EDIT_CODE_4	4 (xxxx,xx)
_TCO_EDIT_CODE_SEC	Timestamp: Hides microseconds
_TCO_EDIT_CODE_SEC_BLV	Timestamp: Hides microseconds, no text displayed for the *LOVAL value.
Conditions for use	None (property applicable to all elements in the object).
Default value	_TCO_EDIT_CODE_NONE

Click here for more details on edit codes.

EDIT_WORD

Specifies the format used to display the object's value.

Adelia type	ALPHA(60)
Accessibility
Layout design mode	Read / Write
Execution mode	Read
Associated constants	None
Conditions for use	None (property applicable to all elements in the object).
Default value	" "

Click here for more details on edit words.

EXPAND

Expands or collapses the object's component elements.

Adelia type	BOOL
Accessibility
Layout design mode	Read / Write
Execution mode	Read / Write
Associated constants	None
Conditions for use	None (property applicable to a specific element in the object).
Default value	*TRUE

INPUT_CONTROL

Defines the filter applied when entering characters.

Adelia type	NUM_BIN_2
Accessibility
Layout design mode	Read/Write
Execution mode	Read
Associated constants
_TCO_CTRL_INPUT_NONE	no input control,
_TCO_CTRL_INPUT_DATE	date characters only; the separators are mandatory,
_TCO_CTRL_INPUT_EXTENDED_DATE	date characters only; the separators are optional,
_TCO_CTRL_INPUT_TIME	time characters only; the separators are mandatory,
_TCO_CTRL_INPUT_EXTENDED_TIME	time characters only; the separators are optional,
_TCO_INPUT_CTRL_UPPERCASE	all characters (upper case characters of the alphabet) plus numbers,
_TCO_INPUT_CTRL_LOWERCASE	all characters (lower case characters of the alphabet) plus numbers,
_TCO_INPUT_CTRL_NUMBER	signed decimal numbers,
_TCO_INPUT_CTRL_EXTENDED_NUMBER	signed extended numbers,
_TCO_INPUT_CTRL_UPPERCASE_CHAR	uppercase characters of the alphabet,
_TCO_INPUT_CTRL_UPPERCASE_CHAR_NUMBER	uppercase characters of the alphabet plus numbers,
_TCO_INPUT_CTRL_IBM_FIELD	letters forming a valid IBM field name.
Conditions for use	None (property applicable to all elements in the object).
Default value	_TCO_CTRL_INPUT_NONE

NAME

Static name of the object.

Adelia type	ALPHA(128)
Accessibility
Layout design mode	Read/Write
Execution mode	Read
Associated constants	None
Conditions for use	None
Default value	Prefix of the basic object.

READ_ONLY

Prevents text being entered into the object.

Adelia type	NUM_BIN_4
Accessibility
Layout design mode	Read/Write
Execution mode	Read/Write
Associated constants	None
Conditions for use	None (property applicable to a specific element in the object).
Default value	*TRUE

REVERSE_IMAGE

Allows text to be displayed in inverse video, by swapping the text and background colors.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write,
Execution mode	Read / Write.
Associated constants	None
Conditions for use	None (property applicable to a specific element in the object).
Default value	*FALSE

SEPARATOR

Character string used to separate the values of two merged TREE COLUMN objects.

Adelia type	ALPHA(250).
Accessibility
Layout design mode	Read / Write,
Execution mode	Read.
Associated constants	None.
Conditions for use	None.
Default value	#

TEXT_COLOR

RGB color used to draw the object's text.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write,
Execution mode	Read / Write.
Associated constants
_TCO_COL_SYSTEM	"system" color,
_TCO_COL_BLACK	"black" color,
_TCO_COL_BLUE	"blue" color,
_TCO_COL_CYAN	"cyan" color,
_TCO_COL_GREEN	"green" color,
_TCO_COL_MAGENTA	"magenta" color,
_TCO_COL_RED	"red" color,
_TCO_COL_WHITE	"white" color,
_TCO_COL_YELLOW	"yellow" color,
_TCO_COL_DARKBLUE	"dark blue" color,
_TCO_COL_DARKCYAN	"dark cyan" color,
_TCO_COL_DARKGREEN	"dark green" color,
_TCO_COL_PURPLE	"purple" color,
_TCO_COL_DARKRED	"dark red" color,
_TCO_COL_DARKYELLOW	"dark yellow" color,
_TCO_COL_GREY	"grey" color,
_TCO_COL_DARKGREY	"dark grey" color.
Conditions for use	None (property applicable to a specific element in the object).
Default value	_TCO_COL_SYSTEM

TRIM

Specifies the last visible element for a given line. This element is the first of the object (according to the specified sequence) that has the TRIM property set to *TRUE.

Adelia type	BOOL.
Accessibility
Layout design mode	None,
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None (property applicable to a specific element in the object).
Default value	*FALSE

VALUE

Value associated with the current element in the object.

Adelia type	Defined when designing layout.
Accessibility
Layout design mode	None,
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None.
Default value	Default value corresponding to the Adelia type.

VISIBILITY

Visibility of the object. Only visible objects can be placed in focus.

Adelia type	BOOL
Accessibility
Layout design mode	Read/Write
Execution mode	Read/Write
Associated constants	None
Conditions for use	None
Default value	*TRUE