fileselectiondialog - Create and manipulate a file selection dialog widget
SYNOPSIS
fileselectiondialog pathName ?options?INHERITANCE
itk::Toplevel <- Shell <- Dialogshell <- Dialog <- FileselectiondialogSTANDARD OPTIONS
activeBackground foreground insertBorderWidth selectBackground |
background highlightColor insertOffTime selectBorderWidth |
borderWidth highlightThickness insertOnTime selectForeground |
cursor insertBackground insertWidth |
See the "options" manual entry for details on the standard options.
ASSOCIATED OPTIONS
textBackground |
textFont |
See the "entryfield" widget manual entry for details on the above associated options.
childSitePos dirsOn filesOn invalid selectionOn |
directory filesLabel fileType mask |
dirsLabel filesLabelOn filterLabel noMatchString |
dirSearchCommand fileSearchCommand filterOn selectionLabel |
See the "fileselectionbox" widget manual entry for details on the above associated options.
labelFont |
See the "labeledwidget" widget manual entry for details on the above associated options.
textBackground |
textFont |
See the "scrolledlistbox" widget manual entry for details on the above associated options.
activeRelief |
elementBorderWidth |
jump |
troughColor |
See the "scrollbar" widget class manual entry for details on the above associated options.
INHERITED OPTIONS
buttonBoxPadX padY |
buttonBoxPadY separator |
buttonBoxPos thickness |
padX |
See the "dialogshell" widget manual entry for details on the above inherited options.
height |
master |
modality |
width |
See the "shell" widget manual entry for details on the above inherited options.
title |
See the "Toplevel" widget manual entry for details on the above inherited options.
DESCRIPTION
The fileselectiondialog command creates a file selection dialog similar to the OSF/Motif standard composite widget. The fileselectiondialog is derived from the Dialog class and is composed of a FileSelectionBox with attributes set to manipulate the dialog buttons.
METHODS
The fileselectiondialog command creates a new Tcl command whose name is pathName. This command may be used to invoke various operations on the widget. It has the following general form:
pathName option ?arg arg ...?Option and the args determine the exact behavior of the command. The following commands are possible for fileselectiondialog widgets:
ASSOCIATED METHODS
get |
childsite |
filter |
See the "fileselectionbox" class manual entry for details on the associated methods.
INHERITED METHODS
add insert |
buttonconfigure invoke |
default show |
hide |
See the "buttonbox" widget manual entry for details on the above inherited methods.
activate |
center |
deactivate |
See the "shell" widget manual entry for details on the above inherited methods.
WIDGET-SPECIFIC METHODS
- pathName cget option
- Returns the current value of the configuration option given by option. Option may have any of the values accepted by the fileselectiondialog command.
- pathName configure ?option? ?value option value ...?
- Query or modify the configuration options of the widget. If no option is specified, returns a list 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 list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no option is specified). If one or more option-value pairs are specified, then the command modifies the given widget option(s) to have the given value(s); in this case the command returns an empty string. Option may have any of the values accepted by the fileselectiondialog command.
COMPONENTS
Name: fsb Class: Fileselectionbox
EXAMPLE
# # Non-modal example # proc okCallback {} { puts "You selected [.nmfsd get]" .nmfsd deactivate } fileselectiondialog .nmfsd -title Non-Modal .nmfsd buttonconfigure OK -command okCallback .nmfsd activate # # Modal example # fileselectiondialog .mfsd -modality application .mfsd center if {[.mfsd activate]} { puts "You selected [.mfsd get]" } else { puts "You cancelled the dialog" }