📄 mainframe.html
字号:
<HTML><HEAD><TITLE>MainFrame</TITLE></HEAD><BODY BGCOLOR=white><DL><DT><I><A HREF="#descr">NAME</A></I></DT><DD><B>MainFrame</B> - Manage toplevel with menu, toolbar and statusbar </DD></DL><DL><DT><I>CREATION</I></DT><DD><A HREF="#descr"><B>MainFrame</B></A> <I>pathName</I> ?<I>option value...</I>?</DD></DL><DL><DT><I><A HREF="ProgressBar.html">OPTIONS from <B>ProgressBar</B></A></I></DT><DD><TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0><TR><TD> -background or -bg</TD><TD> -progressfg (see <B>-foreground</B>)</TD></TR><TR><TD> -progressmax (see <B>-maximum</B>)</TD><TD> -progresstype (see <B>-type</B>)</TD></TR><TR><TD> -progressvar (see <B>-variable</B>)</TD></TABLE></DD></DL><DL><DT><I><A HREF="#wso">WIDGET-SPECIFIC OPTIONS</A></I></DT><DD><TABLE CELLSPACING=0 CELLSPACING=0 BORDER=0><TR><TD> <A HREF="#-height">-height</A></TR><TD> <A HREF="#-menu">-menu</A></TR></TR><TR><TD> <A HREF="#-separator">-separator</A></TR><TD> <A HREF="#-textvariable">-textvariable</A></TR></TR><TR><TD> <A HREF="#-width">-width</A></TR></TABLE></DD></DL><DL><DT><I><A HREF="#wc">WIDGET COMMAND</A></I></DT><DD><I>pathName</I> <A HREF="#addindicator"><B>addindicator</B></A> ?<I>arg...</I>?</DD><DD><I>pathName</I> <A HREF="#addtoolbar"><B>addtoolbar</B></A></DD><DD><I>pathName</I> <A HREF="#cget"><B>cget</B></A> <I>option</I></DD><DD><I>pathName</I> <A HREF="#configure"><B>configure</B></A> ?<I>option</I>? ?<I>value</I> <I>option</I> <I>value</I> ...?</DD><DD><I>pathName</I> <A HREF="#getframe"><B>getframe</B></A></DD><DD><I>pathName</I> <A HREF="#getindicator"><B>getindicator</B></A> <I>index</I></DD><DD><I>pathName</I> <A HREF="#getmenu"><B>getmenu</B></A> <I>menuid</I></DD><DD><I>pathName</I> <A HREF="#gettoolbar"><B>gettoolbar</B></A> <I>index</I></DD><DD><I>pathName</I> <A HREF="#setmenustate"><B>setmenustate</B></A> <I>tag</I> <I>state</I></DD><DD><I>pathName</I> <A HREF="#showstatusbar"><B>showstatusbar</B></A> <I>name</I></DD><DD><I>pathName</I> <A HREF="#showtoolbar"><B>showtoolbar</B></A> <I>index</I> <I>bool</I></DD></DL><BR><HR WIDTH="100%"><BR><B><A NAME="descr"></A>DESCRIPTION</B><BR><P>MainFrame manage toplevel to have:<BR><UL><LI>simple menu creation, with automatic accelerator bindings and<A HREF="DynamicHelp.html">DynamicHelp</A> association,<LI>one or more toolbar that user can hide,<LI>a status bar, displaying a user message or a menu description, and optionnaly a <A HREF="ProgressBar.html">ProgressBar</A>.</UL></P><BR><HR WIDTH="50%"><BR><B><A NAME="wso">WIDGET-SPECIFIC OPTIONS</A></B><BR><DL><DT><A NAME="-height"><B>-height</B></A></DT><DD>Specifies the desired height for the user frame in any of the forms acceptable toTk_GetPixels. If this option is less than or equal to zero (the default) then the windowwill not request any size at all.</DD></DL><DL><DT><A NAME="-menu"><B>-menu (read-only)</B></A></DT><DD>This option describes the menu. This is a list whose each five elements describeone cascad menu. It has the following form:{<I>menuname</I> <I>tags</I> <I>menuId</I> <I>tearoff</I> <I>menuentries</I>...}where <I>menuentries</I> is a list where each element describe one menu entry, which can be:<UL><LI>for a separator:<BR> {<B>separator</B>}<LI>for a command:<BR> {<B>command</B> <I>menuname</I> ?<I>tags</I>? ?<I>description</I>? ?<I>accelerator</I>? ?<I>option</I> <I>value</I>? ...}<LI>for a check button:<BR> {<B>checkbutton</B> <I>menuname</I> ?<I>tags</I>? ?<I>description</I>? ?<I>accelerator</I>? ?<I>option</I> <I>value</I>? ...}<LI>for a radio button:<BR> {<B>radiobutton</B> <I>menuname</I> ?<I>tags</I>? ?<I>description</I>? ?<I>accelerator</I> ?<I>option</I> <I>value</I>? ...}<LI>for a cascad menu:<BR> {<B>cascad</B> <I>menuname</I> <I>tags</I> <I>menuId</I> <I>tearoff</I> <I>menuentries</I>}</UL>where:<UL><LI><I>menuname</I> is the name of the menu. If it contains a &, the following characteris automatically converted to the corresponding <B>-underline</B> option of <B>menu add</B>command.<LI><I>tags</I> is the tags list for the entry, used for enabling or disabling menuentries with <B>MainFrame::setmenustate</B>.<LI><I>menuId</I> is an id for the menu, from which you can get menu pathname with <B>MainFrame::getmenu</B>.<LI><I>tearoff</I> specifies if menu has tearoff entry.<LI><I>description</I> specifies a string for <A HREF=\"DynamicHelp.html\">DynamicHelp</A>.<LI><I>accelerator</I> specifies a key sequence. It is a list of two elements, where the firstis one of <B>Ctrl</B>, <B>Alt</B> or <B>CtrlAlt</B>, and the second as letter or a digit.An accelerator string is build and corresponding binding set on the toplevel to invoke themenu entry.<LI><I>option value</I> specifies additionnal options for the entry (see <B>menu add</B>command).</UL>Each value enclosed by ? are optional and defaulted to empty string, but must beprovided if one or more following options is not empty.<BR>Example:<PRE>set descmenu { "&File" {} {} 0 { {command "&New" {} "Create a new document" {Ctrl n} -command Menu::new} {command "&Open..." {} "Open an existing document" {Ctrl o} -command Menu::open} {command "&Save" open "Save the document" {Ctrl s} -command Menu::save} {cascad "&Export" {} export 0 { {command "Format &1" open "Export document to format 1" {} -command {Menu::export 1}} {command "Format &2" open "Export document to format 2" {} -command {Menu::export 2}} }} {separator} {cascad "&Recent files" {} recent 0 {}} {separator} {command "E&xit" {} "Exit the application" {} -command Menu::exit} } "&Options" {} {} 0 { {checkbutton "Toolbar" {} "Show/hide toolbar" {} -variable Menu::_drawtoolbar -command {$Menu::_mainframe showtoolbar toolbar $Menu::_drawtoolbar} } }}</PRE></DD></DL><DL><DT><A NAME="-separator"><B>-separator (read-only)</B></A></DT><DD>Specifies if separator should be drawn at the top and/or at the bottom of the user window.Must be one of the values <B>none</B>, <B>top</B>, <B>bottom</B> or <B>both</B>.It depends on the relief of subwidgets of user window.</DD></DL><DL><DT><A NAME="-textvariable"><B>-textvariable</B></A></DT><DD>Specifies the textvariable option for the label of the status bar.<A HREF="DynamicHelp.html">DynamicHelp</A> descriptionof menu entries are mapped to this variable at the creation of the MainFrame.If this variable is changed by MainFrame::configure, menu description willnot be available.<BR>You change the text of the label by modifying the value of the variable.</DD></DL><DL><DT><A NAME="-width"><B>-width</B></A></DT><DD>Specifies the desired width for the user frame in any of the forms acceptable toTk_GetPixels. If this option is less than or equal to zero (the default) then the windowwill not request any size at all.</DD></DL><HR WIDTH="50%"><BR><B><A NAME="wc">WIDGET COMMAND</A></B><BR><DL><DT><A NAME="addindicator"><I>pathName</I> <B>addindicator</B></A> ?<I>arg...</I>?</DT><DD>Add an indicator box at the right of the status bar. Each indicator are added from leftto right. An indicator is a Tk label widget configured with option-value pairgiven by ?<I>arg...</I>?. <B>-relief</B> and <B>-borderwidth</B> options are respetivelydefaulted to <I>sunken</I> and 1. Returns the pathname of the created label.</DD></DL><DL><DT><A NAME="addtoolbar"><I>pathName</I> <B>addtoolbar</B></A></DT><DD>Add a toolbar to the MainFrame. Returns the pathname of the new window where to placetoolbar items.</DD></DL><DL><DT><A NAME="cget"><I>pathName</I> <B>cget</B></A> <I>option</I></DT><DD>Returns the current value of the configuration option given by <I>option</I>.<I>Option</I> may have any of the values accepted by the creation command.</DD></DL><DL><DT><A NAME="configure"><I>pathName</I> <B>configure</B></A> ?<I>option</I>? ?<I>value</I> <I>option</I> <I>value</I> ...?</DT><DD>Query or modify the configuration options of the widget. If no <I>option</I> is specified,returns a list describing all of the available options for <I>pathName</I>.If <I>option</I> is specified with no <I>value</I>, then the command returns a listdescribing the one named <I>option</I> (this list will be identical to the correspondingsublist of the value returned if no <I>option</I> is specified). If one ormore <I>option-value</I> pairs are specified, then the command modifies the given widgetoption(s) to have the given value(s); in this case the command returns an empty string.<I>Option</I> may have any of the values accepted by the creation command.Read-only options are not be modified.</DD></DL><DL><DT><A NAME="getframe"><I>pathName</I> <B>getframe</B></A></DT><DD>Returns the pathname of the user window.</DD></DL><DL><DT><A NAME="getindicator"><I>pathName</I> <B>getindicator</B></A> <I>index</I></DT><DD>Returns the pathname of the <I>index</I>th added indicator.</DD></DL><DL><DT><A NAME="getmenu"><I>pathName</I> <B>getmenu</B></A> <I>menuid</I></DT><DD>Returns the pathname of the menu whose id is <I>menuid</I>.</DD></DL><DL><DT><A NAME="gettoolbar"><I>pathName</I> <B>gettoolbar</B></A> <I>index</I></DT><DD>Returns the pathname of the <I>index</I>th added toolbar.</DD></DL><DL><DT><A NAME="setmenustate"><I>pathName</I> <B>setmenustate</B></A> <I>tag</I> <I>state</I></DT><DD>Set the <B>-state</B> option value of all the menu entries that have the tag <I>tag</I>to <I>state</I>.</DD></DL><DL><DT><A NAME="showstatusbar"><I>pathName</I> <B>showstatusbar</B></A> <I>name</I></DT><DD><I>name</I> is one of <B>none</B>, <B>status</B> or <B>progression</B>.Use <B>none</B> to hide the status bar, <B>status</B> to display the label only, or<B>progression</B> to display the label and the<A HREF="ProgressBar.html">ProgressBar</A>.</DD></DL><DL><DT><A NAME="showtoolbar"><I>pathName</I> <B>showtoolbar</B></A> <I>index</I> <I>bool</I></DT><DD>Hide if <I>bool</I> is 0, or show if <I>bool</I> is 1 the <I>index</I>th added toolbar.To prevent your toplevel from resizing while hiding/showing toolbar,do [wm geometry $top [wm geometry $top]] when it is managed.</DD></DL></BODY></HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -