TriStateCheckBox API 

A TriStateCheckBox is an extension of a checkbox which can have the values true and false and also the state undecided. The UI element consists of a graphic with text. The checkmark in the box indicates that the option is selected and the value is set to true, and an asterisk indicates the status undecided, as the following graphic illustrates:

Definition

The Web Dynpro class TriStateCheckbox which implements the IWDTriStateCheckBox interface is the base class of checkboxes which can have three different statuses.

Description of UI Element Properties

·        state
Describes the status of the TriStateCheckBox. Checked is represented by the enumeration type WDTriState and can have the following values:

¡        true

¡        undecided

¡        false

·        readOnly
Specifies whether or not the user can check the checkbox.

·        state
The data type of this property corresponds to the enumeration type WDState. You can use the following values in the application:

normal	Describes the default state of the UI element.
required	Specifies whether the entered value is required. A red asterisk appears next to the text.

·        text
Specifies the text that is associated with the checkbox graphic and displayed to the right of the box.

·        textDirection
Specifies the text direction and allows you to read texts in languages which require a specific text direction. The textDirection property can be filled with the following values and is represented by the enumeration type WDTextDirection.

inherit	The text direction is inherited from the parent element. Therefore, the text direction is identical to the one of the parent element.
ltr	The text runs from left to right.
rtl	The text runs from right to left.

The default value for this property is inherit.

Overview of Inherited and Additional Properties

Name	Interface	Type	Initial Value	Bindable	Value Required
checked	IWDTriStateCheckBox	WDTriState	false	bindable_mandatory	No
enabled	IWDUIElement	boolean	true	bindable	No
readOnly	IWDTriStateCheckBox	boolean	false	bindable	No
state	IWDTriStateCheckBox	WDState	normal	bindable	No
text	IWDTriStateCheckBox	String (TranslatableText)		bindable	No
textDirection	IWDTriStateCheckBox	WDTextDirection	inherit	bindable	No
tooltip	IWDUIElement	String (TranslatableText)		bindable	No
visible	IWDUIElement	WDVisibility	visible	bindable	No

Events

·        onToggle (WDTriState newChecked, WDTriState oldChecked)
The onToggle event of the type IWDTriStateCheckBox is executed by clicking the TriStateCheckbox. The transfer parameters are the old and the new status.
See Event Parameters and Parameter Mapping.