Greeter.ui

From LXDE.org
Jump to: navigation, search

Unofficial Documentation of the Ported Industrial Theme's greeter.ui File

<?xml version="1.0"?>
<interface>

The first object is a call for the widget derived from the style "back" element defined in the [gtkrc]. This is the background image. The rest of the objects are the children/grandchildren/great-grandchildren of this object.

<object class="GtkWindow" id="lxdm">
<property name="decorated">False</property>

This section describes the vbox1 object, a vertical box within which will be the time widget defined in the gtkrc.

<child>
<object class="GtkVBox" id="vbox1">
<property name="visible">True</property>
<property name="orientation">vertical</property>

This section describes the structure of the vbox1's first child, the time element. To not display the time on your greeter, edit <property name="visible">True</property> to read False. The text formatting of the time object is controlled by the gtkrc file (see the style "time" element).

<child>
<object class="GtkLabel" id="time">
<property name="visible">True</property>
<property name="xalign">1</property>
<property name="xpad">12</property>
<property name="ypad">12</property>
<property name="single_line_mode">True</property>
</object>
<packing>
<property name="expand">False</property>
<property name="position">0</property>
</packing>
</child>

This section describes the object alignment1.

<child>
<object class="GtkAlignment" id="alignment1">
<property name="visible">True</property>
<property name="xscale">0</property>
<property name="yscale">0</property>

This section describes the vbox2 object and its child, image1. To hide the large white login image, edit the image1 object's <property name="visible">True</property> to read False. To replace the login image edit the image1 object's <property name="pixbuf">login.png</property> to read your replacement image.

<child>
<object class="GtkVBox" id="vbox2">
<property name="visible">True</property>
<property name="orientation">vertical</property>
<child>
<object class="GtkImage" id="image1">
<property name="visible">True</property>
<property name="pixbuf">login.png</property>
</object>
<packing>
<property name="position">0</property>
</packing>
</child>

This section describes the alignment2 object which will set the alignment properties of its child hbox3.

<child>
<object class="GtkAlignment" id="alignment2">
<property name="visible">True</property>
<property name="xscale">0</property>
<property name="yscale">0</property>

This section describes the hbox3 object and its children: prompt and login_entry. Note that the prompt object is, in fact, the prompt widget defined in the gtkrc file, so to change the text formatting edit the stlye "prompt" element. It is not recommended to hide these entries, as hiding the prompt object may make it difficult to login and hiding the login_entry object may make it impossible to login.

<child>
<object class="GtkHBox" id="hbox3">
<property name="visible">True</property>
<property name="spacing">12</property>
<child>
<object class="GtkLabel" id="prompt">
<property name="visible">True</property>
<property name="label" translatable="yes">User:</property>
</object>
<packing>
<property name="expand">False</property>
<property name="fill">False</property>
<property name="position">0</property>
</packing>
</child>
<child>
<object class="GtkEntry" id="login_entry">
<property name="visible">True</property>
<property name="can_focus">True</property>
<property name="invisible_char">•</property>
</object>
<packing>
<property name="expand">False</property>
<property name="fill">False</property>
<property name="position">1</property>
</packing>
</child>
</object>
</child>
</object>
<packing>
<property name="position">1</property>
</packing
</child>
</object>
</child>
</object>
<packing>
<property name="position">1</property>
</packing>
</child>

This section describes the structure of the bottom pane element, which calls the bottom_pane widget defined in the gtkrc's style "bottom".

<child>
<object class="GtkEventBox" id="bottom_pane">
<property name="visible">True</property>
<property name="app_paintable">True</property>
<property name="visible_window">False</property>

This bottom pane subsection describes the structure of bottom_hbox object (a horizontal box), nested within which will be its children: sessions_box, lang_box, and exit.

<child>
<object class="GtkHBox" id="bottom_hbox">
<property name="visible">True</property>
<property name="border_width">6</property>
<property name="spacing">12</property>

This section describes the sessions_box object and its children. To change the image that appears next to the sessions label, edit the image2 object's <property name="pixbuf">session.png</property> to read your image (a 32x32 ,png file). You can also change the text displayed by editing the label2 object's <property name="label" translatable="yes">Desktop:</property> to the text of your choosing.

<child>
<object class="GtkHBox" id="sessions_box">
<property name="visible">True</property>
<property name="spacing">6</property>
<child>
<object class="GtkImage" id="image2">
<property name="visible">True</property>
<property name="pixbuf">session.png</property>
</object>
<packing>
<property name="expand">False</property>
<property name="position">0</property>
</packing>
</child>
<child>
<object class="GtkLabel" id="label2">
<property name="visible">True</property>
<property name="label" translatable="yes">Desktop:</property>
</object>
<packing>
<property name="expand">False</property>
<property name="position">1</property>
</packing>
</child>
<child>
<object class="GtkComboBoxEntry" id="sessions">
<property name="visible">True</property>
<property name="text_column">0</property>
</object>
<packing>
<property name="expand">False</property>
<property name="position">2</property>
</packing>
</child>
</object>
<packing>
<property name="expand">False</property>
<property name="position">0</property>
</packing>
</child>

This bottom pane subsection describes the structure of the language element. If you don't wish to display the language box, edit the lang_box object's <property name="visible">True</property> to read False. To replace the image displayed next to the language box, edit the image3 object's <property name="pixbuf">lang.png</property> to read your replacement image (a 32x32 .png file).

<child>
<object class="GtkHBox" id="lang_box">
<property name="visible">True</property>
<property name="spacing">6</property>
<child>
<object class="GtkImage" id="image3">
<property name="visible">True</property>
<property name="pixbuf">lang.png</property>
</object>
<packing>
<property name="expand">False</property>
<property name="position">0</property>
</packing>
</child>
<child>
<object class="GtkLabel" id="label_lang">
<property name="visible">True</property>
<property name="label" translatable="yes">Language:</property>
</object>
<packing>
<property name="expand">False</property>
<property name="position">1</property>
</packing>
</child>
<child>
<object class="GtkComboBoxEntry" id="lang">
<property name="visible">True</property>
<property name="text_column">0</property>
</object>
<packing>
<property name="expand">False</property>
<property name="position">2</property>
</packing>
</child>
</object>
<packing>
<property name="expand">False</property>
<property name="position">1</property>
</packing>
</child>

This section describes the structure of the Keyboard Layout element. Note that the label3 and keyboard objects do not have a visibility property, which seems to mean that it does not display by default, so if you wish to have a choice of keyboard layouts, add <property name="visible">True</property> to both objects.

<child>
<object class="GtkLabel" id="label3">
<property name="label" translatable="yes">Keyboard Layout:</property>
</object>
<packing>
<property name="expand">False</property>
<property name="position">2</property>
</packing>
</child>
<child>
<object class="GtkComboBox" id="keyboard"/>
<packing>
<property name="expand">False</property>
<property name="position">3</property>
</packing>
</child>

This bottom pane subsection describes the structure of the exit element. Note that because the exit object is a GtkButton object it is structured differently than the sessions, language, and keyboard layout elements. The use_stock property provides a default image, and if set to false will present the label property instead.

<child>
<object class="GtkButton" id="exit">
<property name="label">gtk-quit</property>
<property name="visible">True</property>
<property name="can_focus">True</property>
<property name="receives_default">True</property>
<property name="relief">none</property>
<property name="use_stock">True</property>
</object>
<packing>
<property name="expand">False</property>
<property name="pack_type">end</property>
<property name="position">4</property>
</packing>
</child>

This is end-of-file closing up of children and objects.

</object>
</child>
</object>
<packing>
<property name="expand">False</property>
<property name="position">2</property>
</packing>
</child>
</object>
</child>
</object>
</interface>