-
Notifications
You must be signed in to change notification settings - Fork 1
colorbutton
<colorbutton tag_attr="value"...>
<default>data</default>
<variable>varname</variable>
<input>command</input>
<input file>filename</input>
<sensitive>state</sensitive>
<action>activity</action>...
<action signal="type">activity</action>...
<action function="type">parameter</action>...
<output file>filename</output>
</colorbutton>
"..." denotes acceptance of multiples of the same thing.
See the GtkColorButton widget and ancestor class properties.
The following custom tag attributes are available:
Name | Description | Value | Since |
---|---|---|---|
space-expand | Pack widget expanding into space |
true or false
|
|
space-fill | Pack widget filling space |
true or false
|
|
block-function-signals | Block signal emissions from functions |
true or false
|
|
file-monitor | Emit signal when input file(s) change |
true or false
|
0.8.1 |
auto-refresh | Auto refresh when input file(s) change |
true or false
|
0.8.1 |
Some of these may have tag attribute equivalents.
Name | Description | Contents | Since |
---|---|---|---|
default | Initial data | #rrggbb ` | ` alpha[1] |
variable | Variable name | ||
variable export="false" | Variable name, not exported to shell | 0.8.3 | |
input | Data input source | Shell command | |
input file | Data input source | Filename | |
sensitive | Sensitive state |
true or false
|
|
action | Execute command on default signal | Shell command | |
action | Perform function on default signal | function:parameter | |
action signal="type" | Execute command on signal | Shell command | |
action signal="type" | Perform function on signal | function:parameter | |
action function="type" | Perform function on default signal | parameter | 0.8.3 |
action condition="type" | Execute command on default signal conditionally | Shell command | 0.8.3 |
action condition="type" | Perform function on default signal conditionally | function:parameter | 0.8.3 |
action signal="type" condition="type" | Execute command on signal conditionally | Shell command | 0.8.3 |
action signal="type" condition="type" | Perform function on signal conditionally | function:parameter | 0.8.3 |
action function="type" condition="type" | Perform function on default signal conditionally | parameter | 0.8.3 |
output file | Data output target | Filename | |
The default signal is "color-set", emitted when the user selects a colour.
The "file-changed" signal is emitted if file-monitor is true and the input file being monitored has changed.
The following signals are connected-up for all widgets:
button-press-event, button-release-event, configure-event, enter-notify-event, leave-notify-event, focus-in-event, focus-out-event, hide, show, realize, key-press-event, key-release-event, map-event, unmap-event
The following functions can be performed upon this widget by any widget capable of emitting signals:
Type | Description | Parameter | Since |
---|---|---|---|
enable | Sensitise widget | Variable name | |
disable | Desensitise widget | Variable name | |
show | Show widget | Variable name | 0.8.1 |
hide | Hide widget | Variable name | 0.8.1 |
activate | Activate widget | Variable name | 0.8.1 |
grabfocus | Grab input focus | Variable name | 0.8.1 |
refresh | Reload input data | Variable name | |
save | Save widget data | Variable name | |
The following general functions can be performed by any widget capable of emitting signals:
Type | Description | Parameter | Since |
---|---|---|---|
break | Break out of actions list | None | 0.8.3 |
command | Execute command | Shell command | |
exit | Exit dialog | A value for the EXIT variable |
|
closewindow | Close dialog | Variable name | |
launch | Launch dialog | Variable name | |
presentwindow | Present dialog | Variable name | 0.8.1 |
The following conditions can be used within the condition attribute of action directives:
Type | Description | Argument | Since |
---|---|---|---|
active_is_true(argument) | Active state of toggle widget | Variable name | 0.8.3 |
active_is_false(argument) | Active state of toggle widget | Variable name | 0.8.3 |
command_is_true(argument) | Output of shell command | Shell command | 0.8.3 |
command_is_false(argument) | Output of shell command | Shell command | 0.8.3 |
file_is_true(argument) | Contents of a file | Filename | 0.8.3 |
file_is_false(argument) | Contents of a file | Filename | 0.8.3 |
sensitive_is_true(argument) | Sensitive state of widget | Variable name | 0.8.3 |
sensitive_is_false(argument) | Sensitive state of widget | Variable name | 0.8.3 |
visible_is_true(argument) | Visible state of widget | Variable name | 0.8.3 |
visible_is_false(argument) | Visible state of widget | Variable name | 0.8.3 |
true means "true", "yes" or a non-zero value, false means "false", "no" or zero, therefore the shell command is expected to echo one of these values to stdout.
- Setting the "use-alpha" tag attribute to true will enable alpha selection. Alpha can be passed in following the #rrggbb value separated by a '
|
' character, or via the "alpha" tag attribute. Although the colour selection dialog displays alpha as an 8bit 0-255 value, GTK+ and Gtkdialog manage it as a 16bit 0-65535 value and therefore it'll require converting between the two formats. To convert from 8bit to 16bit usealpha * 257
and from 16bit to 8bit use(alpha + 257 / 2) / 257
.
This widget was introduced in version 0.7.21.