Navigation:  Reference > Form Objects >

TDualListDialog

Print this Topic Previous pageReturn to chapter overviewNext page

 

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

 

Ctl3dNOTE:  This doesn't apply to the object on the form but the dialog that can be executed during runtime.

 

Misc

 

HelpContext

Name

Tag

 

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.

 

HelpBtnCaptionThe caption that appears on the help button when the dialog is executed.  The default value is "&Help" and can be modified during runtime.

 

Label1CaptionThe caption that appears above the string list on the left.  The default value is "&Source" and can be modified during runtime.

 

Label2CaptionThe caption that appears above the string list on the right.  The default value is "&Destination" and can be modified during runtime.

 

List1The 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.

 

List2The 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.

 

OkBtnCaptionThe caption that appears on the ok button when the dialog is executed.  The default value is "OK" and can be modified during runtime.

 

ShowHelpIf 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.

 

SortedIf this is checked (set to .True.) the string lists will be sorted alphabetically, in ascending mode.  This can be modified during runtime.

 

TitleThe 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