combobox widget
A GtkCombo
This widget has been deprecated since GTK+ 2.4 and comboboxtext or comboboxentry are recommended as replacements. It has been removed from GTK+ 3.0
Definition
<combobox tag_attr="value"...>
<variable>varname</variable>
<sensitive>state</sensitive>
<action signal="type">activity</action>...
<item>data</item>...
</combobox>
“…” denotes acceptance of multiples of the same thing.
Tag Attributes
See the GtkCombo 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 |
|
Directives
Some of these may have tag attribute equivalents.
Name |
Description |
Contents |
Since |
variable |
Variable name |
|
|
variable export=“false” |
Variable name, not exported to shell |
|
0.8.3 |
sensitive |
Sensitive state |
true or false |
|
action signal=“type” |
Execute command on signal |
Shell command |
|
action signal=“type” |
Perform function on signal |
function:parameter |
|
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 |
item |
Input data |
|
|
Signals
There is no default signal for this widget.
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
Functions
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 |
refresh |
Reload input data |
Variable name |
|
clear |
Remove all 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 |
Conditions
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 |
variable_is_true(argument) |
Value of widget |
Variable name |
0.8.4+ |
variable_is_false(argument) |
Value of widget |
Variable name |
0.8.4+ |
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.
Notes
This widget has been deprecated since GTK+ 2.4 and comboboxtext or comboboxentry are recommended as replacements.
This widget has been removed from GTK+ 3.
button,
checkbox,
chooser,
colorbutton,
comboboxentry,
comboboxtext,
combobox,
edit,
entry,
eventbox,
expander,
fontbutton,
frame,
hbox,
hscale,
hseparator,
list,
menubar,
menuitemseparator,
menuitem,
menu,
notebook,
pixmap,
progressbar,
radiobutton,
separator,
spinbutton,
statusbar,
table,
terminal,
text,
timer,
togglebutton,
tree,
vbox,
vscale,
vseparator,
window,
For GTK+ 3 reference see the Gtk-3.0 docs page
|