| MATE UI Library Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | ||||
#include <libmateui/libmateui.h>
MateThemeFile;
void (*MateThemeFileSectionFunc) (MateThemeFile *df,
const char *name,
gpointer data);
enum MateThemeFileParseError;
void (*MateThemeFileLineFunc) (MateThemeFile *df,
const char *key,
const char *locale,
const char *value,
gpointer data);
MateThemeFile * mate_theme_file_new_from_string (char *data,
GError **error);
char * mate_theme_file_to_string (MateThemeFile *df);
void mate_theme_file_free (MateThemeFile *df);
void mate_theme_file_foreach_section (MateThemeFile *df,
MateThemeFileSectionFunc func,
gpointer user_data);
void mate_theme_file_foreach_key (MateThemeFile *df,
const char *section,
gboolean include_localized,
MateThemeFileLineFunc func,
gpointer user_data);
gboolean mate_theme_file_get_raw (MateThemeFile *df,
const char *section,
const char *keyname,
const char *locale,
char **val);
gboolean mate_theme_file_get_integer (MateThemeFile *df,
const char *section,
const char *keyname,
int *val);
gboolean mate_theme_file_get_string (MateThemeFile *df,
const char *section,
const char *keyname,
char **val);
gboolean mate_theme_file_get_locale_string (MateThemeFile *df,
const char *section,
const char *keyname,
char **val);
#define MATE_THEME_FILE_PARSE_ERROR
GQuark mate_theme_file_parse_error_quark (void);
typedef struct _MateThemeFile MateThemeFile;
MateThemeFile is deprecated and should not be used in newly-written code.
A MateThemeFile contains information about the number of sections, pointers to the sections and information about the current locale.
void (*MateThemeFileSectionFunc) (MateThemeFile *df,const char *name,gpointer data);
MateThemeFileSectionFunc is deprecated and should not be used in newly-written code.
|
|
|
|
|
typedef enum
{
MATE_THEME_FILE_PARSE_ERROR_INVALID_SYNTAX,
MATE_THEME_FILE_PARSE_ERROR_INVALID_ESCAPES,
MATE_THEME_FILE_PARSE_ERROR_INVALID_CHARS
} MateThemeFileParseError;
MateThemeFileParseError is deprecated and should not be used in newly-written code.
void (*MateThemeFileLineFunc) (MateThemeFile *df,const char *key,const char *locale,const char *value,gpointer data);
MateThemeFileLineFunc is deprecated and should not be used in newly-written code.
|
|
|
|
|
|
|
|
|
MateThemeFile * mate_theme_file_new_from_string (char *data,GError **error);
mate_theme_file_new_from_string is deprecated and should not be used in newly-written code.
Creates a MateThemeFile from the data string passed.
|
the string used to create a MateThemeFile. |
|
location to store the error occuring, or NULL to ignore errors |
Returns : |
a MateThemeFile. |
Since 2.2
char * mate_theme_file_to_string (MateThemeFile *df);
mate_theme_file_to_string is deprecated and should not be used in newly-written code.
This function retrieves the string representing the MateThemeFile.
|
A MateThemeFile |
Returns : |
a char *. |
Since 2.2
void mate_theme_file_free (MateThemeFile *df);
mate_theme_file_free is deprecated and should not be used in newly-written code.
Frees the MateThemeFile structure.
|
a MateThemeFile. |
Since 2.2
void mate_theme_file_foreach_section (MateThemeFile *df,MateThemeFileSectionFunc func,gpointer user_data);
mate_theme_file_foreach_section is deprecated and should not be used in newly-written code.
Calls func for each section in the MateThemeFile with user_data.
|
a MateThemeFile. |
|
a MateThemeFileSectionFunc |
|
a pointer to the user data. |
Since 2.2
void mate_theme_file_foreach_key (MateThemeFile *df,const char *section,gboolean include_localized,MateThemeFileLineFunc func,gpointer user_data);
mate_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 MateThemeFile. |
|
name of the section |
|
a boolean value |
|
a MateThemeFileLineFunc. |
|
a pointer to user_data. |
Since 2.2
gboolean mate_theme_file_get_raw (MateThemeFile *df,const char *section,const char *keyname,const char *locale,char **val);
mate_theme_file_get_raw is deprecated and should not be used in newly-written code.
Searches section name and line in the MateThemeFile data structure.
If found, sets the val to value field in MateThemeFileLine and returns a boolean value.
|
A MateThemeFile. |
|
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 MateThemeFile, FALSE otherwise. |
Since 2.2
gboolean mate_theme_file_get_integer (MateThemeFile *df,const char *section,const char *keyname,int *val);
mate_theme_file_get_integer is deprecated and should not be used in newly-written code.
This function calls mate_theme_file_get_raw() with the parameters. If mate_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 MateThemeFile. |
|
the section name. |
|
the key name. |
|
an int*. |
Returns : |
TRUE if mate_theme_file_get_raw returns TRUE, FALSE otherwise.
|
Since 2.2
gboolean mate_theme_file_get_string (MateThemeFile *df,const char *section,const char *keyname,char **val);
mate_theme_file_get_string is deprecated and should not be used in newly-written code.
This function calls mate_theme_file_get_raw() with the parameters and returns the
boolean value.
|
A MateThemeFile. |
|
the section name. |
|
the key name. |
|
a char**. |
Returns : |
a gboolean value. |
Since 2.2
gboolean mate_theme_file_get_locale_string (MateThemeFile *df,const char *section,const char *keyname,char **val);
mate_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 mate_theme_file_get_raw() with the
parameters and returns the boolean value obtained.
|
A MateThemeFile |
|
the section name. |
|
the keyname. |
|
a char **. |
Returns : |
a gboolean value. |
Since 2.2
#define MATE_THEME_FILE_PARSE_ERROR mate_theme_file_parse_error_quark()
MATE_THEME_FILE_PARSE_ERROR is deprecated and should not be used in newly-written code.