pixmap widget
A GtkImage
Definition
<pixmap tag_attr="value"...>
<variable>varname</variable>
<height>value</height>
<width>value</width>
<input file>filename</input>
<input file icon="image"></input>
<input file stock="gtk-image"></input>
<sensitive>state</sensitive>
</pixmap>
"..." denotes acceptance of multiples of the same thing.
Tag Attributes
See the GtkImage 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 |
theme-icon-size | The size of the GTK theme icon | An integer > 0 or -1 to ignore | 0.8.1 |
stock-icon-size | The size of the GTK stock icon | 0 to 6 (see GtkIconSize) | 0.8.1 |
Directives
Some of these may have tag attribute equivalents.
Name | Description | Contents | Mandatory | Since |
variable | Shell variable name | | | |
height | Image scaling dimension | An integer > 0 or -1 to ignore | | 0.7.21 |
width | Image scaling dimension | An integer > 0 or -1 to ignore | | 0.7.21 |
input file | Data input source | Image filename | (0) | |
input file icon="image"[1] | GTK theme icon name | | (0) | 0.7.21 |
input file stock="gtk-image"[2] | GTK stock icon ID | gtk-about , gtk-add , ... (full list) | (0) | |
sensitive | Sensitive state | true or false | | 0.7.21 |
Signals
There is no default signal for this widget.
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 |
refresh | Reload input data | Shell variable name | 0.7.21 |
Notes
1. Theme icons default to 32 and do not scale or refresh (the "theme-icon-size" custom tag attribute can be used to request a size).
2. Stock icons default to GTK_ICON_SIZE_DND and do not scale or refresh (the "stock-icon-size" custom tag attribute can be used to request a size).
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,
|