# &app; Interface Designer Manual

Glade is a user interface designer for GTK+ applications.

2006
Vincent Geddes
2004
2003
Sun Microsystems
2002
2000
Michael Vance
GNOME Documentation Project
Vincent
Geddes
GNOME Documentation Project

    vincent.geddes@gmail.com

Sun
GNOME Documentation Team
Sun Microsystems
Michael
Vance
GNOME Documentation Project
&app; Manual &manrevision;
5 December 2006

Vincent Geddes

GNOME Documentation Project

&app; Manual 2.1;
17 June 2004

Sun GNOME Documentation Team

GNOME Documentation Project

&app; User Manual 2.0
25 February 2004

Sun GNOME Documentation Team

GNOME Documentation Project

&app; User Manual 1.2
10 Feb 2004

Sun GNOME Documentation Team

GNOME Documentation Project

&app; User Manual 1.1
30 Mar 2002

Michael Vance

GNOME Documentation Project

&app; User Manual 1.0
11 May 2000

Michael Vance

GNOME Documentation Project

This manual describes version &appversion; of &app;.

## Feedback

To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the GNOME Feedback Page.

## Introduction

The &app; interface designer enables you to create and edit user interface designs for GTK+ applications.

The GTK+ library provides an extensive collection of user interface building blocks such as text boxes, dialog labels, numeric entries, check boxes, and menus. These building blocks are called widgets. You can use &app; to place widgets in a GUI. &app; allows you to modify the layout and properties of these widgets. You can also use &app; to add connections between widgets and application source code.

The user interfaces designed in &app; are stored in an XML format, enabling easy integration with external tools. You can use the libglade library to dynamically create GUIs from the XML description.

## Getting Started

### To Start &app;

You can start &app; in the following ways:

Applications menu

  Choose Programming Glade Interface Designer .

Command line

  To start &app; from a command line, type the following command, then press Return: `glade-3`

### When You Start &app;

When you start &app;, the following window is displayed.

#### &app; window

Shows the&app; window.

The &app; window contains the following elements:

Menubar

  The menus on the menubar contain all of the commands you need to work with files in &app;.

Toolbar

  The toolbar contains a subset of the commands that you can access from the menubar.

Design Area

  The design area is where a user interface can be visually edited.

Palette

  The palette contains the widgets that can be used to build a user interface.

Inspector

  The inspector displays information about the widgets in a project.

Property Editor

  The property editor is used to manipulate the properties of widgets, as well as adding connections to source code.

Statusbar

  The statusbar displays information about current &app; activity and contextual information about the menu items.

## Working with Projects

### Creating a New Project

To create a new project, choose File New. The application displays a new blank project in the &app; window.

### Opening a Project

To open an existing project, choose File Open. The application displays the project in the &app; window.

### Saving a Project

You can save projects in the following ways:

- To save changes to an existing project file, choose File Save.

- To save a new project file or to save an existing project file under a new filename, choose File Save As . Enter a name for the project file in the Save As dialog, then click Save.

## Working with Widgets

### To Select Widgets From the Palette Window

You can work with the widgets in the Palette window in the following ways:

Selection mode

  To use selection mode, click on the Selector arrow. The pointer changes to an arrow to indicate that selection mode is active. In this mode, you use the mouse to select widgets in your project. You can then use the Properties window to edit the properties of the widgets.

  You can also use the widget context menu to select a widget. Right-click on a widget to open the widget context menu.

  You can add multiple widgets of a specific type from the Palette to your project by holding down the Control key when you select a widget. You need to click on the Selector arrow or another widget in the Palette to return to normal mode.

Widget placement mode

  To use widget placement mode, select a widget in the Palette window. When you select most widgets, the pointer changes to a pointer-plus-cross. You can then place the widget inside containers, top-level widgets, and so on. After you place a widget, the mode returns to selection mode.

Top-level placement mode

  To use top level placement mode, select a defined top-level widget in the Palette window. When you select a top-level widget in the Palette window, the widget appears immediately on your desktop. You can then edit the widget. After you select a top-level widget, the mode returns to selection mode.

### To Organize Widgets In Your Project

You use widget containers, or boxes, to layout and organize widgets in your project window. You can choose the following widget containers from the Palette window:

- Horizontal Box

- Vertical Box

- Table

- Fixed Positions

- Horizontal Button Box

- Vertical Button Box

- Horizontal Panes

- Vertical Panes

- Notebook

- Frame

- Scrolled Window

- Viewport

You can nest boxes to create complex layout structures. When you create horizontal and vertical boxes, Glade asks you how many rows or columns to create initially, though rows and columns can easily be added or deleted later.

When you have created all the boxes you require, you can add specific widgets like labels, buttons, and more complicated widgets into the boxes. Notice that Glade packs widgets into the layout which eliminates a lot of tedious work. The use of boxes enables windows to change size to accommodate different size labels in different languages when the application is localized.

### To Place a Widget on the Clipboard

To remove a widget from a parent and place the widget on the clipboard, select the widget then choose Edit Cut .

### To Copy a Widget to the Clipboard

To copy a widget to the clipboard, select the widget then choose Edit Copy . The original widget remains attached to the parent.

### To Paste a Widget From the Clipboard Into Your Project

To paste a widget that exists on the clipboard into your project, choose Edit Paste .

All widgets must have a unique name within Glade. If you cut a widget, and then paste the widget into your project, then the widget and all of the children of the widget keep their original names. If you copy a widget, or paste the widget multiple times into your project, then Glade generates new names for the widget copies.

### To Delete a Widget

To delete a widget from the parent without moving the widget to the clipboard, select the widget then choose Edit Delete .

### To Change a Property of a Widget

The property editor is used to edit the properties of a selected widget. To change a property of a widget, select the widget and then enter an appropriate value in one of the Property window's property fields.

## About &app;

&app; is maintained by the &app; developers and GNOME community volunteers. To find more information about &app;, please visit the &app; Web site.

To report a bug or make a suggestion regarding this application or this manual, you can submit them using bugzilla.

Another excellent source of information are the &app; user and developer mailing lists. In addition to subscribing, you might also want to browse the list archives, available via these same links.

This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found at this link, or in the file COPYING included with the source code of this program.