NAME

       Tk::chooseColor - pops up a dialog box for the user to select a color.

SYNOPSIS

           $color = $widget->chooseColor?(-option=>value, ...)?;

DESCRIPTION

       The method chooseColor is implemented as a perl wrapper on the core tk "command" tk_chooseColor, and
       $widget is passed as the argument to the hidden -parent option.  The implementation of internal
       tk_chooseColor is platform specific, on Win32 it is a native dialog, and on UNIX/X11 it is implemented in
       terms of Tk::ColorEditor.

       The chooseColor method 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=>$widget
           Makes $widget 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 displayed.

       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, the command will return undef.

EXAMPLE

        $widget->configure(-fg => $parent->chooseColor(-initialcolor => 'gray',
                                                       -title => "Choose color"));

KEYWORDS

       color selection dialog

perl v5.18.1                                       2012-11-12                                   chooseColor(3pm)