radiobutton widget
A GtkRadioButton
Definition
<radiobutton tag_attr="value"...>
<label>text</label>
<default>state</default>
<variable>varname</variable>
<input>command</input>
<input file>filename</input>
<sensitive>state</sensitive>
<action>activity</action>...
<action signal="type">activity</action>...
<action type="function">parameter</action>...
<output file>filename</output>
</radiobutton>
"..." denotes acceptance of multiples of the same thing.
Tag Attributes
See the GtkRadioButton 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 | 0.7.21 |
space-fill | Pack widget filling space | true or false | 0.7.21 |
block-function-signals | Block signal emissions from functions | true or false | 0.7.21 |
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 |
Directives
Some of these may have tag attribute equivalents.
Name | Description | Contents | Mandatory | Since |
label | Initial text | | | |
default | Initial state | true or false | | |
variable | Shell variable name | | | |
input | Data input source | Shell command | | 0.8.1 |
input file | Data input source | Filename | | 0.8.1 |
sensitive | Sensitive state | true or false | | |
action | Execute command on default signal | Shell command | | |
action | Perform function on default signal | function:parameter[1] | | |
action signal="type" | Execute command on signal | Shell command | | |
action signal="type" | Perform function on signal | function:parameter[1] | | |
action type="function" | Perform function on default signal | parameter | | |
output file | Data output target | Filename | | 0.8.1 |
Signals
The default signal is "toggled", emitted when the state is changed.
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, 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 | Shell variable name | |
disable | Desensitise widget | Shell variable name | |
show | Show widget | Shell variable name | 0.8.1 |
hide | Hide widget | Shell variable name | 0.8.1 |
activate | Activate widget | Shell variable name | 0.8.1 |
grabfocus | Grab input focus | Shell variable name | 0.8.1 |
refresh | Reload input data | Shell variable name | 0.8.1 |
save | Save widget data | Shell variable name | 0.8.1 |
clear | Remove all widget data | Shell variable name | 0.8.1 |
The following general functions can be performed by any widget capable of emitting signals:
Type | Description | Parameter | Since |
command | Execute command | Shell command | |
exit | Exit dialog | A value for the EXIT shell variable | |
closewindow | Close dialog | Shell variable name | |
launch | Launch dialog | Shell variable name | |
presentwindow | Present dialog | Shell variable name | 0.8.1 |
Notes
1. This widget supports conditional function execution by prepending function:parameter with if true or if false .
button,
checkbox,
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,
|