1tixDirSelectDialog(n)        Tix Built-In Commands       tixDirSelectDialog(n)
2
3
4

NAME

6       tixDirSelectDialog - Create and manipulate directory selection dialogs.
7

SYNOPSIS

9       tixDirSelectDialog pathName ?options?
10

STANDARD OPTIONS

12       TixDirSelectDialog supports all the standard options of a toplevel wid‐
13       get. See the options(n)  manual  entry  for  details  on  the  standard
14       options.
15

WIDGET-SPECIFIC OPTIONS

17       [-command command]  Specifies  the  command  to be called when the user
18       selects a directory in the dialog box. The command is called  with  one
19       extra  argument,  the  complete  pathname of the directory. If the user
20       cancels the selection, this command is not called.
21

SUBWIDGETS

23       Name:          dirbox
24       Class:         TixDirSelectBox
25
26              The DirSelectBox widget that consists of the main  part  of  the
27              dialog.
28
29       Name:          cancel
30       Class:         Button
31
32              The "Cancel" button.
33
34       Name:          ok
35       Class:         Buton
36
37              The "OK" button.
38

DESCRIPTION

40       The tixDirSelectDialog command creates a new window (given by the path‐
41       Name argument) and makes it into a DirSelectDialog widget.   Additional
42       options,  described  above,  may be specified on the command line or in
43       the option database to configure aspects of the DirSelectDialog such as
44       its cursor and relief.
45
46       The  DirSelectDialog widget presents the directories in the file system
47       in a dialog window. The user can use this  dialog  window  to  navigate
48       through the file system to select the desired directory.
49

WIDGET COMMANDS

51       The  tixDirSelectDialog command creates a new Tcl command whose name is
52       the same as the path name of the DirSelectDialog's window.   This  com‐
53       mand may be used to invoke various operations on the widget. It has the
54       following general form:
55              pathName option ?arg arg ...?
56       PathName is the name of the command, which is the same  as  the  DirSe‐
57       lectDialog  widget's path name. Option and the args determine the exact
58       behavior of the command. The following commands are possible for DirSe‐
59       lectDialog widgets:
60
61       pathName cget option
62              Returns  the  current value of the configuration option given by
63              option. Option may have  any  of  the  values  accepted  by  the
64              tixDirSelectDialog command.
65
66       pathName configure ?option? ?value option value ...?
67              Query  or modify the configuration options of the widget.  If no
68              option is specified, returns a list describing all of the avail‐
69              able  options for pathName (see Tk_ConfigureInfo for information
70              on the format of this list).  If option  is  specified  with  no
71              value,  then the command returns a list describing the one named
72              option (this list will be identical to the corresponding sublist
73              of  the  value  returned  if no option is specified).  If one or
74              more option-value pairs are specified, then the command modifies
75              the  given  widget option(s) to have the given value(s); in this
76              case the command returns an empty string.  Option may  have  any
77              of the values accepted by the tixDirSelectDialog command.
78
79       pathName popup
80              Pops up the DirSelectDialog widget on the screen.
81
82       pathName subwidget  name ?args?
83              When  no options are given, this command returns the pathname of
84              the subwidget of the specified name.
85
86              When options are given, the widget command of the specified sub‐
87              widget will be called with these options.
88

EXAMPLE

90       set dlg [tixDirSelectDialog .dlg -command SelectDir] $dlg popup
91
92       proc SelectDir {dir} {
93           puts "You have selected \"$dir\"" }
94

KEYWORDS

96       Tix(n)
97
98
99
100
101
102
103Tix                                   4.1                tixDirSelectDialog(n)
Impressum