Project

General

Profile

$did » History » Revision 10

Revision 9 (Per Amundsen, 02/01/2017 02:09 AM) → Revision 10/12 (Per Amundsen, 12/10/2017 05:10 PM)

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