GnomeThemeFile

typedef struct _GnomeThemeFile GnomeThemeFile;

A GnomeThemeFile contains information about the number of sections, pointers to the sections and information about the current locale.

GnomeThemeFileSectionFunc ()

void                (*GnomeThemeFileSectionFunc)        (GnomeThemeFile *df,
                                                         const char *name,
                                                         gpointer data);

enum GnomeThemeFileParseError

typedef enum 
{
  GNOME_THEME_FILE_PARSE_ERROR_INVALID_SYNTAX,
  GNOME_THEME_FILE_PARSE_ERROR_INVALID_ESCAPES,
  GNOME_THEME_FILE_PARSE_ERROR_INVALID_CHARS
} GnomeThemeFileParseError;

GnomeThemeFileLineFunc ()

void                (*GnomeThemeFileLineFunc)           (GnomeThemeFile *df,
                                                         const char *key,
                                                         const char *locale,
                                                         const char *value,
                                                         gpointer data);

gnome_theme_file_new_from_string ()

GnomeThemeFile *    gnome_theme_file_new_from_string    (char *data,
                                                         GError **error);

Creates a GnomeThemeFile from the data string passed.

Since 2.2

gnome_theme_file_to_string ()

char *              gnome_theme_file_to_string          (GnomeThemeFile *df);

This function retrieves the string representing the GnomeThemeFile.

Since 2.2

gnome_theme_file_free ()

void                gnome_theme_file_free               (GnomeThemeFile *df);

Frees the GnomeThemeFile structure.

Since 2.2

gnome_theme_file_foreach_section ()

void                gnome_theme_file_foreach_section    (GnomeThemeFile *df,
                                                         GnomeThemeFileSectionFunc func,
                                                         gpointer user_data);

Calls func for each section in the GnomeThemeFile with user_data.

Since 2.2

gnome_theme_file_foreach_key ()

void                gnome_theme_file_foreach_key        (GnomeThemeFile *df,
                                                         const char *section,
                                                         gboolean include_localized,
                                                         GnomeThemeFileLineFunc func,
                                                         gpointer user_data);

Looks for the section section_name. If found, this function calls func for each line in the section with fields of line and user_data.

Since 2.2

gnome_theme_file_get_raw ()

gboolean            gnome_theme_file_get_raw            (GnomeThemeFile *df,
                                                         const char *section,
                                                         const char *keyname,
                                                         const char *locale,
                                                         char **val);

Searches section name and line in the GnomeThemeFile data structure. If found, sets the val to value field in GnomeThemeFileLine and returns a boolean value.

Since 2.2

gnome_theme_file_get_integer ()

gboolean            gnome_theme_file_get_integer        (GnomeThemeFile *df,
                                                         const char *section,
                                                         const char *keyname,
                                                         int *val);

This function calls gnome_theme_file_get_raw() with the parameters. If gnome_theme_file_get_raw returns TRUE, then converts the value string filled in by the function to an integer and writes it in val.

Since 2.2

gnome_theme_file_get_string ()

gboolean            gnome_theme_file_get_string         (GnomeThemeFile *df,
                                                         const char *section,
                                                         const char *keyname,
                                                         char **val);

This function calls gnome_theme_file_get_raw() with the parameters and returns the boolean value.

Since 2.2

gnome_theme_file_get_locale_string ()

gboolean            gnome_theme_file_get_locale_string  (GnomeThemeFile *df,
                                                         const char *section,
                                                         const char *keyname,
                                                         char **val);

Calculates the locale if the current_locale field of df is NULL. Then calls gnome_theme_file_get_raw() with the parameters and returns the boolean value obtained.

Since 2.2

GNOME_THEME_FILE_PARSE_ERROR

#define GNOME_THEME_FILE_PARSE_ERROR gnome_theme_file_parse_error_quark()

gnome_theme_file_parse_error_quark ()

GQuark              gnome_theme_file_parse_error_quark  (void);

This function gets a GQuark representing the error string.

Since 2.2