# MATE UI Library Reference Manual

for libmateui &version;

## MATE UI Library (libmateui)

### Initialization and Session Management

This section includes functions and parameters used to initialise MATE applications which use libmateui and to handle interactions with whatever session manager is running when the application starts up.

A typical application will call `mate_program_init` (from `libmate/libmate.h`) with parameters from the mate-ui-init section and will then possibly have further interactions (beyond the initial default setup performed by `mate_program_init`) with the session manager.

&libmateui-mate-ui-init; &libmateui-MateClient;

### Application Management

After initializing libmateui, a typical application will need to create its main application window, possibly with some non-standard decorations, create its credit (or About) box and get ready to enter the main loop. The functions in this section provide the facility for carrying out all of these operations.

&libmateui-MateApp; &libmateui-MateAppBar; &libmateui-mate-app-helper; &libmateui-MateMultiScreen; &libmateui-MateAuthentication; &libmateui-MatePassword;

### Druids

Druids (sometimes called Wizards on other systems) are a series of dialog boxes that lead the user through a task that is serial in nature (that is, it has a natural beginning, sequence through the pages and an end).

Some applications (for example MATE Lokkit -- for setting up simple firewall settings) are purely a series of screens that extract some information from the user and then performs an action based on that data. Other applications may be more traditional in nature, however they may wish to run the user through a series of question the first time they run the application; such as to set things up correctly or to import settings from another program. Both these types of programs can use the various druid functions to make their implementation easier.

&libmateui-MateDruid; &libmateui-MateDruidPage; &libmateui-MateDruidPageEdge; &libmateui-MateDruidPageStandard;

### Miscellaneous Widgets

&libmateui-MateDateEdit; &libmateui-MateHRef; &libmateui-MateIce; &libmateui-MateIconEntry; &libmateui-MateIconLookup; &libmateui-MateIconSelection; &libmateui-MateThumbnail;

### Miscellaneous Utility Functions and Macros

This section collects together a number of useful auxillary functions that do not really fit into any other place in the hierarchy. These include the standard constants for icons, some standard type macros, function templates and functions for loading images.

&libmateui-mate-stock-icons; &libmateui-matetypebuiltins; &libmateui-mate-types; &libmateui-mate-uidefs; &libmateui-mate-vfs-util;

### Deprecated Modules

&libmateui-MateAbout; &libmateui-mate-app-util; &libmateui-MateColorPicker; &libmateui-MateDialog; &libmateui-mate-dialog-util; &libmateui-MateEntry; &libmateui-MateFileEntry; &libmateui-MateFontPicker; &libmateui-MateIconList; &libmateui-MateIconItem; &libmateui-MateIconTheme; &libmateui-MateMDI; &libmateui-MateMDIChild; &libmateui-MateMDIGenericChild; &libmateui-mate-mdi-session; &libmateui-MateMessageBox; &libmateui-MatePixmap; &libmateui-MatePixmapEntry; &libmateui-mate-popup-menu; &libmateui-MatePropertyBox; &libmateui-MateScores; &libmateui-MateThemeFile; &libmateui-mate-window; &libmateui-mate-window-icon;

### Object Hierarchy

&libmateui-object-index;

Index

Index of deprecated symbols

Index of new symbols in 2.2

Index of new symbols in 2.4

Index of new symbols in 2.6

Index of new symbols in 2.8

Index of new symbols in 2.10

Index of new symbols in 2.12

Index of new symbols in 2.14

Index of new symbols in 2.16