This is a non-visual object at design time that can display a very useful dialog at runtime. To execute this dialog you will use the DUAL_LIST_EXEC() function. Refer to this for an image of what the dialog will look like to the user. You will also use the STRINGS() function to determine what options the user has chosen, and perhaps, to set the options (strings) the user has to choose from. The icon for this object is on the Additional page.
PALETTE ICON & EXAMPLE
PROPERTIES
The following are the properties that apply to this object. Some are defined in Common Properties and are linked to their appropriate page.
Appearance
Ctl3d | NOTE: This doesn't apply to the object on the form but the dialog that can be executed during runtime. |
Misc
Other
CancelBtnCaption The caption that appears on the cancel button when the dialog is executed. The default value is "Cancel" and can be modified during runtime.
HelpBtnCaption | The caption that appears on the help button when the dialog is executed. The default value is "&Help" and can be modified during runtime. |
Label1Caption | The caption that appears above the string list on the left. The default value is "&Source" and can be modified during runtime. |
Label2Caption | The caption that appears above the string list on the right. The default value is "&Destination" and can be modified during runtime. |
List1 | The string list that appears on the left, the source list. You can create/edit this list during design by clicking on the button in the property field. This will bring up the standard Strings Property Editor. You can also edit this field during runtime through the use of the STRINGS() function. |
List2 | The string list that appears on the right, the destination list. You can create/edit this list during design by clicking on the button in the property field. This will bring up the standard Strings Property Editor. You can also edit this field during runtime through the use of the STRINGS() function. |
OkBtnCaption | The caption that appears on the ok button when the dialog is executed. The default value is "OK" and can be modified during runtime. |
ShowHelp | If this is checked (set to .True.) the Help button will be displayed on the dialog box. If not, you will only have Ok and Cancel. This can be modified during runtime. |
Sorted | If this is checked (set to .True.) the string lists will be sorted alphabetically, in ascending mode. This can be modified during runtime. |
Title | The caption that appears at the top of the dialog box. The default is blank. This can be modified during runtime. |
COMMENTS
See Object General Info for more about the use of the ampersand (&) as part of a button caption.
EVENTS
There are no events for non-visible objects.
Page url: http://www.cassoftware.com/tas/manual/tduallistbox.htm