.-
help for ^diablo^					     Timothy J. Schmidt
.-

Dialog box layout manager                                     [STB35:  ip15]
-------------------------

The ^diablo^ command assumes two forms, both of which must be used in
constructing a dialog box.  To specify the window controls for each row of the
dialog box, the syntax is:

	^diablo^ rownum^,^ wincontrol [^|^ wincontrol ...]

where rownum is a positive, non-zero integer indicating the row number in the
dialog box and wincontrol is one of the following:

    wincontrol                                      window control
 -----------------------------------------------------------------------------
    bu["label", macroname [, options]]              command button
    ch["text", macroname [, options]]               check box
    ed[macroname [, options]]                       edit box
    st[text_macroname [, options]]                  static text
    ra["text", "text" [, "text" ...], macroname]    radio button
    ls[list_macroname, macroname [, options]]       single choice list box
    lm[list_macroname, macroname [, options]]       multiple choice list box
    cs[list_macroname, macroname [, options]]       single choice combo box
    cm[list_macroname, macroname [, options]]       multiple choice combo box
    i                                               invisible place holder

The window controls accept all valid Stata options listed in ^[R] window^
^control.^  Options must be specified as the final parameter in a window control
parameter list.

After defining each row of a dialog box using the above syntax, create and
display the dialog box with the following command:

	^diablo^ ^"^box_title^"^

where box_title is the text that will appear in the dialog box title bar.


Description
-----------

^diablo^ simplifies and automates several features of window control
specification and dialog box construction.  Instead of issuing a separate
Stata command for each window control in a dialog box, ^diablo^ users give one
command for each row.  In addition, diablo eliminates the need to specify
explicit coordinates for the placement of dialog box controls.

^diablo^ positions the window controls in a rectangular r x c matrix where r
is the number of rows specified by the programmer (in the prior ^diablo^
commands) and c is the maximum number of controls specified in any of those
rows.  If the user specifies fewer controls in one row than another, ^diablo^
will pad the right side of the shorter row with empty space.


Example
-------

The following example creates a dialog box with two static text controls in the
first row, a list box and a combo box control in the second row, and two
command buttons in the third row.  This example assumes all global macros have
been previously defined.

 ^diablo 1, st[Text1] | st[Text2]^
 ^diablo 2, ls[LBvars, LBpick] | cs[CBvars, CBpick]^
 ^diablo 3, bu["OK", OKchek] | bu["Cancel", DBcancel]^
 ^diablo "Test dialog box"^


Also see
--------

    STB:  ip15 (STB-35)
 Manual:  ^[R] window control^
          ^[R] window dialog^
On-line:  help for @window@