AdiIRC

_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*

table(ktable).

|*Parameter*|*Description*|

| [name] | If specified, name of the dialog otherwise [[$dname]] from the current [[Scripting_Events<notextile>|</notextile>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*

table(ktable).

|*Property*|*Description*|

| .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 (listbox created using the _check_ parameter). |

| .type | Returns the dialog item type. *(AdiIRC only)* |