diff options
author | Karl Berry <karl@freefriends.org> | 2015-04-26 22:16:26 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2015-04-26 22:16:26 +0000 |
commit | 342e672574c4e67d510e46ab6acd0e21a7d0cf54 (patch) | |
tree | 79e04202d08c0404bbd780bd26c1e34710e539b6 /Master/tlpkg/tlperl/lib/Tk/chooseColor.pod | |
parent | be2706af7c57a0ef0f4d4e9f684ca4ef74922a82 (diff) |
(tl)perl 5.20.2 for windows, from siep
git-svn-id: svn://tug.org/texlive/trunk@37064 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/tlpkg/tlperl/lib/Tk/chooseColor.pod')
-rw-r--r-- | Master/tlpkg/tlperl/lib/Tk/chooseColor.pod | 64 |
1 files changed, 64 insertions, 0 deletions
diff --git a/Master/tlpkg/tlperl/lib/Tk/chooseColor.pod b/Master/tlpkg/tlperl/lib/Tk/chooseColor.pod new file mode 100644 index 00000000000..62c2906e77a --- /dev/null +++ b/Master/tlpkg/tlperl/lib/Tk/chooseColor.pod @@ -0,0 +1,64 @@ +# Copyright (c) 1996 Sun Microsystems, Inc. +# See the file "license.terms" for information on usage and redistribution +# of this file, and for a DISCLAIMER OF ALL WARRANTIES. +# +# + +=head1 NAME + +Tk::chooseColor - pops up a dialog box for the user to select a color. + +=for category Popups and Dialogs + +=head1 SYNOPSIS + +S< >I<$color> = I<$widget>-E<gt>B<chooseColor>?(I<-option>=E<gt>I<value>, ...)?; + +=head1 DESCRIPTION + +The method B<chooseColor> is implemented as a perl wrapper +on the core tk "command" B<tk_chooseColor>, and I<$widget> +is passed as the argument to the hidden B<-parent> option. +The implementation of internal B<tk_chooseColor> is platform +specific, on Win32 it is a native dialog, and on UNIX/X11 it is implemented +in terms of L<Tk::ColorEditor|Tk::ColorEditor>. + +The B<chooseColor> method pops up a dialog box for the +user to select a color. The following I<option-value> pairs are +possible as command line arguments: + +=over 4 + +=item B<-initialcolor>=E<gt>I<color> + +Specifies the color to display in the color dialog when it pops +up. I<color> must be in a form acceptable to the B<Tk_GetColor> +function. + +=item B<-parent>=E<gt>$widget + +Makes $widget the logical parent of the color dialog. The color +dialog is displayed on top of its parent window. + +=item B<-title>=E<gt>I<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. + +=back + +If the user selects a color, B<tk_chooseColor> will return the +name of the color in a form acceptable to B<Tk_GetColor>. If the +user cancels the operation, the command will return B<undef>. + +=head1 EXAMPLE + + $widget->configure(-fg => $parent->chooseColor(-initialcolor => 'gray', + -title => "Choose color")); + +=head1 KEYWORDS + +color selection dialog + +=cut + |