GtkIconInfo

typedef struct _GtkIconInfo GtkIconInfo;

Contient les informations trouvées lors d'une recherche d'icône dans un thème d'icônes.

GtkIconTheme

typedef struct _GtkIconTheme GtkIconTheme;

Agit comme une base de données d'informations au sujet d'un thème d'icônes. Normalement, vous recherchez un thème d'icônes pour un écran particulier en utilisant gtk_icon_theme_get_for_screen()et il contiendra les informations concernant le thème d'icônes courant pour cet écran, mais vous pouvez aussi créer un nouvel objet  GtkIconTheme  et définir le nom du thème d'icônes en utilisant explicitement gtk_icon_theme_set_custom_theme().

enum GtkIconLookupFlags

typedef enum
{
  GTK_ICON_LOOKUP_NO_SVG = 1 << 0,
  GTK_ICON_LOOKUP_FORCE_SVG = 1 << 1,
  GTK_ICON_LOOKUP_USE_BUILTIN = 1 << 2
} GtkIconLookupFlags;

Utilisé pour sépcifier les options dans  gtk_icon_theme_lookup_icon()

GTK_ICON_THEME_ERROR

#define GTK_ICON_THEME_ERROR gtk_icon_theme_error_quark ()

Le GQuark utiliser pour les erreurs de GtkIconThemeError .

enum GtkIconThemeError

typedef enum {
  GTK_ICON_THEME_NOT_FOUND,
  GTK_ICON_THEME_FAILED
} GtkIconThemeError;

Codes d'erreurs pour les opérations de  GtkIconTheme.

gtk_icon_theme_new ()

GtkIconTheme* gtk_icon_theme_new (void);

Crée un nouveau thème d'icônes. Les objets thème d'icônes sont utilisés pour rechercher une icône par son nom dans un thème d'icônes particulier. Généralementn vous voudrez utiliser  gtk_icon_theme_get_default() ou gtk_icon_theme_get_for_screen() plutôt que de créer un nouvel objet thème d'icônes pour scratch.

Depuis 2.4

gtk_icon_theme_get_default ()

GtkIconTheme* gtk_icon_theme_get_default (void);

Donne le thème d'icônes pour l'écran par défaut. Voir gtk_icon_theme_get_for_screen().

Depuis 2.4

gtk_icon_theme_get_for_screen ()

GtkIconTheme* gtk_icon_theme_get_for_screen (GdkScreen *screen);

Donne l'objet thème d'icônes associé à screen; si cette fonction n'a pas été appelée préalablement pour l' écran donné, un nouvel objet thème d'icônes sera créé et associé à l'écran. Les objets thème d'icône sont assez coûteux à créer, aussi appeler cette fonction est plus judicieux que d'appeler gtk_icon_theme_new() en configurant l'écran vous même; en utilisant cette fonction un seul objet thème d'icones sera partagé par les utilisateurs.

Depuis 2.4

gtk_icon_theme_set_screen ()

void gtk_icon_theme_set_screen (GtkIconTheme *icon_theme,
GdkScreen *screen);

Définit l'écran pour un thème d'icones; l'écran est utilisé pour détecter la configuration de thème d'icônes de l'utilisateur, qui peut être différent pour différents écrans.

Depuis 2.4

gtk_icon_theme_set_search_path ()

void 		gtk_icon_theme_set_search_path 			(GtkIconTheme *icon_theme,
								 const gchar *path[],
								 gint n_elements);

Définit le chemin de recherche d'un objet thème d'icônes. Pendant la recherche d'un thème d'icônes, GTK+ cherchera un sous-répertoire du  ou des répertoires de  path  avec le nom semblable à celuis du thème d'icônes.   (Themes from multiple of the path elements are combined to allow themes to be extended by adding icons in the user's home directory.)

De plus si une icône trouvée n'est pas trouvée dans le thème d'icônes courant ou dans le thème d'icônes par défaut, et si un fichier image avec le bon nom est trouvé directement dans un des élément de  path, alors cette image sera utilisée pour ce nom d'icône. (then that image will be used for the icon name. (C'est un dispositif d'héritage, et les nouvelles icônes seront placées dans le thème par défaut appelé  DEFAULT_THEME_NAME, plutôt que directement sur le chemin d'icône.

Depuis 2.4

gtk_icon_theme_get_search_path ()

void 			gtk_icon_theme_get_search_path 			(GtkIconTheme *icon_theme,
									 gchar **path[],
									 gint *n_elements);

Donne le chemin d'accès recherché à ce moment. Voir gtk_icon_theme_set_search_path().

Depuis 2.4

gtk_icon_theme_append_search_path ()

void 		gtk_icon_theme_append_search_path 		(GtkIconTheme *icon_theme,
								 const gchar *path);

Adjoins un répertoire au chemin d'accès de recherche. Voir gtk_icon_theme_set_search_path().

Depuis 2.4

gtk_icon_theme_prepend_search_path ()

void 			gtk_icon_theme_prepend_search_path 		(GtkIconTheme *icon_theme,
									 const gchar *path);

Depuis 2.4

gtk_icon_theme_set_custom_theme ()

void 		gtk_icon_theme_set_custom_theme 		(GtkIconTheme *icon_theme,
								 const gchar *theme_name);

Définit le nom du thème d'icônes que l'objet  GtkIconTheme utilise  de façon primordiale pour la configuration du système. Cette fonction ne peut pas être appelée sur des objets de thème d'icones retournés par gtk_icon_theme_get_default() et gtk_icon_theme_get_for_screen().

Depuis 2.4

gtk_icon_theme_has_icon ()

gboolean gtk_icon_theme_has_icon (GtkIconTheme *icon_theme,
const gchar *icon_name);

Contrôle si un thème d'icônes inclut une icône d'un nom particulier.

Depuis 2.4

gtk_icon_theme_lookup_icon ()

GtkIconInfo* 		gtk_icon_theme_lookup_icon 		(GtkIconTheme *icon_theme,
								 const gchar *icon_name,
								 gint size,
								 GtkIconLookupFlags flags);

Recherche une icône nommée et retourne une structure contenant des informations comme le nom du fichier de l'icône. L'icône peut  être traduite alors en pixbuf en utilisant  gtk_icon_info_load_icon(). (gtk_icon_theme_load_icon() combine ces deux étapes si vous n'avez besoin que du pixbuf.)

Depuis 2.4

gtk_icon_theme_load_icon ()

GdkPixbuf* 		gtk_icon_theme_load_icon 		(GtkIconTheme *icon_theme,
								 const gchar *icon_name,
								 gint size,
								 GtkIconLookupFlags flags,
								 GError **error);

Notez que vous voulez sans doute  faire attention au changements de thème d'icône et mettre à jour l'icône.  Cela se fait généralement en connectant le signal  de  GtkWidget::style-set . Si pour une raison ou une autre vous ne voulez pas mettre à jour l'icône quand le thème d'icône change, vous devez penser à utiliser  gdk_pixbuf_copy() pour faire une copie privée du pixbuf returné par cette fonction. Sinon GTK+ pourrait conserver  l'ancien thème d'icône chargé, ce qui serait une perte de mémoire.

Depuis 2.4

gtk_icon_theme_list_icons ()

GList* 			gtk_icon_theme_list_icons 		(GtkIconTheme *icon_theme, 
								 const gchar *context);

Depuis 2.4

gtk_icon_theme_get_icon_sizes ()

gint* gtk_icon_theme_get_icon_sizes (GtkIconTheme *icon_theme,
const gchar *icon_name);

Retourne un tableau d'entiers decrivant les tailles auxquelles l'icône est valide sans la redimensionner. Une taille de -1 signifie que l'icône est dans un format redimensionnable. Le tableau est terminé par zéro.

Depuis 2.6

gtk_icon_theme_get_example_icon_name ()

char* 			gtk_icon_theme_get_example_icon_name		(GtkIconTheme *icon_theme);

Donne le nom d'une icône qui est représentative du thème courant (par exemple, pour utiliser pour la présentation d'une liste de thèmes à l'utilisateur).

Depuis 2.4

gtk_icon_theme_rescan_if_needed ()

gboolean 		gtk_icon_theme_rescan_if_needed 		(GtkIconTheme *icon_theme);

Depuis 2.4

gtk_icon_theme_add_builtin_icon ()

void 		gtk_icon_theme_add_builtin_icon 		(const gchar *icon_name,
								 gint size,
								 GdkPixbuf *pixbuf);

Enregistre l'icône intégrée pour le thème d'icônes consulté. L'idée des icônes intégrées est de fournir une application ou une bibliothèque qui utilise des icônes de thème pour fonctionner, exigeant  des fichiers pour être présent dans le système de fichiers. (?) Par exemple, les images par défaut pour toutes les stock icône de GTK+ sont enregistrées en tant qu'icônes intégrées.  

En général, si vous utilisez  gtk_icon_theme_add_builtin_icon() vous pouvez aussi installer l'icône dans le thème d'icône, de telle sorte que l'icône soit facilement  disponible.

Cette fonction sera généralement utilisée avec des  pixbufs chargés via gdk_pixbuf_new_from_inline().

Depuis 2.4

gtk_icon_info_copy ()

GtkIconInfo* 		gtk_icon_info_copy 		(GtkIconInfo *icon_info);

Fait une copie d' un GtkIconInfo.

Depuis 2.4

gtk_icon_info_free ()

void gtk_icon_info_free (GtkIconInfo *icon_info);

Libère un GtkIconInfo  et les informations associées.

Depuis 2.4

gtk_icon_info_get_base_size ()

gint 		gtk_icon_info_get_base_size 		(GtkIconInfo *icon_info);

Donne la taille de base pour une icône.La taille de base est la taille pour l'icône qui a été définie par le créateur du thème d'icônes; Il peut être différent de la taille de l'image; un exemple de cela sont les petites icônes emblèmes qui peuvent être attachées à de plus grandes icônes. Ces icônes ont la même taille de base que les plus grandes icônes auxquelles elles sont attachées.

Depuis 2.4

gtk_icon_info_get_filename ()

const	 	gchar* gtk_icon_info_get_filename 		(GtkIconInfo *icon_info);

Donne le nom de fichier de l'icône. Si le flag  GTK_ICON_LOOKUP_USE_BUILTIN a été passé à  gtk_icon_theme_lookup_icon(), il ne peut y avoir aucun nom de fichier si une icône intégrée est retournée; dans se cas, vous devez utiliser  gtk_icon_info_get_builtin_pixbuf().

Depuis 2.4

gtk_icon_info_get_builtin_pixbuf ()

GdkPixbuf* gtk_icon_info_get_builtin_pixbuf (GtkIconInfo *icon_info);

Donne l'image intégrée pour cette icône, s'il y en a une. Pour permettre à GTK+ d'utiliser les images d'icônes intégrées, vous devez passer  GTK_ICON_LOOKUP_USE_BUILTIN à gtk_icon_theme_lookup_icon().

Depuis 2.4

gtk_icon_info_load_icon ()

GdkPixbuf* 		gtk_icon_info_load_icon 		(GtkIconInfo *icon_info,
								 GError **error);

Traduit une icône préalablement recherchée dans une thème d'icônes en utilisant gtk_icon_theme_lookup_icon(); la taille se basera sur la taille passée à  gtk_icon_theme_lookup_icon(). Notez que me pixbufrésultant peut ne pas être exactement de cette taille; un thème d'icônes peut avoir des icônes qui diffèrent légèrement de leur taille normale, et de plus GTK+ évitera de redimensionner des icones qu'il onsidèrera suffisamment  proche de la taille demandée ou pour lesquelles l'image source devrait être redimesionnée  too far. (Ceci préserve la netteté.)

Depuis 2.4

gtk_icon_info_set_raw_coordinates ()

void 		gtk_icon_info_set_raw_coordinates 		(GtkIconInfo *icon_info,
								 gboolean raw_coordinates);

Definit si les coordonnées retournées par gtk_icon_info_get_embedded_rect() et gtk_icon_info_get_attach_points() doivent être retournées dans leur forme originale comme elles sont définies dans le thèmes d'icônes, à la place des dimensions correspondant au pixbuf retourné par  gtk_icon_info_load_icon().

Les coordonnées brutes sont quelque peu étranges; elles sont définies pour être en accord avec les pixmap non redimensionnables pour les icônes PNG et SPM, mais pour les icônes SVG, elles sont dans un espace de  coordonnées 1000x1000  qui est mis à l'échelle de la taille finale de l'icône (?) Vous pouvez déterminer si l'icône est une icône SVG en utilisant  gtk_icon_info_get_filename(), et voir si  elle est  non-NULL et se terminant par '.svg'.

Cette fonction est fournie principalement pour apporter un contexte de compatibilité pour API plus ancien , et n'est pas prévue pour être utile pour les applications.

Depuis 2.4

gtk_icon_info_get_embedded_rect ()

gboolean 		gtk_icon_info_get_embedded_rect 		(GtkIconInfo *icon_info,
									 GdkRectangle *rectangle);

Donne les coordonnées d'un rectangle dans l'icône ce qui peut être utile pour afficher des informations comme un apperçu du contenu d'un fichier texte. Voir gtk_icon_info_set_raw_coordinates() pour plus d'informations au sujet du système de coordonnées.

Depuis 2.4

gtk_icon_info_get_attach_points ()

gboolean 		gtk_icon_info_get_attach_points 		(GtkIconInfo *icon_info,
									 GdkPoint **points,
									 gint *n_points);

Depuis 2.4

gtk_icon_info_get_display_name ()

const gchar* 			gtk_icon_info_get_display_name 			(GtkIconInfo *icon_info);

Donne ne nom affiché pour une icône. Un nom affiché est une chaîne qui est utilisée à la place du nom de l'icône dans un contexte utilisateur visible comme une liste d'icônes.

Depuis 2.4

Le signal "changed" 

void 		user_function 		(GtkIconTheme *icon_theme,
					 gpointer user_data) : Run Last (exécuté dernier)

Emis quand le thème d'icônes courant est permuté ou quand GTK+ détecte qu'un changement  est survenu dans le contenu du thèmes d'icônes courant.