A command which creates a button for selection of single files. Clicking on the displayed button will cause the display of a filechooser dialog. Synopsis
gnocl::fileChooserButton
[-option value...]
Screenshot
Options
- -borderWidth int
- Space around the widgets contents in pixels.
-data string
(default: "")
- User defined data which can be retrieved via the cget subcommand..
- -focusClick boolean
(default: 1)
Whether the button grabs focus when it is clicked
with the mouse.
-hasFocus boolean
(default: 0)
- Name of the widget, can be used to
set options in an rc file.
-heightGroup string
(default: "")
- The -heightGroup option can be an arbitrary string. All widgets with the
same heightGroup request the same height. If packed with the fill flag
set, they will have nevertheless different heights.
-name string
(default: "")
- Name of the widget, can be used to
set options in an rc file..
- -onFileSet string
(default: "")
- Tcl command which is executed in
the global scope when a file is selected. Before evaluation the following percent strings
are substituted:
%w widget
name
%f name of the file selected
%g glade/builder name - -sensitive boolean
(default: 1)
- Whether or not the item is
sensitive to user input.
-tooltip string (default: "")
- Message that appear next to this widget when the mouse pointer is held over it for a short amount of time.
-title percent-string (default: "")
Title to put on the file chooser dialog associated with the button. - -visible boolean
(default: 1)
- Whether or not the item is visible.
- -widthGroup string (default: "")
- The -widthGroup option can be an
arbitrary string. All widgets with the same widthGroup request the same
width. If packed with the fill flag set, they will have nevertheless
different widths.
Description
A widget that lets the user select a
file. If the button is clicked, it
will launch a filechooser dialog and then display the name of the file
selected and its associated icon type.
Commands
id cget option
Returns the value for the specified
option. The option may have any of hte values accepted by configure.
id class
Returns the class of the widget, i.e.
fileChooserButton
id configure [-option value...]
Configures the widget. Option may have
any of the values accepted on creation of the widget.
- id delete
- Deletes the widget and the
associated tcl command.
Example
#!/bin/sh
#\
exec tclsh "$0" "$@"
package require Gnocl
set box [gnocl::box -orientation vertical]
set fileBut [gnocl::fileChooserButton \
-borderWidth 10 \
-widthChars 15 \
-onFileSet {puts "You picked %f"}]
$box add $fileBut
gnocl::window -child $box
| 
