OpenCores
URL https://opencores.org/ocsvn/or1k/or1k/trunk

Subversion Repositories or1k

[/] [or1k/] [trunk/] [insight/] [itcl/] [iwidgets3.0.0/] [demos/] [html/] [messagedialog.n.html] - Blame information for rev 1770

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

Line No. Rev Author Line
1 578 markom
<HTML>
2
<HEAD>
3
<TITLE>iwidgets2.2.0 User Commands - messagedialog</TITLE>
4
</HEAD>
5
<BODY BGCOLOR="#FFFFFF">
6
<H1>iwidgets2.2.0 User Commands - messagedialog</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
     messagedialog -  Create  and  manipulate  a  message  dialog
17
     widget
18
 
19
 
20
</PRE>
21
<H2>SYNOPSIS</H2><PRE>
22
     <STRONG>messagedialog</STRONG> <EM>pathName</EM> ?<EM>options</EM>?
23
 
24
 
25
</PRE>
26
<H2>INHERITANCE</H2><PRE>
27
     itk::Toplevel &lt;- Shell &lt;-  Dialogshell  &lt;-  Dialog  &lt;-  Mes-
28
     sagedialog
29
 
30
 
31
</PRE>
32
<H2>STANDARD OPTIONS</H2><PRE>
33
     <STRONG>anchor</STRONG>          <STRONG>background</STRONG>     <STRONG>bitmap</STRONG>          <STRONG>cursor</STRONG>
34
     <STRONG>font</STRONG>            <STRONG>foreground</STRONG>     <STRONG>image</STRONG>           <STRONG>justify</STRONG>
35
     <STRONG>text</STRONG>            <STRONG>wrapLength</STRONG>
36
 
37
     See the "options" manual entry for details on  the  standard
38
     options.
39
 
40
 
41
</PRE>
42
<H2>INHERITED OPTIONS</H2><PRE>
43
     <STRONG>buttonBoxPadX</STRONG>   <STRONG>buttonBoxPadY</STRONG>  <STRONG>buttonBoxPos</STRONG>    <STRONG>padX</STRONG>
44
     <STRONG>padY</STRONG>            <STRONG>separator</STRONG>      <STRONG>thickness</STRONG>
45
 
46
     See the "dialogshell" widget manual entry for details on the
47
     above inherited options.
48
 
49
     <STRONG>master</STRONG>          <STRONG>modality</STRONG>       <STRONG>title</STRONG>
50
 
51
     See the "shell" widget manual entry for details on the above
52
     inherited options.
53
 
54
 
55
</PRE>
56
<H2>WIDGET-SPECIFIC OPTIONS</H2><PRE>
57
     Name:           <STRONG>imagePos</STRONG>
58
     Class:          <STRONG>Position</STRONG>
59
     Command-Line Switch:           <STRONG>-imagepos</STRONG>
60
 
61
          Specifies the image position relative  to  the  message
62
          text: <STRONG>n</STRONG>, <STRONG>s</STRONG>, <STRONG>e</STRONG>, or <STRONG>w</STRONG>.  The default is w.
63
 
64
     Name:           <STRONG>textPadX</STRONG>
65
     Class:          <STRONG>Pad</STRONG>
66
     Command-Line Switch:           <STRONG>-textpadx</STRONG>
67
 
68
          Specifies a  non-negative  value  indicating  how  much
69
          extra  space  to  request for the message text in the X
70
          direction.  The value may have any of the forms accept-
71
          able to Tk_GetPixels.
72
 
73
     Name:           <STRONG>textPadY</STRONG>
74
     Class:          <STRONG>Pad</STRONG>
75
     Command-Line Switch:           <STRONG>-textpady</STRONG>
76
 
77
          Specifies a  non-negative  value  indicating  how  much
78
          extra  space  to  request for the message text in the X
79
          direction.  The value may have any of the forms accept-
80
          able to Tk_GetPixels.
81
 
82
 
83
</PRE>
84
<H2><HR ALIGN=LEFT WIDTH=70% SIZE=3></H2><PRE>
85
 
86
 
87
 
88
</PRE>
89
<H2>DESCRIPTION</H2><PRE>
90
     The <STRONG>messagedialog</STRONG> command creates a message dialog composite
91
     widget.  The  messagedialog is derived from the Dialog class
92
     and is composed of an image and associated message text with
93
     commands to manipulate the dialog buttons.
94
 
95
 
96
 
97
</PRE>
98
<H2>METHODS</H2><PRE>
99
     The <STRONG>messagedialog</STRONG> command creates a new  Tcl  command  whose
100
     name  is <EM>pathName</EM>.  This command may be used to invoke vari-
101
     ous operations on the widget.  It has the following  general
102
     form:
103
 
104
          <EM>pathName</EM> <EM>option</EM> ?<EM>arg</EM> <EM>arg</EM> ...?
105
 
106
     <EM>Option</EM> and the <EM>arg</EM>s determine the exact behavior of the com-
107
     mand.  The following commands are possible for messagedialog
108
     widgets:
109
 
110
 
111
 
112
</PRE>
113
<H2>INHERITED METHODS</H2><PRE>
114
     <STRONG>add</STRONG>             <STRONG>buttonconfigure</STRONG>                <STRONG>defaulthide</STRONG>
115
     <STRONG>insert</STRONG>          <STRONG>invoke</STRONG>         <STRONG>show</STRONG>
116
 
117
     See the "buttonbox" widget manual entry for details  on  the
118
     above inherited methods.
119
 
120
     <STRONG>childsite</STRONG>
121
 
122
     See the "dialogshell" widget manual entry for details on the
123
     above inherited methods.
124
 
125
     <STRONG>activate</STRONG>        <STRONG>center</STRONG>         <STRONG>deactivate</STRONG>
126
 
127
     See the "dialogshell" widget manual entry for details on the
128
     above inherited methods.
129
 
130
 
131
</PRE>
132
<H2>WIDGET-SPECIFIC METHODS</H2><PRE>
133
     <EM>pathName</EM> <STRONG>cget</STRONG> <EM>option</EM>
134
          Returns the current value of the  configuration  option
135
          given  by  <EM>option</EM>.   <EM>Option</EM>  may have any of the values
136
          accepted by the <STRONG>messagedialog</STRONG> command.
137
 
138
     <EM>pathName</EM> <STRONG>configure</STRONG> ?<EM>option</EM>? ?<EM>value</EM> <EM>option</EM> <EM>value</EM> ...?
139
          Query  or  modify  the  configuration  options  of  the
140
          widget.   If  no  <EM>option</EM>  is  specified, returns a list
141
          describing all of the available  options  for  <EM>pathName</EM>
142
          (see  <STRONG>Tk_ConfigureInfo</STRONG> for information on the format of
143
          this list).  If <EM>option</EM> is specified with no <EM>value</EM>, then
144
          the  command  returns  a  list describing the one named
145
          option (this list will be identical to the  correspond-
146
          ing  sublist  of  the  value  returned  if no <EM>option</EM> is
147
          specified).  If one or more  <EM>option</EM> - <EM>value</EM>  pairs  are
148
          specified,  then  the command modifies the given widget
149
          option(s) to have the given value(s);  in this case the
150
          command  returns  an empty string.  <EM>Option</EM> may have any
151
          of the values accepted by the <STRONG>messagedialog</STRONG> command.
152
 
153
 
154
 
155
</PRE>
156
<H2>COMPONENTS</H2><PRE>
157
     Name:           <STRONG>image</STRONG>
158
     Class:          <STRONG>Label</STRONG>
159
 
160
          The image component is the bitmap or image of the  mes-
161
          sage  dialog.   See the "label" widget manual entry for
162
          details on the image component item.
163
 
164
     Name:           <STRONG>msg</STRONG>
165
     Class:          <STRONG>Label</STRONG>
166
 
167
          The msg component provides the textual portion  of  the
168
          message  dialog.   See  the "label" widget manual entry
169
          for details on the msg component item.
170
 
171
 
172
 
173
</PRE>
174
<H2>EXAMPLE</H2><PRE>
175
           #
176
           # Standard question message dialog used for confirmation.
177
           #
178
           messagedialog .md -title "Message Dialog" -text "Are you sure ?" \
179
                          -bitmap questhead -modality global
180
 
181
           .md hide Help
182
           .md buttonconfigure OK -text Yes
183
           .md buttonconfigure Cancel -text No
184
 
185
           if {[.md activate]} {
186
              .md configure -text "Are you really sure ?"
187
              if {[.md activate]} {
188
                          puts stdout "Yes"
189
              } else {
190
                          puts stdout "No"
191
              }
192
           } else {
193
              puts stdout "No"
194
 
195
           }
196
 
197
           destroy .md
198
 
199
           #
200
           # Copyright notice with automatic deactivation.
201
           #
202
           messagedialog .cr -title "Copyright" -bitmap @dsc.xbm -imagepos n \
203
               -text "Copyright 1995 DSC Communications Corporation\n \
204
                              All rights reserved"
205
 
206
           .cr hide Apply
207
           .cr hide Cancel
208
           .cr hide Help
209
 
210
           .cr activate
211
           after 10000 ".cr deactivate"
212
 
213
 
214
 
215
</PRE>
216
<H2>AUTHOR</H2><PRE>
217
     Mark L. Ulferts
218
 
219
 
220
</PRE>
221
<H2>KEYWORDS</H2><PRE>
222
     messagedialog, dialog, dialogshell, shell, widget
223
 
224
 
225
 
226
 
227
 
228
 
229
 
230
 
231
 
232
 
233
 
234
 
235
 
236
 
237
 
238
 
239
 
240
 
241
 
242
 
243
 
244
 
245
 
246
 
247
 
248
 
249
 
250
 
251
</PRE>
252
</BODY>
253
</HTML>

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.