NAME
gk_about - Display an application about box
SYNOPSIS
- gk_about pathname ?options?
STANDARD OPTIONS
background borderwidth font relief bitmap cursor geometry
See the ``options'' manual entry for details on the standard options.
WIDGET-SPECIFIC OPTIONS
Name: bitmapBg Class: BitmapBg Command-Line Switch: -bitmapBg
-
Specifies the background color of the bitmap.
Name: bitmapFg Class: BitmapFg Command-Line Switch: -bitmapFg
-
Specifies the foreground color of the bitmap.
Name: info Class: Info Command-Line Switch: -info
-
Specifies the textual information to be displayed, not including the software version. If this options is not specified then some default text is used.
Name: infoWidth Class: InfoWidth Command-Line Switch: -infoWidth
-
This specifies the width of the information frame. The information frame contains the bitmap as well as the textual information. This option accepts any form that is acceptable to Tk_GetPixels. If this options is not specified then it defaults to "300 pixels".
Name: title Class: itle Command-Line Switch: -title
-
Specifies the textual title to be displayed at the top of the window. If not specified it defaults to "GroupKit".
Name: version Class: Version Command-Line Switch: -version
-
Specifies the software version and release date.
Name: versionWidth Class: VersionWidth Command-Line Switch: -versionWidth
-
Specifies the width of the message which contains the version information. The value may have any of the forms acceptable to Tk_GetPixels. If not specified, it defaults to 200 pixels.
DESCRIPTION
This widget is a top-level window that contains text that describes GroupKit i.e. it's version number, authors, and other useful information. It is a combination widget; it contains a number of standard Tk widgets (label message button). These various components can be accessed through the appropriate commands (See the Widget Command section).
WIDGET COMMAND
The gk_about 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 gk_about widgets:
- pathName bitmap
-
Return the path name of the label containing the widget's bitmap.
- pathName button
-
Return the path name of the button at the bottom of the widget.
- 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 gk_about command.
- pathName info
-
Return the path name of the message which contains the textual information about the program.
- pathName title
-
Return the path name of the label containing the program's title.
- pathName version
-
Return the path name of the message containing the program's version information.
DEFAULT BINDINGS
There are no default bindings for the widget.
NOTE
This widget is built using the GroupKit class builder; see the GroupKit User Manual for more information.
AUTHOR
Shannon Jaeger ([email protected])