Project

General

Profile

$dialog » History » Revision 2

Revision 1 (Per Amundsen, 08/14/2015 01:54 PM) → Revision 2/12 (Per Amundsen, 08/14/2015 01:54 PM)

_Added in 1.9.0_ 

 *$dialog(name,table,[parent])* 

 Creates a modal dialog. 

 *Parameters* 

 name - Name of the dialog to create. 
 table - Name of the dialog table to use. 
 [parent] - Name of the parent window to associate the dialog with. (optional) 

 *Example* 

 <pre> 
 ; Create a dialog table. 
 dialog Example { 
  title          "Example"  
  size          -1 -1 100 50 
  option        dbu 
   button "Example 1", 1, 4 10 40 12 
 } 

 ; Create and open the dialog using 'Example' table. 
 //noop $dialog(Example, Example) 
 </pre> 

 _See also [[/dialog]]._ 

 
 ----------------------------------------------------------------------------- 

 *$dialog(name|N)* 

 Returns information about a dialog. 

 *Parameters* 

 name|N - Name of the dialog or if N = 0, number of dialogs, otherwise the Nth dialog. 

 *Properties* 

 .result - Returns ID of the 'result' button if specified. 
 .x - Returns the X position of the dialog. 
 .y - Returns the Y position of the dialog. 
 .w - Returns the width of the dialog. 
 .h - Returns the height of the dialog. 
 .cw - Returns the width of the dialog client area. 
 .ch - Returns the height of the dialog client area. 
 .title - Returns the dialog title. 
 .modal - Returns [[$true]] if the dialog is modal, otherwise [[$false]]. 
 .table - Returns the name of the dialog table. 
 .ok - Returns ID of the 'ok' button if specified. 
 .cancel - Returns ID of the 'cancel' button if specified. 
 .focus - Returns ID of the control that currently has focus. 
 .active - Returns [[$true]] if the dialog is active, otherwise [[$false]]. 
 .tab - Returns id of tab that is currently displayed. 
 .hwnd - Returns the window handle. 

 *Example* 

 <pre> 
 ; Print number of dialogs. 
 //echo -ag $dialog(0) 

 ; Print name of the first dialog. 
 //echo -ag $dialog(1) 
 </pre>