1iwidgets::shell  −  Create  and  manipulate  a shell widget iwid‐

gets::shell pathName ?options? itk::Toplevel <‐ iwidgets::Shell

background cursor foreground

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

title

7See the "Toplevel" manual entry for details on the above inherit‐
8ed options.
9
10Name:           height
11Class:          Height
12Command‐Line Switch:           ‐height
13Specifies the height of the shell.  The value may be specified in
14any  of  the  forms  acceptable to Tk_GetPixels.  A value of zero
15causes the height to be adjusted to the required value  based  on
16the  size  requests  of  the  components placed in the childsite.
17Otherwise, the height is fixed.  The default is zero.  NOTE: This
18may  cause some amount of flickering on slower machines.  To pre‐
19vent it simply set the width and height to a appropriate value.
20Name:           master
21Class:          Window
22Command‐Line Switch:           ‐master
23Defines the shell as being a transient  window  with  the  master
24window  given  by the master option.  The master window should be
25either another existing toplevel window or {} for no master.  The
26default is {} for shells and "." for dialogs.
27Name:           modality
28Class:          Modality
29Command‐Line Switch:           ‐modality
30Allows  the  shell  to grab control of the screen in one of three
31different ways: application, system, or none.  Application  modal
32prevents  any other toplevel windows within the application which
33are direct children of ’.’  from  gaining  focus.   System  modal
34locks  the screen and prevents all windows from gaining focus re‐
35gardless of application.  A modality of none performs no grabs at
36all.  The default is none.
37Name:           padX
38Class:          Pad
39Command‐Line Switch:           ‐padx
40Specifies a padding distance for the childsite in the X‐direction
41in any of the forms acceptable to Tk_GetPixels.  The  default  is
4210.
43Name:           padY
44Class:          Pad
45Command‐Line Switch:           ‐pady
46Specifies a padding distance for the childsite in the Y‐direction
47in any of the forms acceptable to Tk_GetPixels.  The  default  is
4810.
49Name:           width
50Class:          Width
51Command‐Line Switch:           ‐width
52Specifies  the width of the shell.  The value may be specified in
53any of the forms acceptable to Tk_GetPixels.   A  value  of  zero
54causes  the  width  to be adjusted to the required value based on
55the size requests of the  components  placed  in  the  childsite.
56Otherwise,  the width is fixed.  The default is zero.  NOTE: This
57may cause some amount of flickering on slower machines.  To  pre‐
58vent it simply set the width and height to a appropriate value.
59
60The  iwidgets::shell command creates a shell which is a top level
61widget which supports modal operation.
62
63The iwidgets::shell command create a new Tcl command  whose  name
64is  pathName.   This command may be used to invoke various opera‐
65tions on the widget.  It has the following general form: pathName

option ?arg arg ...? Option and the args determine the exact be‐

67havior of the command.  The following commands are  possible  for
68shell widgets: pathName activate Display the shell and wait based
69on the modality.  For application and system  modal  activations,
70perform  a  grab  operation, and wait for the result.  The result
71may be returned via an argument to the deactivate method.   path‐

Name center ?widget? Centers the shell with respect to another

73widget.  The widget argument is optional.  If provided, it should
74be  the  path  of another widget with to center upon.  If absent,
75then the shell will be centered on the screen as a whole.   path‐

Name cget option Returns the current value of the configuration

77option given by option.  Option may have any of  the  values  ac‐
78cepted  by  the  iwidgets::shell command.  pathName childsite Re‐
79turns the pathname of the child site widget.  pathName  configure
80?option? ?value option value ...?  Query or modify the configura‐
81tion options of the widget.  If no option is specified, returns a
82list  describing  all  of the available options for pathName (see

Tk_ConfigureInfo for information on the format of this list). If

option is specified with no value, then the command returns a

85list describing the one named option (this list will be identical
86to  the  corresponding sublist of the value returned if no option
87is specified).  If one or more option−value pairs are  specified,
88then  the command modifies the given widget option(s) to have the
89given value(s);  in  this  case  the  command  returns  an  empty
90string.   Option may have any of the values accepted by the iwid‐

gets::shell command. pathName deactivate ?arg? Deactivate the

92display  of  the shell.  The method takes an optional argument to
93be passed to the activate method which returns  the  value.   The
94optional  argument  is  only effective for application and system
95modal dialogs.
96
97Name:           shellchildsite
98Class:          frame
99The shellchildsite component is  the  user  child  site  for  the
100shell.   See  the  "frame" widget manual entry for details on the
101shellchildsite component item.
102
103 package require Iwidgets 4.0
104 iwidgets::shell .sh ‐modality application ‐padx 20 ‐pady 20 ‐ti‐
105tle Shell
106
107 pack [label [.sh childsite].l ‐text SHELL]
108
109 .sh center
110 .sh activate Mark L. Ulferts Kris Raney shell, widget
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132