tree widget
A GtkTreeView packed inside a GtkScrolledWindow
Definition
<tree tag_attr="value"...>
<label>text</label>
<variable>varname</variable>
<height>value</height>
<width>value</width>
<input>command</input>...
<input icon-column="index">command</input>...
<input stock-column="index">command</input>...
<input file>filename</input>...
<input file icon-column="index">filename</input>...
<input file stock-column="index">filename</input>...
<sensitive>state</sensitive>
<action>activity</action>...
<action signal="type">activity</action>...
<action type="function">parameter</action>...
<item>data</item>...
<item icon-name="image">data</item>...
<item stock-id="gtk-image">data</item>...
</tree>
"..." denotes acceptance of multiples of the same thing.
Tag Attributes
See the GtkTreeView 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 |
exported-column | The column to export data from | An integer >= 0 | |
icon-name | Default GTK theme icon name for all rows | | |
stock-id | Default GTK stock icon ID for all rows | gtk-about , gtk-add , ... (full list) | |
selection-mode | Selection method | 0 , 1 , 2 , 3 (none, single, browse, multiple) | 0.7.21 |
Directives
Some of these may have tag attribute equivalents.
Name | Description | Contents | Mandatory | Since |
label | Column header labels | label0 | label1 | ... | | |
variable | Shell variable name | | | |
height[1] | Initial minimum height | An integer > 0 or -1 to ignore | | |
width[1] | Initial minimum width | An integer > 0 or -1 to ignore | | |
input | Data input source | Shell command | | |
input icon-column="index" | Data input source | Shell command | | |
input stock-column="index" | Data input source | Shell command | | |
input file | Data input source | Filename | | |
input file icon-column="index" | Data input source | Filename | | |
input file stock-column="index" | 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 type="function" | Perform function on default signal | parameter | | |
item | Input data | column0data | column1data | ... | | |
item icon-name="image" | Input data | column0data | column1data | ... | | |
item stock-id="gtk-image" | Input data | column0data | column1data | ... | | |
Signals
The default signal is "row-activated", emitted when the user double-clicks a row and also when a row is selected and one of the keys Space, Shift+Space, Return or Enter is pressed.
See also the GtkTreeView widget and ancestor class signals.
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 | |
refresh | Reload input data | Shell variable name | |
clear | Remove all widget data | Shell variable name | 0.7.21 |
removeselected | Remove selected widget data | Shell variable name | |
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 launched dialog | Launched dialog's shell variable name | |
launch | Launch new dialog | New dialog's shell variable name | |
Notes
1. This widget has a default dimension of 200x100 which can be overridden with the height and/or width directives.
button,
checkbox,
colorbutton,
comboboxentry,
comboboxtext,
combobox,
edit,
entry,
frame,
hbox,
hscale,
hseparator,
list,
menubar,
menuitemseparator,
menuitem,
menu,
notebook,
pixmap,
progressbar,
radiobutton,
separator,
spinbutton,
statusbar,
table,
text,
timer,
togglebutton,
tree,
vbox,
vscale,
vseparator,
window,
|