From WikiChip
Difference between revisions of "mirc/identifiers/$did"
< mirc‎ | identifiers

Line 3: Line 3:
  
 
== Synopsis ==
 
== Synopsis ==
$did(<name>,<id>)
+
  $did(<name>,<id>,[N])[.property]
  $did(<name>,<id>,<N>)
 
  
 
== Properties ==
 
== Properties ==
Line 28: Line 27:
 
* '''<id>''' - id of the controls
 
* '''<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.
 
* '''[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 ==
 
== Example ==

Revision as of 06:38, 29 January 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