# GQ Manual

Sven Herzberg

    	    herzi@gnome.org

2006 2007 Sven Herzberg
GNOME Documentation Project
0.1
2006-12-20
Initial Revision (including Themeing Instructions)
0.2
2007-01-15
Added Section about the Browser Page

The GQ Manual

## Introduction

### Not finished

This part isn't written yet. You can contribute this chapter.

## Browsing and Modifing LDAP Directories

### Structure of the Browser Page

The browser page is split into two parts:

1. The LDAP Tree (on the left side)

2. The Property Browser (on the right side)

### Using the LDAP Tree

This part isn't written yet. You can contribute this chapter.

### Using the Property Browser

The property editor is one of the most powerful interfaces that GQ provides. Here's a small overview:

- Typed Editors

- Single or Multi-Line Input

- Easily edit multi value properties

#### Typed Editors

GQ provides different editor types for attributes. You can easily select the desired editor by right-clicking on the attribute name and then choosing a type from "Change Display Type".

Currently available types include:

- Text Entry

- Password Entry

- Image

- Object Class

- Number

- Date

- Time

#### Single and Multi-Line Input

When editing text properties of values, you sometimes want to edit larger parts of text. Then you can easily switch from single line entries to multiple lines by using the second toolbar button in the property editor.

#### Multi-Value Properties

GQ also contains very good support for properties that consist of multiple values. You can easily add new values by pressing the down arrow next to the editor fields.

## GTK+ Themes and GQ

### Colors

GQ uses colors in several parts of the user interface. This part is supposed to tell you how to customize these parts.

#### GQ Item Browser

The item browser uses colors to highlight several classes if attributes:

- Extensible: Attributes that are added to an entry of the objectClass and that are not specified by a syntax are highlighted in purple.

- Delete: Attributes that are supposed to be deleted by an update are highlighted in orange.

- Required: Attributes that are required by a class are highlighted in blue.

- Unspecified: Attributes that aren't defined in the schema of its entry's classes are highlighted red.

These colors can be overwritten pretty easily: you just need to specify these colors for the class GqInputForm:

- Extensible: "extensible-color"

- Delete: "delete-color"

- Required: "required-color"

- unspecified: "additional-color"

### Stock Images

GQ uses a lot of images in the application. These can be replaced by images from an icon theme.

#### LDAP Tree

GQ uses some icons the the trees that are taken from GTK+. These are:

- GTK_STOCK_CONNECT

- GTK_STOCK_DISCONNECT

Icons used for the visualization of LDAP entries are these:

- folder (according to icon-naming-spec)

- ldap-group

- ldap-person

- ldap-organization