Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

tk_chooseColor (1t)

Name

tk_chooseColor - pops up a dialog box for the user to select a color.

Synopsis

tk_chooseColor ?option value ...?

Description

tk_chooseColor(1t)           Tk Built-In Commands           tk_chooseColor(1t)



______________________________________________________________________________

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, color selection, dialog



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | runtime/tk-8     |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source        was        downloaded        from         https://source-
       forge.net/projects/tcl/files/Tcl/8.6.7/tk8.6.7-src.tar.gz/download.

       Further information about this software can be found on the open source
       community website at https://www.tcl.tk/.



Tk                                    4.2                   tk_chooseColor(1t)