$did » History » Revision 9
Revision 8 (Per Amundsen, 08/15/2015 06:54 PM) → Revision 9/12 (Per Amundsen, 02/01/2017 02:09 AM)
_Added in 1.9.0_
*$did*
Returns the id of the matched dialog id during a [[on DIALOG]] [[Scripting_Events|event]].
*Example*
<pre>
on *:DIALOG:*:*:{
echo -ag The matched dialog id is $did
}
</pre>
-----------------------------------------------------------------------------
*$did([name},id,[N])*
Returns settings and values from a dialog item.
_See also [[/dialog]], [[on DIALOG]], [[Dialog Items]]._
*Parameters*
[name] - If specified, name of the dialog otherwise [[$dname]] from the current [[Scripting_Events|event]] is used. (optional)
id - Id of the dialog item.
[N] - If N = 0, get number of lines, otherwise the Nth line for a item with multiple lines. (optional)
*Properties*
.text - Returns line or Nth line.
.len - Returns length of line or length of Nth line.
.lines - Returns number of lines.
.sel - If N = 0, returns number of lines otherwise the Nth selected line.
.seltext - Returns selected text in an editbox or first selected item in a listbox.
.selstart - Returns select start character in editbox line.
.selend - Returns select end character in editbox line.
.edited - Returns [[$true]] if text in editbox was changed, otherwise [[$false]].
.state - Returns 0 = off, 1 = on, and 2 = indeterminate.
.next - Returns id of next control in tab key order.
.prev - Returns id of previous control in tab key order.
.visible - Returns [[$true]] if the control is visible, otherwise [[$false]].
.enabled - Returns [[$true]] if the control is enabled, otherwise [[$false]].
.isid - Returns [[$true]] if id exists in the dialog, otherwise [[$false]].
.csel - If N is 0, returns number of checked lines, otherwise line number of the Nth checked box in a listcb control.
.cstate - Returns 0 = off, 1 = on for item in a listcb control.