tk_choosecolor(1t) [opensolaris man page]

tk_chooseColor(1T)					       Tk Built-In Commands						tk_chooseColor(1T)

__________________________________________________________________________________________________________________________________________________

NAME

       tk_chooseColor - pops up a dialog box for the user to select a color.

SYNOPSIS

       tk_chooseColor ?option value ...?
_________________________________________________________________

DESCRIPTION

       The  procedure tk_chooseColor pops up a dialog box for the user to select a color. The following option-value pairs are possible as command
       line arguments:

       -initialcolor color
	      Specifies the color to display in the color dialog when it pops up. color must be in a form acceptable to the Tk_GetColor function.

       -parent window
	      Makes window the logical parent of the color dialog. The color dialog is displayed on top of its parent window.

       -title titleString
	      Specifies a string to display as the title of the dialog box. If this option is not specified, then a default  title  will  be  dis-
	      played.

       If the user selects a color, tk_chooseColor will return the name of the color in a form acceptable to Tk_GetColor.  If the user cancels the
       operation, both commands will return the empty string.

EXAMPLE

	      button .b -bg [tk_chooseColor -initialcolor gray -title "Choose color"]

KEYWORDS

       color selection dialog

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tk is available on http://opensolaris.org.

Tk									4.2							tk_chooseColor(1T)

tk_chooseDirectory(n)					       Tk Built-In Commands					     tk_chooseDirectory(n)

__________________________________________________________________________________________________________________________________________________

NAME

       tk_chooseDirectory - pops up a dialog box for the user to select a directory.

SYNOPSIS

       tk_chooseDirectory ?option value ...?
_________________________________________________________________

DESCRIPTION

       The  procedure tk_chooseDirectory pops up a dialog box for the user to select a directory. The following option-value pairs are possible as
       command line arguments:

       -initialdir dirname
	      Specifies that the directories in directory should be displayed when the dialog pops up. If this parameter is  not  specified,  then
	      the  directories	in  the current working directory are displayed. If the parameter specifies a relative path, the return value will
	      convert the relative path to an absolute path.

       -mustexist boolean
	      Specifies whether the user may specify non-existent directories.	If this parameter is true, then the user may only select  directo-
	      ries that already exist.	The default value is false.

       -parent window
	      Makes window the logical parent of the dialog. The dialog is displayed on top of its parent window. On Mac OS X, this turns the file
	      dialog into a sheet attached to the parent window.

       -title titleString
	      Specifies a string to display as the title of the dialog box. If this option is not specified, then a default  title  will  be  dis-
	      played.

EXAMPLE

	      set dir [tk_chooseDirectory 
		      -initialdir ~ -title "Choose a directory"]
	      if {$dir eq ""} {
		 label .l -text "No directory selected"
	      } else {
		 label .l -text "Selected $dir"
	      }

SEE ALSO

       tk_getOpenFile(n), tk_getSaveFile(n)

KEYWORDS

       directory, selection, dialog, platform-specific

Tk									8.3						     tk_chooseDirectory(n)