1<TITLE>selectiondialog - Create and manipulate a selection dialog widget</TITLE> 2<H1>selectiondialog - Create and manipulate a selection dialog widget</H1> 3 4</pre><H2>SYNOPSIS</H2> 5<B>selectiondialog<I> <I>pathName </I>?<I>options</I>? 6</pre><H2>INHERITANCE</H2> 7itk::Toplevel <- Shell <- Dialogshell <- Dialog <- Selectiondialog 8</pre><H2>STANDARD OPTIONS</H2> 9<P> 10<table cellpadding=5> 11<td valign=top> 12<B>activeBackground</B><br> 13<B>exportSelection</B><br> 14<B>insertBackground</B><br> 15<B>insertWidth</B><br> 16</td> 17<td valign=top> 18<B>background</B><br> 19<B>foreground</B><br> 20<B>insertBorderWidth</B><br> 21<B>selectBackground</B><br> 22</td> 23<td valign=top> 24<B>borderWidth</B><br> 25<B>highlightColor</B><br> 26<B>insertOffTime</B><br> 27<B>selectBorderWidth</B><br> 28</td> 29<td valign=top> 30<B>cursor</B><br> 31<B>highlightThickness</B><br> 32<B>insertOnTime</B><br> 33<B>selectForeground</B><br> 34</td> 35</table> 36<P> 37See the <A HREF="http://www.sco.com/Technology/tcl/man/tk_man/options.n.html"> "options" </A> manual entry for details on the standard options. 38</pre><H2>ASSOCIATED OPTIONS</H2> 39<P> 40<table cellpadding=5> 41<td valign=top> 42<B>textBackground</B><br> 43</td> 44<td valign=top> 45<B>textFont</B><br> 46</td> 47<td valign=top> 48</td> 49<td valign=top> 50</td> 51</table> 52<P> 53See the <A HREF="entryfield.n.html"> "entryfield" </A> widget manual entry for details on the above 54associated options. 55<P> 56<table cellpadding=5> 57<td valign=top> 58<B>labelFont</B><br> 59</td> 60<td valign=top> 61</td> 62<td valign=top> 63</td> 64<td valign=top> 65</td> 66</table> 67<P> 68See the <A HREF="labeledwidget.n.html"> "labeledwidget" </A> widget manual entry for details on the above 69associated options. 70<P> 71<table cellpadding=5> 72<td valign=top> 73<B>activeRelief</B><br> 74</td> 75<td valign=top> 76<B>elementBorderWidth</B><br> 77</td> 78<td valign=top> 79<B>jump</B><br> 80</td> 81<td valign=top> 82<B>troughColor</B><br> 83</td> 84</table> 85<P> 86See the <A HREF="http://www.sco.com/Technology/tcl/man/tk_man/scrollbar.n.html"> "scrollbar" </A> widget class manual entry for details on the above 87associated options. 88<P> 89<table cellpadding=5> 90<td valign=top> 91<B>textBackground</B><br> 92</td> 93<td valign=top> 94<B>textFont</B><br> 95</td> 96<td valign=top> 97</td> 98<td valign=top> 99</td> 100</table> 101<P> 102See the <A HREF="scrolledlistbox.n.html"> "scrolledlistbox" </A> widget class manual entry for details on the above 103associated options. 104<B>childsitepos</B> <B>itemsCommand</B> <B>itemsLabel</B> <B>itemsOn</B> 105<B>selectionCommand</B> <B>selectionLabel</B> <B>selectionOn</B> 106</table> 107<P> 108See the <A HREF="selectionbox.n.html"> "selectionbox" </A> widget manual entry for details on the above 109associated options. 110</pre><H2>INHERITED OPTIONS</H2> 111<P> 112<table cellpadding=5> 113<td valign=top> 114<B>buttonBoxPadX</B><br> 115<B>padY</B><br> 116</td> 117<td valign=top> 118<B>buttonBoxPadY</B><br> 119<B>separator</B><br> 120</td> 121<td valign=top> 122<B>buttonBoxPos</B><br> 123<B>thickness</B><br> 124</td> 125<td valign=top> 126<B>padX</B><br> 127</td> 128</table> 129<P> 130See the <A HREF="dialogshell.n.html"> "dialogshell" </A> widget manual entry for details on the above 131inherited options. 132<P> 133<table cellpadding=5> 134<td valign=top> 135<B>height</B><br> 136</td> 137<td valign=top> 138<B>master</B><br> 139</td> 140<td valign=top> 141<B>modality</B><br> 142</td> 143<td valign=top> 144<B>width</B><br> 145</td> 146</table> 147<P> 148See the "shell" widget manual entry for details on the above 149inherited options. 150<P> 151<table cellpadding=5> 152<td valign=top> 153<B>title</B><br> 154</td> 155<td valign=top> 156</td> 157<td valign=top> 158</td> 159<td valign=top> 160</td> 161</table> 162<P> 163See the "Toplevel" widget manual entry for details on the above 164inherited options. 165</pre><HR> 166 167</pre><H2>DESCRIPTION</H2> 168<P> 169The <B>selectiondialog</B> command creates a selection box similar to 170the OSF/Motif standard selection 171dialog composite widget. The selectiondialog is derived from the 172Dialog class and is composed of a selectionbox with commands 173to manipulate the dialog buttons. 174 175</pre><H2>METHODS</H2> 176<P> 177The <B>selectiondialog</B> command creates a new Tcl command whose 178name is <I>pathName</I>. This 179command may be used to invoke various 180operations on the widget. It has the following general form: 181<pre> 182<I>pathName option </I>?<I>arg arg ...</I>? 183</pre> 184<I>Option</I> and the <I>arg</I>s 185determine the exact behavior of the command. The following 186commands are possible for selectiondialog widgets: 187</pre><H2>ASSOCIATED METHODS</H2> 188<P> 189<table cellpadding=5> 190<td valign=top> 191<B>childsite</B><br> 192<B>selectitem</B><br> 193</td> 194<td valign=top> 195<B>clear</B><br> 196</td> 197<td valign=top> 198<B>get</B><br> 199</td> 200<td valign=top> 201<B>insert</B><br> 202</td> 203</table> 204<P> 205See the <A HREF="selectionbox.n.html"> "selectionbox" </A> widget manual entry for details on the above 206associated methods. 207<P> 208<table cellpadding=5> 209<td valign=top> 210<B>curselection</B><br> 211<B>scan</B><br> 212</td> 213<td valign=top> 214<B>delete</B><br> 215<B>selection</B><br> 216</td> 217<td valign=top> 218<B>index</B><br> 219<B>size</B><br> 220</td> 221<td valign=top> 222<B>nearest</B><br> 223</td> 224</table> 225<P> 226See the <A HREF="http://www.sco.com/Technology/tcl/man/tk_man/listbox.n.html"> "listbox" </A> widget manual entry for details on the above 227associated methods. 228</pre><H2>INHERITED METHODS</H2> 229<P> 230<table cellpadding=5> 231<td valign=top> 232<B>add</B><br> 233<B>invoke</B><br> 234</td> 235<td valign=top> 236<B>buttonconfigure</B><br> 237<B>show</B><br> 238</td> 239<td valign=top> 240<B>default</B><br> 241</td> 242<td valign=top> 243<B>hide</B><br> 244</td> 245</table> 246<P> 247See the <A HREF="buttonbox.n.html"> "buttonbox" </A> widget manual entry for details on the above 248inherited methods. 249<P> 250<table cellpadding=5> 251<td valign=top> 252<B>activate</B><br> 253</td> 254<td valign=top> 255<B>center</B><br> 256</td> 257<td valign=top> 258<B>deactivate</B><br> 259</td> 260<td valign=top> 261</td> 262</table> 263<P> 264See the "shell" widget manual entry for details on the above 265inherited methods. 266</pre><H2>WIDGET-SPECIFIC METHODS</H2> 267<DL> 268<DT> <I>pathName <B>cget</B> <I>option</I> 269</I></B> 270<DD> Returns the current value of the configuration option given 271by <I>option</I>. 272<I>Option</I> may have any of the values accepted by the <B>selectiondialog</B> 273command. 274</DL> 275<DL> 276<DT> <I>pathName</I> <B>configure</B> ?<I>option</I>? ?<I>value option value ...</I>? 277</I></B> 278<DD> Query or modify the configuration options of the widget. 279If no <I>option</I> is specified, returns a list describing all of 280the available options for <I>pathName</I> (see <B>Tk_ConfigureInfo</B> for 281information on the format of this list). If <I>option</I> is specified 282with no <I>value</I>, then the command returns a list describing the 283one named option (this list will be identical to the corresponding 284sublist of the value returned if no <I>option</I> is specified). If 285one or more <I>option-value</I> pairs are specified, then the command 286modifies the given widget option(s) to have the given value(s); in 287this case the command returns an empty string. 288<I>Option</I> may have any of the values accepted by the <B>selectiondialog</B> 289command. 290 291</DL> 292</pre><H2>COMPONENTS</H2> 293<P> 294<pre> 295Name: <B>selectionbox</B> 296Class: <B>Selectionbox</B> 297</pre> 298<UL> 299The selectionbox component is the selection box for the selection 300dialog. See the "selectionbox" widget manual entry for details on the 301selectionbox component item. 302</UL> 303</table> 304 305</pre><H2>EXAMPLE</H2> 306<pre> 307 selectiondialog .sd 308 .sd activate 309</pre> 310</pre><H2>AUTHOR</H2> 311Mark L. Ulferts 312</pre><H2>KEYWORDS</H2> 313selectiondialog, selectionbox, dialog, dialogshell, shell, widget 314 315