DlgEditField.SetProperties

 OverviewExamples

DlgEditField.SetProperties ( 

number ControlID,

table  Properties )

Example 1

DlgEditField.SetProperties(nControlID, tProperties);

Sets the properties of the edit field control referenced in the variable "nControlID" to the contents of the table "tProperties".

Example 2

-- Specify which edit field control will be used for name
nNameEditField = CTRL_EDIT_01;

-- disable the edit field control
DlgEditField.SetProperties(nNameEditField, {Enabled = false});

-- prompt the user for first and last name
sName = Dialog.Input("User Input Required", "Please enter your first and last names:", "", MB_ICONQUESTION);

-- if the user presses cancel, set name to unknown
if sName == "Cancel" then
    sName = "Unknown";
end

-- insert name string into edit field control
DlgEditField.SetProperties(nNameEditField, {Text = sName});

Disables the edit field control contained in the variable "nNameEditField", preventing the user from changing the field text.  An input dialog is displayed requesting the user's first and last name.  The results from this dialog are stored in the '01' edit field control.

See also:  Related Actions