uitcldocs.html

vxworks相关论文

creates a modeless dialog box. A modeless dialog allows access to other
windows in the application.
<p>

<dt>
<b>-name</b> <i>uniqueName</i>
<dd>

uses <i>uniqueName</i> as the name of the dialog for future reference. Most of the
UITcl API require a window name when a property of the window needs to be
changed or queried about.
<p>

<dt>
<b>-nocontexthelp</b>
<dd>

does not draw the <b>?</b> on the top right corner that can be used to get context
help.
<p>

<dt>
<b>-noframe</b>
<dd>

does not draw a frame around the dialog's disply area.
<p>

<dt>
<b>-notitle</b>
<dd>

draws a frame around the dialog's display area without the caption bar.
<p>

<dt>
<b>-parent</b> <i>tclWindow</i>
<dd>

uses specified tclWindow as the parent window of the dialog box
<p>

<dt>
<b>-sizingframe</b>
<dd>

draws a thick frame around the dialog's display area with a title on the top.
It also allows the dialog to be <b>resized.s</b>
<p>

<dt>
<b>-thinframe</b>
<dd>

draws a thin frame around the dialog's display area.
<p>

<dt>
<b>-thickframe</b>
<dd>

draws a thick frame around the dialog's display area.
<p>

<dt>
<b>-title</b> <i>captionString</i>
<dd>

specifies the title for the dialog.
<p>

<dt>
<b>-titleframe</b>
<dd>

draws a frame around the dialog's display area with a title on the top.
<p>

<dt>
<b>-x|pos</b> <i>integer</i>, <b>-y|pos</b> <i>integer</i>, <b>-w|idth</b> <i>integer</i>, and <b>-h|eight</b> <i>integer</i>
<dd>
 specify the position and size for the new dialog in dialog units.  If
omitted, they are given default values. 
</dl>

<p>

</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>ERRORS</h4><blockquote><p>
<ul>
<li>   unable to create dialog 
</ul>

<p>

<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./UITclDocs.html#top">UITcl Library</a></b>, <b><a href="./UITclDocs.html#windowTitleSet">windowTitleSet</a></b>, <b><a href="./UITclDocs.html#windowClose">windowClose</a></b>, <b><a href="./UITclDocs.html#controlCreate">controlCreate</a></b>
<p>

</blockquote><h4>EXAMPLE</h4><blockquote><p>
The Tornado target server management dialog looks something like this:
<p>
<pre>dialogCreate -name targetServerManage -title "Manage Target Servers" \
    -w 218 -height 235 -init targetServerManageInit \
    -controls { \
        {label -title "&amp;Targets:" -name lbl1 -x 9 -y 9 -w 32 -h 9} \
        {combo -name targetManage_targets -callback on_tm_targets \
            -x 40 -y 7 -w 148 -h 67} \
        {label -name lbl2 -title "Target &amp;Information" -x 9 -y 25 \
            -w 72 -h 9} \
        {text -fixed -readonly -vscroll -multiline \
            -name targetManage_tsInfo -x 9 -y 38 -w 200 -h 150} \
        {label -title "Select &amp;Action:" -name lbl1 \
            -x 30 -y 197 -w 49 -h 9} \
        {combo -name targetManage_combo_action \
            -callback on_targetManage_combo_action \
            -x 80 -y 195 -w 100 -h 67} \
        {button -default -callback on_targetManage_apply \
            -title "Apply" -name applyButton \
            -x 7 -y 215 -w 50 -h 14} \
        {button -callback on_targetManage_close -title "Close" \
            -name tm_closeButton \
            -x 64 -y 215 -w 50 -h 14} \
        {button -callback on_targetManage_help -title "&amp;Help" \
            -helpbutton -name tm_helpButtom \
            -x 160 -y 215 -w 50 -h 14} \
        {button -callback on_targetManage_refresh -title "!" \
            -name tm_bangRefresh -x 193 -y 6 -w 16 -h 14} \
    }
</pre>

<hr>
<a name="toolbarCreate"></a>
<p align=right>
<a href="rtnIndex.html"><i>GUI Tcl Library (WINDOWS) :  Tcl Procedures</i></a></p>

</blockquote><h1>toolbarCreate</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>toolbarCreate</strong> - create a toolbar on a window</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
Tcl Windows GUI
<p>
</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function creates a toolbar and associates it with
<i>parentWindowName</i>.  Dialogs cannot have toolbars associated with
them. A toolbar can be docked to any of the four sides of the parent frame.
Use controlCreate to add tool items.
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>toolbarCreate <i>parentWindowName</i> [-any] [-bottom]
              [-callback <i>callbackProcedureOrScript</i>]
              [-helpfile <i>helpFilePath</i>] [-helpID <i>uniqueIntegerID</i>] [-left]
              [-name <i>toolbarName</i>]  [-right] [-title <i>captionString</i>] [-top]
</pre>

</blockquote><h4>ARGUMENTS</h4><blockquote><p>
<dl>
<dt>
<i>parentWindowName</i>
<dd>

specifies the name of the parent window for the toolbar.
<p>

<dt>
<b>-any</b>
<dd>

attaches the toolbar to any of the sides of the window.  This flag
overrides all the above flags.
<p>

<dt>
<b>-bottom</b>
<dd>

attaches the toolbar to the bottom of the window only.
<p>

<dt>
<b>-callback</b> <i>callbackProcedureOrScript</i>
<dd>

specifies that the Tcl script <i>callback procedure or script</i> should be called
whenever an event occurs on this toolbar such as sizing, initialization, etc.
<p>

<dt>
<b>-helpfile</b> <i>helpFilePath</i>
<dd>

provides a separate help file for the toolbar's help.  If not provided, the
application's help file is used for context-sensitive help.
<p>

<dt>
<b>-helpID</b> <i>uniqueIntegerID</i>
<dd>

provides an ID associated with the toolbar for context-sensitive help.  It
references a topic in <i>helpFilePath</i> or the application's help file if
<b>-helpfile</b> isn't specified.
<p>

<dt>
<b>-left</b>
<dd>

attaches the toolbar to the left of the window only.
<p>

<dt>
<b>-name</b> <i>toolbarName</i>
<dd>

specifies the name for the toolbar; later, you may use this name
in conjunction with a control name for accessing controls.
<p>

<dt>
<b>-right</b>
<dd>

attaches the toolbar to the right of the window only.
<p>

<dt>
<b>-top</b>
<dd>
 attaches the toolbar to the top of the window only. 
</dl>

<p>

</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>ERRORS</h4><blockquote><p>
<ul>
<li>   missing required window name</li>
<li>    unable to locate window name <i>window</i> 
</ul>

<p>

<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./UITclDocs.html#top">UITcl Library</a></b>, <b><a href="./UITclDocs.html#controlDestroy">controlDestroy</a></b>, <b><a href="./UITclDocs.html#controlCreate">controlCreate</a></b>, <b><a href="./UITclDocs.html#windowCreate">windowCreate</a></b>
<p>

</blockquote><h4>EXAMPLE</h4><blockquote><p>
<pre>   toolbarCreate Browser -name browserTB

   controlCreate browserTB \
       "combo -callback selectNewBrowserPage -name cmb1 \
       -tooltip {Browser Action List} \
       -x 5 -y 100 -w 72 -h 50"
</pre>

<hr>
<a name="windowCreate"></a>
<p align=right>
<a href="rtnIndex.html"><i>GUI Tcl Library (WINDOWS) :  Tcl Procedures</i></a></p>

</blockquote><h1>windowCreate</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>windowCreate</strong> - creates a child window</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
Tcl Windows GUI
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>windowCreate  [-callback <i>callbackProcedureOrScript</i>]
              [-c|ontrols <i>listOfControls</i>] [-exec <i>execProc</i>]
              [-exit <i>exitCallback</i>] [-height <i>height</i>]
              [-helpfile <i>helpFilePath</i>] [-helpID <i>F1HelpID</i>]
              [-icon <i>iconFileName</i>] [-init <i>initCallback</i>]
              [-name <i>windowName</i>] [-nonewinterpreter]
              [-title <i>windowTitleCaption</i>] [-width <i>width</i>]
              [-xpos <i>xposition</i>] [-ypos <i>yposition</i>]
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function creates a child window that either stays in the client area
of the mainframe window or outside depending the flag <b>-msdi</b>.
<p>
</blockquote><h4>ARGUMENTS</h4><blockquote><p>
<p>
<dl>
<dt>
<b>-callback</b> <i>callbackProcedureOrScript</i>
<dd>

specifies that the Tcl script <i>callback procedure or script</i> should be called
whenever an event occurs on this window such as sizing, initialization, etc.
If this flag is used, -init and -exit are ignored.
<p>

<dt>
<b>-c|ontrols</b> <i>controlsDefinition</i>
<dd>

specifies a list of controls that is instantiated before the dialog is shown.
<p>

<dt>
<b>-exec</b>
<dd>

calls the script <i>execProc</i> after the new interpreter is established.
For example, the following parameter can be used to source a Tcl file
after the window is created:
<pre>-exec {source <i>tclSourceFileName</i>}
</pre>

<p>
<dt>
<b>-exit</b> <i>exitProcedureOrScript</i>
<dd>

specifies that the Tcl script <i>exitProcedureOrScript</i> should be called when
the dialog is exiting, after it is erased from the screen.  Use it to free any
resources.
<p>

<dt>
<b>-helpfile</b> <i>helpFilePath</i>
<dd>

provides a separate help file for the window's help.  If not provided, the
application's help file is used for context-sensitive help.
<p>

<dt>
<b>-helpID</b> <i>uniqueIntegerID</i>
<dd>

provides an ID associated with the dialog for context-sensitive help.  It
references a topic in <i>helpFilePath</i> or the application's help file if
<b>-helpfile</b> isn't specified.
<p>

<dt>
<b>-icon</b> <i>iconFilePath</i>
<dd>

icon used to display when this main window is minimized.
<p>

<dt>
<b>-init</b> <i>initProcedureOrScript</i>
<dd>

specifies that the Tcl script <i>initProcedureOrScript</i> is called when the
dialog is initialized, after the controls are instantiated but before the
window is drawn for the user.  For information on the specification of
controls, see <b><a href="./UITclDocs.html#controlCreate">controlCreate</a></b> and
<i>Introduction</i>: DIALOGS, WINDOWS AND CONTROLS.
<p>

<dt>
<b>-name</b> <i>uniqueName</i>
<dd>

uses <i>uniqueName</i> as the name of the dialog for future reference. Most of the
UITcl API require a window name when a property of the window needs to be
changed or queried about.
<p>

<dt>
<b>-nonewinterpreter</b>
<dd>

unless this option is provided, a newinterpreter is created to process
commands for this window. Any commands that needs to be created for this
window can be created in the exec using the <b>-exec</b> option. Procedures created
in the scope of other interpreters will not be valid.
<p>

<dt>
<b>-title</b> <i>captionString</i>
<dd>

specifies the title for the dialog.
<p>

<dt>
<b>-x|pos</b> <i>integer</i>, <b>-y|pos</b> <i>integer</i>, <b>-w|idth</b> <i>integer</i>, and <b>-h|eight</b> <i>integer</i>
<dd>
 specify the position and size for the new dialog in dialog units.  If
omitted, they are given default values. 
</dl>

<p>

</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>ERRORS</h4><blockquote><p>
<ul>
<li>   unable to create Tcl window </li>
<li>    unrecognized option ...