'\"
|
'\"
|
'\" Copyright (c) 1996 Sun Microsystems, Inc.
|
'\" Copyright (c) 1996 Sun Microsystems, Inc.
|
'\"
|
'\"
|
'\" See the file "license.terms" for information on usage and redistribution
|
'\" See the file "license.terms" for information on usage and redistribution
|
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
|
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
|
'\"
|
'\"
|
'\" RCS: @(#) $Id: chooseColor.n,v 1.1.1.1 2002-01-16 10:25:48 markom Exp $
|
'\" RCS: @(#) $Id: chooseColor.n,v 1.1.1.1 2002-01-16 10:25:48 markom Exp $
|
'\"
|
'\"
|
.so man.macros
|
.so man.macros
|
.TH tk_chooseColor n 4.2 Tk "Tk Built-In Commands"
|
.TH tk_chooseColor n 4.2 Tk "Tk Built-In Commands"
|
.BS
|
.BS
|
'\" Note: do not modify the .SH NAME line immediately below!
|
'\" Note: do not modify the .SH NAME line immediately below!
|
.SH NAME
|
.SH NAME
|
tk_chooseColor \- pops up a dialog box for the user to select a color.
|
tk_chooseColor \- pops up a dialog box for the user to select a color.
|
.PP
|
.PP
|
.SH SYNOPSIS
|
.SH SYNOPSIS
|
\fBtk_chooseColor \fR?\fIoption value ...\fR?
|
\fBtk_chooseColor \fR?\fIoption value ...\fR?
|
.BE
|
.BE
|
|
|
.SH DESCRIPTION
|
.SH DESCRIPTION
|
.PP
|
.PP
|
The procedure \fBtk_chooseColor\fR pops up a dialog box for the
|
The procedure \fBtk_chooseColor\fR pops up a dialog box for the
|
user to select a color. The following \fIoption\-value\fR pairs are
|
user to select a color. The following \fIoption\-value\fR pairs are
|
possible as command line arguments:
|
possible as command line arguments:
|
.TP
|
.TP
|
\fB\-initialcolor\fR \fIcolor\fR
|
\fB\-initialcolor\fR \fIcolor\fR
|
Specifies the color to display in the color dialog when it pops
|
Specifies the color to display in the color dialog when it pops
|
up. \fIcolor\fR must be in a form acceptable to the \fBTk_GetColor\fR
|
up. \fIcolor\fR must be in a form acceptable to the \fBTk_GetColor\fR
|
function.
|
function.
|
.TP
|
.TP
|
\fB\-parent\fR \fIwindow\fR
|
\fB\-parent\fR \fIwindow\fR
|
Makes \fIwindow\fR the logical parent of the color dialog. The color
|
Makes \fIwindow\fR the logical parent of the color dialog. The color
|
dialog is displayed on top of its parent window.
|
dialog is displayed on top of its parent window.
|
.TP
|
.TP
|
\fB\-title\fR \fItitleString\fR
|
\fB\-title\fR \fItitleString\fR
|
Specifies a string to display as the title of the dialog box. If this
|
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.
|
option is not specified, then a default title will be displayed.
|
.LP
|
.LP
|
If the user selects a color, \fBtk_chooseColor\fR will return the
|
If the user selects a color, \fBtk_chooseColor\fR will return the
|
name of the color in a form acceptable to \fBTk_GetColor\fR. If the
|
name of the color in a form acceptable to \fBTk_GetColor\fR. If the
|
user cancels the operation, both commands will return the empty
|
user cancels the operation, both commands will return the empty
|
string.
|
string.
|
.SH EXAMPLE
|
.SH EXAMPLE
|
.CS
|
.CS
|
button .b \-fg [tk_chooseColor \-initialcolor gray \-title "Choose color"]
|
button .b \-fg [tk_chooseColor \-initialcolor gray \-title "Choose color"]
|
.CE
|
.CE
|
|
|
.SH KEYWORDS
|
.SH KEYWORDS
|
color selection dialog
|
color selection dialog
|
|
|