A standard dialogue to choose a colour.

Synopsis

colorSelection [-option value...]

Screenshot

Options

-title

type: string (default: "")

Title of the colorSelection.

-modal

type: boolean (default: 0)

Whether the window is modal, i.e. it grabs all GTK+ events. If the dialogue is created modal, the command returns the chosen colour as list of rgba values or the empty string instead of the usual widget ID.

-palette

type: boolean (default: 1)

Whether the dialog has a palette.

-opacity

type: boolean (default: 0)

Whether the dialog has a control for opacity.

-color

type: color

Default colour for the dialogue.

-alpha

type: integer

Default alpha value.

-onClicked

type: string (default: "")

Command to be executed in the global scope if the Ok or Cancel button is chosen. Before evaluation the following percent strings are substituted:

%w    widget name
%x    button chosen: OK or CANCEL
%r    red value
%g    green value
%b    blue value
%a    alpha value

-visible

type: boolean (default: 1)

Whether or not the item is visible.

-name

type: string

Name of the widget, can be used to set options in an rc file.

-onDestroy

type: string (default: "")

Tcl command which is executed if the widget is destroyed. Before evaluation the following percent strings are substituted:

%w    widget name

Description

A colorSelection is used to let the user choose a colour in a standardized way. If the dialogue is created modal, the commands returns a list of the red, blue, green and alpha, or the empty string if Cancel is chosen. Otherwise it returns a widget ID in the usual way. The files and buttons chosen can be retrieved via the onClicked command.

Commands

id delete

Deletes the widget and the associated tcl command.

id configure [-option value...]

Configures the widget. Option may have any of the values accepted on creation of the widget.

Example

set color [gnocl::colorSelection \
    -title "Please choose a color" \
    -modal 1 \
    -color lightblue]

results in