6.1 Extended use of widgets
The reference guide contains most info about the widgets. This chapter is heading for the undocumented features.Generals
Add tooltips.
<hbox tooltip-text=" This is the text ">...</hbox>
Add tooltips with advanced text layout.
<button tooltip-markup="<span background='yellow'><b><i> press alt m </i></b></span>">......</button>
Widgets might be invisible.
<progressbar visible="false">...</progressbar>
Define how much space the widget should take.
<text height-request="50" width-request="200">...</text>
Avoid tab-key to give focus
<edit can-focus="no">...</edit>
Align widget.
xalign/yalign may hold 0 (left), 1 (right) and 2 (center).
xalign/yalign works for most widgets.
For button/progressbar they describe placement of label rather than widget itself.
<text xalign="0">...</text>
<window>
prevent user from resizing the gui.
<window allow-grow="false">
Shrink window smaller than the widgets requires to show up.
<window allow-shrink="true">
<text>
Text knowledge has been moved to its own chapter - gtkdialogDocTips8 Text managing
Justify aligment to right (1), center (2), left (3).
<text justify="2">
Angle the text
<text angle="45">
Force one-line text
<text wrap="false">
<text single-line-mode="true">
Set underline pattern
<text label="Underline me with an useless pattern" pattern=" _"></text>
<button>
You can skip the button decoration.
<button relief="2">...</button>
The image doesn't need to be left of label.
It can be left/right/above/below. Values 0-3.
Be aware that this seems to work only for icons in the gtk-stock.
<button use-stock="true" image-position="3">...</button>
Use gtk-stock values
<button use-stock="true" label="gtk-quit"></button>
Hotkey is set in 2 ways
<button use-stock="true" label="gtk-cancel">...</button>
<button use-underline="true"><label>_Cancel</label>...</button>
Scale icon
<button height-request="50" width-request="80">
<input file>file.jpg</input>
<height>40</height>
<width>70</width>
</button>
<entry>
Give entry focus
<entry text="Focus is here" is-focus="true"></entry>
Not editable
<entry editable="false"></entry>
Password - show input text as ******, and a note if capslock is turned on
<entry visibility="false" caps-lock-warning="true"></entry>
Alternative way to define default text
<entry text="default string">
Show progress in entry - or simply change the color of the entry background
<entry progress-fraction="0.5">
Icons in <entry>
<entry primary-icon-activatable="true" primary-icon-stock="gtk-refresh" secondary-icon-activatable="true" secondary-icon-stock="gtk-clear"
<notebook>
You can define which tab should be active by default. "0" represent tab1, "1" represent tab2 ...
<notebook page="1">...</notebook>
Tabs can be shown at Top/Bottom/Left/Right. Values from 0-3
<notebook tab-pos="3">...</notebook>
Tabs can chosen in right-click menu
<notebook enable-popup="true">...</notebook>
<edit>
insert margins
<edit left-margin="20">...</edit>
avoid user input
<edit editable="no">...</edit>
<pixmap>
Scale image
<pixmap><input file>file.jpg</input><height>40</height><width>70</width></pixmap>
App with extended use of <pixmap><progressbar>
Avoid window to autoscale because of too much text in progressbar.
You can truncate text at left (1), at right (3) or in the middle (2) by the ellipsize tag.
<progressbar text="Truncated the text in the middle" ellipsize="2"></progressbar>
Define the text alignment by text-xalign and text-yalign tag.
Try out values from 0-3 for left, right and center.
<progressbar text-xalign="1" text-yalign="1">
Do not show text
<progressbar show-text="false">
Alternative bar outfit. - view blocks
<progressbar bar-style="1">
Do not truncate result to block-size.
<progressbar discrete-blocks="25">
Set orientation
0 - Horizontal - left to right.
1 - Horizontal - right to left.
2 - Vertical - bottom to top.
3 - Vertical - top to bottom.
<progressbar orientation="3">
<chooser>
Type of chooser-widget
0 - Open file
1 - Save file
2 - Select folder
3 - Create folder
<chooser action="1">
Hide/Show 'create folders' button
<chooser create-folders="false">
App with extended use of <chooser><tree>
manual sort the list
<tree reorderable="true">...</tree> - See the Drag'n drop workaround to succeed
App with extended use of <tree>