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