|  |  |  | GNOME UI Library Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
#include <libgnomeui/libgnomeui.h>
                    GnomeThemeFile;
void                (*GnomeThemeFileSectionFunc)        (GnomeThemeFile *df,
                                                         const char *name,
                                                         gpointer data);
enum                GnomeThemeFileParseError;
void                (*GnomeThemeFileLineFunc)           (GnomeThemeFile *df,
                                                         const char *key,
                                                         const char *locale,
                                                         const char *value,
                                                         gpointer data);
GnomeThemeFile *    gnome_theme_file_new_from_string    (char *data,
                                                         GError **error);
char *              gnome_theme_file_to_string          (GnomeThemeFile *df);
void                gnome_theme_file_free               (GnomeThemeFile *df);
void                gnome_theme_file_foreach_section    (GnomeThemeFile *df,
                                                         GnomeThemeFileSectionFunc func,
                                                         gpointer user_data);
void                gnome_theme_file_foreach_key        (GnomeThemeFile *df,
                                                         const char *section,
                                                         gboolean include_localized,
                                                         GnomeThemeFileLineFunc func,
                                                         gpointer user_data);
gboolean            gnome_theme_file_get_raw            (GnomeThemeFile *df,
                                                         const char *section,
                                                         const char *keyname,
                                                         const char *locale,
                                                         char **val);
gboolean            gnome_theme_file_get_integer        (GnomeThemeFile *df,
                                                         const char *section,
                                                         const char *keyname,
                                                         int *val);
gboolean            gnome_theme_file_get_string         (GnomeThemeFile *df,
                                                         const char *section,
                                                         const char *keyname,
                                                         char **val);
gboolean            gnome_theme_file_get_locale_string  (GnomeThemeFile *df,
                                                         const char *section,
                                                         const char *keyname,
                                                         char **val);
#define             GNOME_THEME_FILE_PARSE_ERROR
GQuark              gnome_theme_file_parse_error_quark  (void);
typedef struct _GnomeThemeFile GnomeThemeFile;
GnomeThemeFile is deprecated and should not be used in newly-written code.
A GnomeThemeFile contains information about the number of sections, pointers to the sections and information about the current locale.
void (*GnomeThemeFileSectionFunc) (GnomeThemeFile *df,const char *name,gpointer data);
GnomeThemeFileSectionFunc is deprecated and should not be used in newly-written code.
typedef enum 
{
  GNOME_THEME_FILE_PARSE_ERROR_INVALID_SYNTAX,
  GNOME_THEME_FILE_PARSE_ERROR_INVALID_ESCAPES,
  GNOME_THEME_FILE_PARSE_ERROR_INVALID_CHARS
} GnomeThemeFileParseError;
GnomeThemeFileParseError is deprecated and should not be used in newly-written code.
void (*GnomeThemeFileLineFunc) (GnomeThemeFile *df,const char *key,const char *locale,const char *value,gpointer data);
GnomeThemeFileLineFunc is deprecated and should not be used in newly-written code.
GnomeThemeFile * gnome_theme_file_new_from_string (char *data,GError **error);
gnome_theme_file_new_from_string is deprecated and should not be used in newly-written code.
Creates a GnomeThemeFile from the data string passed.
| 
 | the string used to create a GnomeThemeFile. | 
| 
 | location to store the error occuring, or NULL to ignore errors | 
| Returns : | a GnomeThemeFile. | 
Since 2.2
char *              gnome_theme_file_to_string          (GnomeThemeFile *df);
gnome_theme_file_to_string is deprecated and should not be used in newly-written code.
This function retrieves the string representing the GnomeThemeFile.
| 
 | A GnomeThemeFile | 
| Returns : | a char *. | 
Since 2.2
void                gnome_theme_file_free               (GnomeThemeFile *df);
gnome_theme_file_free is deprecated and should not be used in newly-written code.
Frees the GnomeThemeFile structure.
| 
 | a GnomeThemeFile. | 
Since 2.2
void gnome_theme_file_foreach_section (GnomeThemeFile *df,GnomeThemeFileSectionFunc func,gpointer user_data);
gnome_theme_file_foreach_section is deprecated and should not be used in newly-written code.
Calls func for each section in the GnomeThemeFile with user_data.
| 
 | a GnomeThemeFile. | 
| 
 | a GnomeThemeFileSectionFunc | 
| 
 | a pointer to the user data. | 
Since 2.2
void gnome_theme_file_foreach_key (GnomeThemeFile *df,const char *section,gboolean include_localized,GnomeThemeFileLineFunc func,gpointer user_data);
gnome_theme_file_foreach_key is deprecated and should not be used in newly-written code.
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.
| 
 | a GnomeThemeFile. | 
| 
 | name of the section | 
| 
 | a boolean value | 
| 
 | a GnomeThemeFileLineFunc. | 
| 
 | a pointer to user_data. | 
Since 2.2
gboolean gnome_theme_file_get_raw (GnomeThemeFile *df,const char *section,const char *keyname,const char *locale,char **val);
gnome_theme_file_get_raw is deprecated and should not be used in newly-written code.
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.
| 
 | A GnomeThemeFile. | 
| 
 | the string representing the section name | 
| 
 | the string representing the key name. | 
| 
 | the string representing the locale. | 
| 
 | a char**. | 
| Returns : | TRUE if section and line were found in the GnomeThemeFile, FALSE otherwise. | 
Since 2.2
gboolean gnome_theme_file_get_integer (GnomeThemeFile *df,const char *section,const char *keyname,int *val);
gnome_theme_file_get_integer is deprecated and should not be used in newly-written code.
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.
| 
 | a GnomeThemeFile. | 
| 
 | the section name. | 
| 
 | the key name. | 
| 
 | an int*. | 
| Returns : | TRUEif gnome_theme_file_get_raw returnsTRUE,FALSEotherwise. | 
Since 2.2
gboolean gnome_theme_file_get_string (GnomeThemeFile *df,const char *section,const char *keyname,char **val);
gnome_theme_file_get_string is deprecated and should not be used in newly-written code.
This function calls gnome_theme_file_get_raw() with the parameters and returns the 
boolean value.
| 
 | A GnomeThemeFile. | 
| 
 | the section name. | 
| 
 | the key name. | 
| 
 | a char**. | 
| Returns : | a gboolean value. | 
Since 2.2
gboolean gnome_theme_file_get_locale_string (GnomeThemeFile *df,const char *section,const char *keyname,char **val);
gnome_theme_file_get_locale_string is deprecated and should not be used in newly-written code.
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.
| 
 | A GnomeThemeFile | 
| 
 | the section name. | 
| 
 | the keyname. | 
| 
 | a char **. | 
| Returns : | a gboolean value. | 
Since 2.2
#define GNOME_THEME_FILE_PARSE_ERROR gnome_theme_file_parse_error_quark()
GNOME_THEME_FILE_PARSE_ERROR is deprecated and should not be used in newly-written code.