/usr/gnu/man2/cat.n/tk_chooseColor.n.Z(/usr/gnu/man2/cat.n/tk_chooseColor.n.Z)

______________________________________________________________________________

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  com-
       mand 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  func-
              tion.

       -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

Tk                                    4.2                    tk_chooseColor(n)