📄 tclmotifdialog.html
字号:
<html><head><!-- /vobs/wpwr/docs/tornado-api/guitcl-unix/tclMotifDialog.html - generated by refgen from tclmdlg.cc --> <title> tclMotifDialog </title></head><body bgcolor="#FFFFFF"> <hr><a name="top"></a><p align=right><a href="libIndex.html"><i>Tornado API Reference : GUI Tcl Library (UNIX)</i></a></p></blockquote><h1>tclMotifDialog</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>tclMotifDialog</strong> - Tcl dialog processing for Motif </p></blockquote><h4>TCL PROCEDURES</h4><blockquote><p><p><b><a href="./tclMotifDialog.html#dialogCreate">dialogCreate</a></b> - create a new Tcl dialog<br><b><a href="./tclMotifDialog.html#dialogPost">dialogPost</a></b> - post a dialog<br><b><a href="./tclMotifDialog.html#dialogDestroy">dialogDestroy</a></b> - destroy a dialog<br><b><a href="./tclMotifDialog.html#dialogUnpost">dialogUnpost</a></b> - remove a dialog from the display<br><b><a href="./tclMotifDialog.html#dialogSetValue">dialogSetValue</a></b> - set the value of a dialog item<br><b><a href="./tclMotifDialog.html#dialogSetValues">dialogSetValues</a></b> - set the values of all items in a dialog<br><b><a href="./tclMotifDialog.html#dialogGetValue">dialogGetValue</a></b> - query the value of a dialog item<br><b><a href="./tclMotifDialog.html#dialogGetValues">dialogGetValues</a></b> - query the values of all dialog items<br><b><a href="./tclMotifDialog.html#dialogListSelect">dialogListSelect</a></b> - select an item in a dialog's list<br><b><a href="./tclMotifDialog.html#dialogListDeselect">dialogListDeselect</a></b> - deselect an item in a dialog's list<br><b><a href="./tclMotifDialog.html#dialogTitleSet">dialogTitleSet</a></b> - set the title of a dialog window<br><p></blockquote><h4>DESCRIPTION</h4><blockquote><p>This library allows to manipulate the Motif dialog facilities from theTcl UNIX GUI<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./tclMotifDialog.html#top">tclMotifDialog</a></b><hr><a name="dialogCreate"></a><p align=right><a href="rtnIndex.html"><i>GUI Tcl Library (UNIX) : Tcl Procedures</i></a></p></blockquote><h1>dialogCreate</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>dialogCreate</strong> - create a new Tcl dialog</p><p></blockquote><h4>LOCALE</h4><blockquote><p>UNIX GUI<p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>dialogCreate <i>name</i> [-size <i>w</i> <i>h</i>] {<i>itemlist</i>}</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This command creates a new dialog. A dialog is a collection of widgets,including pushbuttons, lists, and text entry fields, that may be arrangedon a panel and then posted and manipulated with related Tcl commands.The supplied <i>name</i> is used as a parameter to all related dialog commands;if a dialog is created with the same name as an existing one, the old dialog is destroyed. If <b>-size</b> is specified, the dialog has the given dimensions. <i>Itemlist</i> is a list of dialog items. Each entryin the <i>itemlist</i> is itself a list.<p></blockquote><h4>DIALOG ITEMS</h4><blockquote><p>The syntax of a dialog item in the <i>itemlist</i> is:<p><pre>dialogItem: { itemType <i>itemName</i> itemPosition... [<i>callback</i>] }itemType: text | multitext | list | label | boolean | button | hsep | vsepitemPosition: locSpec sizeSpec attachSpec...locSpec: [-x <i>x</i>] [-y <i>y</i>]sizeSpec: [-width <i>width</i>] [-height <i>height</i>]attachSpec: [sideSpec target[<i>offset</i>]]sideSpec: -left | -right | -top | -bottomtarget: . | @ | <i>itemName</i> | <i>percentage</i>offset: +<i>pixels</i></pre></blockquote><h4>ITEM TYPE</h4><blockquote><p>Most items have labels. When they do, the label text is equal to the <i>itemName</i>. A <b>text</b> item is a one-line text field. A <b>multitext</b> is a multiple line text editing area. A <b>list</b> is a list of text items,which can be selected one at a time. A <b>label</b> is simply a static stringthat can be used to label other elements of a dialog. A <b>boolean</b> is a pushbutton that can be clicked on or off, also known as a checkbox. A <b>button</b> is a simple pushbutton. An <b>hsep</b> is a horizontal separatorbar, and a <b>vsep</b> is a vertical separator bar.<p></blockquote><h4>ITEM POSITION</h4><blockquote><p>Each item can be given several layout attributes to place it in thedialog, either absolutely or in relation to other dialog items. <dl><dt>Location<dd>An item may be given an absolute position with the<b>-x</b> and <b>-y</b> specifications, where the origin is the upper left handcorner of the dialog. <p><dt>Size<dd>Each item can be given a size in pixels with the <b>-width</b> and <b>-height</b>specifications. <p><dt>Attachment<dd>Each side of the dialog can be given an attachment relative to anotherelement in the dialog with the <b>-left</b>, <b>-right</b>, <b>-top</b> and <b>-bottom</b>specifications. The attachment can be to a relative position in thedialog by specifying a number between 0 and 100, which is interpreted as apercentage. If the dialog is grown or shrunk by the user, items withthese relative attachments grow or shrink proportionately.If an item has no horizontal (<b>-left</b> or <b>-right</b>)attachment, it is attached to the left side of the form. If it has novertical attachment (<b>-top</b> or <b>-bottom</b>), it is attached to the bottom ofthe previous item, or failing that, the top of the form.<p><dt>Targets<dd> An item side may also be attached to the corresponding boundary of theform by specifying <b>.</b> as the attachment. An item may be attached to thenear side of another item, either by specifying the target item's name orusing the <b>@</b> shortcut character which represents the previous item. Anattachment made in this way must refer to a previous item in the dialogitem list. For any of these side attachments, a fixed offset in pixelsmay be added by appending a <b>+</b> and a pixel count to the attachmenttarget.<p></dl></blockquote><h4>ITEM CALLBACK</h4><blockquote><p><p>* Each item may have a callback specified, which can be any Tcl expression.For <b>text</b> items, the callback is invoked when the RETURN key is pressedin the field or when the mouse focus leaves the dialog. For <b>button</b> items, the callback is invoked when the button is pressed. For <b>list</b>items, the callback is invoked when a list item is selected. If acallback is applied to other items, it is never invoked. Callbacks areinvoked literally with no arguments.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./tclMotifDialog.html#top">tclMotifDialog</a></b>, dialogPost, dialogSetValues, dialogDestroy<hr><a name="dialogPost"></a><p align=right><a href="rtnIndex.html"><i>GUI Tcl Library (UNIX) : Tcl Procedures</i></a></p></blockquote><h1>dialogPost</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>dialogPost</strong> - post a dialog</p><p></blockquote><h4>LOCALE</h4><blockquote><p>UNIX GUI<p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>dialogPost <i>name</i> [textFocusLossFlag]</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>The named dialog is posted on the display. It is not an error to try to posta nonexistent dialog. The <b>textFocusLossFlag</b> option can be used to disableany callbacks on loss of focus in text entries (the default enables suchcallbacks).<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./tclMotifDialog.html#top">tclMotifDialog</a></b>, dialogUnpost, dialogCreate<hr><a name="dialogDestroy"></a><p align=right><a href="rtnIndex.html"><i>GUI Tcl Library (UNIX) : Tcl Procedures</i></a></p></blockquote><h1>dialogDestroy</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>dialogDestroy</strong> - destroy a dialog</p><p></blockquote><h4>LOCALE</h4><blockquote><p>UNIX GUI<p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>dialogDestroy <i>name</i></pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>The named dialog is destroyed. It is removed from the screen if itis visible. It is not an error to attempt to destroy a nonexistentdialog.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./tclMotifDialog.html#top">tclMotifDialog</a></b>, dialogCreate, dialogPost, dialogUnpost<hr><a name="dialogUnpost"></a><p align=right><a href="rtnIndex.html"><i>GUI Tcl Library (UNIX) : Tcl Procedures</i></a></p></blockquote><h1>dialogUnpost</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>dialogUnpost</strong> - remove a dialog from the display</p><p></blockquote><h4>LOCALE</h4><blockquote><p>UNIX GUI<p></blockquote><h4>SYNOPSIS</h4><blockquote><p>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -