Revision as of 01:39, 15 February 2014

The $did identifier allows you to get the settings and values of controls in a dialog and use them to assist in performing the functions of buttons, radio boxes, etc.

Synopsis

$did(<name>,<id>,[N])[.property]

Properties

• text - returns line or Nth line
• len - returns length of line or length of Nth line
• lines - returns number of lines
• sel - returns line number of Nth selected line
• seltext - returns selected text in an editbox, or first selected item in a listbox
• selstart - returns selected start character in the editbox
• selend - returns selected end character in editbox line
• edited - returns $true if text in editbox was changed, and is not empty.
• state - returns state of checkboxes, radio buttons, 0 = off, 1 = on, 2 = indeterminate (for 3stage checkbox)
• next - returns id of next control in order of tab keypress.
• prev - returns id of previous control in order of tab keypress.
• visible - returns $true if control is visible, otherwise $false
• enabled - returns $true if control is enabled, otherwise $false
• isid - returns $true if id exists in the dialog, otherwise $false
• csel - returns line number of Nth checked box in a listcb control, if N = 0, returns number of checkmarked lines
• cstate - returns 0 = off, 1 = on for item in a listcb control

Parameters

• <name> - name of the dialog
• <id> - id of the controls
• [N] - usually a line number, it can also be an id number with menus, use 0 if you want to access the editbox of a combo control.
• [.property] - used to check features of the dialog id, such as button state, selected line in a combo control, or number of lines in an editbox.

Example

None

Compatibility

Added: mIRC v5.5

Added On: 08/01/99

Note: Individual switches were not taken into consideration.

See also

• List of commands
• List of identifiers
• $didtok
• $dialog
• $didwm
• $didreg
• /dialog
• /did