1iwidgets::dialogshell − Create and manipulate a dialog shell wid‐
2get iwidgets::dialogshell pathName  ?options?   itk::Toplevel  <‐
3iwidgets::Shell <‐ iwidgets::Dialogshell

background cursor foreground

5See  the  "options"  manual entry for details on the standard op‐
6tions.

height master modality width

8See the "shell" manual entry for details on the  above  inherited
9options.

title

11See the "Toplevel" manual entry for details on the above inherit‐
12ed options.
13
14Name:           buttonBoxPadX
15Class:          Pad
16Command‐Line Switch:           ‐buttonboxpadx
17Specifies a non‐negative padding distance to  leave  between  the
18button group and the outer edge of the button box in the x direc‐
19tion.  The value may be given in any of the forms  accpetable  to

Tk_GetPixels. The default is 5 pixels.

21Name:           buttonBoxPadY
22Class:          Pad
23Command‐Line Switch:           ‐buttonboxpady
24Specifies  a  non‐negative  padding distance to leave between the
25button group and the outer edge of the button box in the y direc‐
26tion.   The  value may be given in any of the forms accpetable to

Tk_GetPixels. The default is 5 pixels.

28Name:           buttonBoxPos
29Class:          Position
30Command‐Line Switch:           ‐buttonboxpos
31Attaches buttons to the given side of the dialog: n, s, e  or  w.
32The default is s.
33Name:           padX
34Class:          Pad
35Command‐Line Switch:           ‐padx
36Specifies a padding distance for the childsite in the X‐direction
37in any of the forms acceptable to Tk_GetPixels.  The  default  is
3810.
39Name:           padY
40Class:          Pad
41Command‐Line Switch:           ‐pady
42Specifies a padding distance for the childsite in the Y‐direction
43in any of the forms acceptable to Tk_GetPixels.  The  default  is
4410.
45Name:           separator
46Class:          Separator
47Command‐Line Switch:           ‐separator
48Specifies  whether  a  line is drawn to separate the buttons from
49the dialog box  contents  in  any  of  the  forms  acceptable  to

Tcl_GetBoolean. The default is true.

51Name:           thickness
52Class:          Thickness
53Command‐Line Switch:           ‐thickness
54Specifies  the thickness of the separator in any of the forms ac‐
55ceptable to Tk_GetPixels.  The default is 3 pixels.
56
57The iwidgets::dialogshell command creates a dialog shell which is
58a top level widget composed of a button box, separator, and child
59site area.  The class also has methods  to  control  button  con‐
60struction.
61
62The  iwidgets::dialogshell command create a new Tcl command whose
63name is pathName.  This command may be used to invoke various op‐
64erations on the widget.  It has the following general form: path‐

Name option ?arg arg ...? Option and the args determine the ex‐

66act behavior of the command.  The following commands are possible
67for dialogshell widgets:

activate center deactivate

69See the "shell" manual entry for details on the  above  inherited
70methods.

add buttonconfigure defaultdelete

hide index insert invoke

show

74See  the  "buttonbox"  manual entry for details on the associated
75methods.  pathName cget option Returns the current value  of  the
76configuration option given by option.  Option may have any of the
77values accepted by the iwidgets::dialogshell  command.   pathName

childsite Returns the pathname of the child site widget. path‐

Name configure ?option? ?value option value ...? Query or modify

80the  configuration options of the widget.  If no option is speci‐
81fied, returns a list describing all of the available options  for

pathName (see Tk_ConfigureInfo for information on the format of

83this list).  If option is specified with no value, then the  com‐
84mand  returns  a  list describing the one named option (this list
85will be identical to the corresponding sublist of the  value  re‐
86turned  if  no option is specified).  If one or more option−value
87pairs are specified, then the command modifies the  given  widget
88option(s)  to  have the given value(s);  in this case the command
89returns an empty string.  Option may have any of the  values  ac‐
90cepted by the iwidgets::dialogshell command.
91
92Name:           dschildsite
93Class:          frame
94The  dschildsite  component is the user child site for the dialog
95shell.  See the "frame" widget manual entry for  details  on  the
96dschildsite component item.
97Name:           separator
98Class:          frame
99The  separator  component devides the area between the user child
100site and the button box.  See the "frame" widget manual entry for
101details on the separator component item.
102Name:           bbox
103Class:          ButtonBox
104The  bbox  component is the button box containing the buttons for
105the dialog shell.  See the "ButtonBox" widget  manual  entry  for
106details on the bbox component item.
107
108 package require Iwidgets 4.0
109 iwidgets::dialogshell .ds ‐modality none
110
111 .ds add OK ‐text "OK"
112 .ds add Cancel ‐text "Cancel"
113 .ds default OK
114
115 .ds activate Mark L. Ulferts dialogshell, dialog, shell, widget
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
Impressum