URL https://opencores.org/ocsvn/or1k_old/or1k_old/trunk

Subversion Repositories or1k_old

[/] [or1k_old/] [tags/] [start/] [insight/] [itcl/] [iwidgets3.0.0/] [demos/] [html/] [dialog.n.html] - Blame information for rev 578

Go to most recent revision | Details | Compare with Previous | View Log


<HTML>
<HEAD>
<TITLE>iwidgets2.2.0 User Commands - dialog</TITLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF">
<H1>iwidgets2.2.0 User Commands - dialog</H1>
<HR>
<PRE>
 
</PRE>
<H2><HR ALIGN=LEFT WIDTH=70% SIZE=3></H2><PRE>
 
 
</PRE>
<H2>NAME</H2><PRE>
     dialog - Create and manipulate a dialog widget
 
 
</PRE>
<H2>SYNOPSIS</H2><PRE>
     <STRONG>dialog</STRONG> <EM>pathName</EM> ?<EM>options</EM>?
 
 
</PRE>
<H2>INHERITANCE</H2><PRE>
     itk::Toplevel &lt;- Shell &lt;- Dialogshell &lt;- Dialog
 
 
</PRE>
<H2>STANDARD OPTIONS</H2><PRE>
     <STRONG>background</STRONG>      <STRONG>cursor</STRONG>         <STRONG>foreground</STRONG>
 
     See the "options" manual entry for details on  the  standard
     options.
 
 
</PRE>
<H2>INHERITED OPTIONS</H2><PRE>
     <STRONG>buttonBoxPadX</STRONG>   <STRONG>buttonBoxPadY</STRONG>  <STRONG>buttonBoxPos</STRONG>    <STRONG>padX</STRONG>
     <STRONG>padY</STRONG>            <STRONG>separator</STRONG>      <STRONG>thickness</STRONG>
 
     See the "dialogshell" manual entry for details on the  above
     inherited options.
 
     <STRONG>master</STRONG>          <STRONG>modality</STRONG>       <STRONG>title</STRONG>
 
     See the "shell" manual entry for details on the above inher-
     ited options.
 
</PRE>
<H2><HR ALIGN=LEFT WIDTH=70% SIZE=3></H2><PRE>
 
 
 
</PRE>
<H2>DESCRIPTION</H2><PRE>
     The <STRONG>dialog</STRONG> command creates a dialog box  providing  standard
     buttons  and  a  child site for use in derived classes.  The
     buttons include ok, apply, cancel, and  help.   Methods  and
     Options  exist to configure the buttons and their containing
     box.
 
 
 
</PRE>
<H2>METHODS</H2><PRE>
     The <STRONG>dialog</STRONG> command creates a new Tcl command whose  name  is
     <EM>pathName</EM>.  This command may be used to invoke various opera-
     tions on the widget.  It has the following general form:
 
          <EM>pathName</EM> <EM>option</EM> ?<EM>arg</EM> <EM>arg</EM> ...?
 
     <EM>Option</EM> and the <EM>arg</EM>s determine the exact behavior of the com-
     mand.   The following commands are possible for dialog widg-
     ets:
 
 
</PRE>
<H2>INHERITED METHODS</H2><PRE>
 
     <STRONG>add</STRONG>             <STRONG>buttonconfigure</STRONG>                <STRONG>defaulthide</STRONG>
     <STRONG>index</STRONG>           <STRONG>insert</STRONG>         <STRONG>invoke</STRONG>          <STRONG>show</STRONG>
 
     See the "buttonbox" manual entry for details  on  the  above
     inherited methods.
 
     <STRONG>childsite</STRONG>
 
     See the "dialogshell" manual entry for details on the  above
     inherited methods.
 
     <STRONG>activate</STRONG>        <STRONG>center</STRONG>         <STRONG>deactivate</STRONG>
 
     See the "shell" manual entry for details on the above inher-
     ited methods.
 
 
 
</PRE>
<H2>WIDGET-SPECIFIC METHODS</H2><PRE>
     <EM>pathName</EM> <STRONG>cget</STRONG> <EM>option</EM>
          Returns the current value of the  configuration  option
          given  by  <EM>option</EM>.   <EM>Option</EM>  may have any of the values
          accepted by the <STRONG>dialog</STRONG> command.
 
     <EM>pathName</EM> <STRONG>configure</STRONG> ?<EM>option</EM>? ?<EM>value</EM> <EM>option</EM> <EM>value</EM> ...?
          Query  or  modify  the  configuration  options  of  the
          widget.   If  no  <EM>option</EM>  is  specified, returns a list
          describing all of the available  options  for  <EM>pathName</EM>
          (see  <STRONG>Tk_ConfigureInfo</STRONG> for information on the format of
          this list).  If <EM>option</EM> is specified with no <EM>value</EM>, then
          the  command  returns  a  list describing the one named
          option (this list will be identical to the  correspond-
          ing  sublist  of  the  value  returned  if no <EM>option</EM> is
          specified).  If one or more  <EM>option</EM> - <EM>value</EM>  pairs  are
          specified,  then  the command modifies the given widget
          option(s) to have the given value(s);  in this case the
          command  returns  an empty string.  <EM>Option</EM> may have any
          of the values accepted by the <STRONG>dialog</STRONG> command.
 
 
 
</PRE>
<H2>EXAMPLE</H2><PRE>
           dialog .d -modality global
           .d buttonconfigure OK -command {puts OK; .d deactivate 1}
           .d buttonconfigure Apply -command {puts Apply}
           .d buttonconfigure Cancel -command {puts Cancel; .d deactivate 0}
           .d buttonconfigure Help -command {puts Help}
 
           listbox [.d childsite].lb -relief sunken
           pack [.d childsite].lb -expand yes -fill both
 
           if {[.d activate]} {
               puts "Exit via OK button"
           } else {
               puts "Exit via Cancel button"
           }
 
 
 
</PRE>
<H2>AUTHOR</H2><PRE>
     Mark L. Ulferts
 
     Bret A. Schuhmacher
 
 
</PRE>
<H2>KEYWORDS</H2><PRE>
     dialog, dialogshell, shell, widget
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
</PRE>
</BODY>
</HTML>

Line No.	Rev	Author	Line
1	578	markom	`<HTML>`
2			`<HEAD>`
3			`<TITLE>iwidgets2.2.0 User Commands - dialog</TITLE>`
4			`</HEAD>`
5			`<BODY BGCOLOR="#FFFFFF">`
6			`<H1>iwidgets2.2.0 User Commands - dialog</H1>`
7			`<HR>`
8			`<PRE>`
9
10			`</PRE>`
11			`<H2><HR ALIGN=LEFT WIDTH=70% SIZE=3></H2><PRE>`
12
13
14			`</PRE>`
15			`<H2>NAME</H2><PRE>`
16			`dialog - Create and manipulate a dialog widget`
17
18
19			`</PRE>`
20			`<H2>SYNOPSIS</H2><PRE>`
21			`<STRONG>dialog</STRONG> <EM>pathName</EM> ?<EM>options</EM>?`
22
23
24			`</PRE>`
25			`<H2>INHERITANCE</H2><PRE>`
26			`itk::Toplevel <- Shell <- Dialogshell <- Dialog`
27
28
29			`</PRE>`
30			`<H2>STANDARD OPTIONS</H2><PRE>`
31			`<STRONG>background</STRONG> <STRONG>cursor</STRONG> <STRONG>foreground</STRONG>`
32
33			`See the "options" manual entry for details on the standard`
34			`options.`
35
36
37			`</PRE>`
38			`<H2>INHERITED OPTIONS</H2><PRE>`
39			`<STRONG>buttonBoxPadX</STRONG> <STRONG>buttonBoxPadY</STRONG> <STRONG>buttonBoxPos</STRONG> <STRONG>padX</STRONG>`
40			`<STRONG>padY</STRONG> <STRONG>separator</STRONG> <STRONG>thickness</STRONG>`
41
42			`See the "dialogshell" manual entry for details on the above`
43			`inherited options.`
44
45			`<STRONG>master</STRONG> <STRONG>modality</STRONG> <STRONG>title</STRONG>`
46
47			`See the "shell" manual entry for details on the above inher-`
48			`ited options.`
49
50			`</PRE>`
51			`<H2><HR ALIGN=LEFT WIDTH=70% SIZE=3></H2><PRE>`
52
53
54
55			`</PRE>`
56			`<H2>DESCRIPTION</H2><PRE>`
57			`The <STRONG>dialog</STRONG> command creates a dialog box providing standard`
58			`buttons and a child site for use in derived classes. The`
59			`buttons include ok, apply, cancel, and help. Methods and`
60			`Options exist to configure the buttons and their containing`
61			`box.`
62
63
64
65			`</PRE>`
66			`<H2>METHODS</H2><PRE>`
67			`The <STRONG>dialog</STRONG> command creates a new Tcl command whose name is`
68			`<EM>pathName</EM>. This command may be used to invoke various opera-`
69			`tions on the widget. It has the following general form:`
70
71			`<EM>pathName</EM> <EM>option</EM> ?<EM>arg</EM> <EM>arg</EM> ...?`
72
73			`<EM>Option</EM> and the <EM>arg</EM>s determine the exact behavior of the com-`
74			`mand. The following commands are possible for dialog widg-`
75			`ets:`
76
77
78			`</PRE>`
79			`<H2>INHERITED METHODS</H2><PRE>`
80
81			`<STRONG>add</STRONG> <STRONG>buttonconfigure</STRONG> <STRONG>defaulthide</STRONG>`
82			`<STRONG>index</STRONG> <STRONG>insert</STRONG> <STRONG>invoke</STRONG> <STRONG>show</STRONG>`
83
84			`See the "buttonbox" manual entry for details on the above`
85			`inherited methods.`
86
87			`<STRONG>childsite</STRONG>`
88
89			`See the "dialogshell" manual entry for details on the above`
90			`inherited methods.`
91
92			`<STRONG>activate</STRONG> <STRONG>center</STRONG> <STRONG>deactivate</STRONG>`
93
94			`See the "shell" manual entry for details on the above inher-`
95			`ited methods.`
96
97
98
99			`</PRE>`
100			`<H2>WIDGET-SPECIFIC METHODS</H2><PRE>`
101			`<EM>pathName</EM> <STRONG>cget</STRONG> <EM>option</EM>`
102			`Returns the current value of the configuration option`
103			`given by <EM>option</EM>. <EM>Option</EM> may have any of the values`
104			`accepted by the <STRONG>dialog</STRONG> command.`
105
106			`<EM>pathName</EM> <STRONG>configure</STRONG> ?<EM>option</EM>? ?<EM>value</EM> <EM>option</EM> <EM>value</EM> ...?`
107			`Query or modify the configuration options of the`
108			`widget. If no <EM>option</EM> is specified, returns a list`
109			`describing all of the available options for <EM>pathName</EM>`
110			`(see <STRONG>Tk_ConfigureInfo</STRONG> for information on the format of`
111			`this list). If <EM>option</EM> is specified with no <EM>value</EM>, then`
112			`the command returns a list describing the one named`
113			`option (this list will be identical to the correspond-`
114			`ing sublist of the value returned if no <EM>option</EM> is`
115			`specified). If one or more <EM>option</EM> - <EM>value</EM> pairs are`
116			`specified, then the command modifies the given widget`
117			`option(s) to have the given value(s); in this case the`
118			`command returns an empty string. <EM>Option</EM> may have any`
119			`of the values accepted by the <STRONG>dialog</STRONG> command.`
120
121
122
123			`</PRE>`
124			`<H2>EXAMPLE</H2><PRE>`
125			`dialog .d -modality global`
126			`.d buttonconfigure OK -command {puts OK; .d deactivate 1}`
127			`.d buttonconfigure Apply -command {puts Apply}`
128			`.d buttonconfigure Cancel -command {puts Cancel; .d deactivate 0}`
129			`.d buttonconfigure Help -command {puts Help}`
130
131			`listbox [.d childsite].lb -relief sunken`
132			`pack [.d childsite].lb -expand yes -fill both`
133
134			`if {[.d activate]} {`
135			`puts "Exit via OK button"`
136			`} else {`
137			`puts "Exit via Cancel button"`
138			`}`
139
140
141
142			`</PRE>`
143			`<H2>AUTHOR</H2><PRE>`
144			`Mark L. Ulferts`
145
146			`Bret A. Schuhmacher`
147
148
149			`</PRE>`
150			`<H2>KEYWORDS</H2><PRE>`
151			`dialog, dialogshell, shell, widget`
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193			`</PRE>`
194			`</BODY>`
195			`</HTML>`

Browse

Tools

Subversion Repositories or1k_old

[/] [or1k_old/] [tags/] [start/] [insight/] [itcl/] [iwidgets3.0.0/] [demos/] [html/] [dialog.n.html] - Blame information for rev 578