GtkIconSource

typedef struct _GtkIconSource GtkIconSource;

GtkIconFactory

typedef struct _GtkIconFactory GtkIconFactory;

GtkIconSet

typedef struct _GtkIconSet GtkIconSet;

enum GtkIconSize

typedef enum
{
  GTK_ICON_SIZE_INVALID,
  GTK_ICON_SIZE_MENU,
  GTK_ICON_SIZE_SMALL_TOOLBAR,
  GTK_ICON_SIZE_LARGE_TOOLBAR,
  GTK_ICON_SIZE_BUTTON,
  GTK_ICON_SIZE_DND,
  GTK_ICON_SIZE_DIALOG
} GtkIconSize;

gtk_icon_source_copy ()

GtkIconSource* 		gtk_icon_source_copy 		(const GtkIconSource *source);

Créé une copie de  source; plus utile pour les raccourcis de langage.

gtk_icon_source_free ()

void 		gtk_icon_source_free 		(GtkIconSource *source);

gtk_icon_factory_add ()

void 		gtk_icon_factory_add 		(GtkIconFactory *factory,
						 const gchar *stock_id,
						 GtkIconSet *icon_set);

gtk_icon_factory_add_default ()

void 		gtk_icon_factory_add_default 		(GtkIconFactory *factory);

Ajoute une fabrique d'icône à la liste des fabriques d'icônes recherchées par gtk_style_lookup_icon_set(). Cela signifie que, par exemple, gtk_image_new_from_stock() pourra trouver des icônes dans factory. Il y a généralement une fabrique d'icône ajoutée pour chaque bibliothèque ou application qui arrive avec des icônes. Les fabriques d'icônes par défaut peuvent être surclassées par des thèmes.

gtk_icon_factory_lookup ()

GtkIconSet* 		gtk_icon_factory_lookup 		(GtkIconFactory *factory,
								 const gchar *stock_id);

Recherche stock_id  dans la fabrique d'icône, retournant une configuration d'icône s'il est trouvé, autrement NULL. Pour l'affichage à l'utilisateur, vous devez utiliser gtk_style_lookup_icon_set()  sur le  GtkStyle pour le  widget qui affiche l'icône, à la place d'utiliser cette fonction directement,  de sorte que les thèmes soient pris en considération.

gtk_icon_factory_lookup_default ()

GtkIconSet* 		gtk_icon_factory_lookup_default 		(const gchar *stock_id);

Cherche une icône dans la liste des fabriques d'icônes par défaut. Pour l'affichage à l'utilisateur, vous devez utiliser  gtk_style_lookup_icon_set() sur GtkStyle pour le widget qui affichera l'îcone, à la place d'utiliser cette fonction directement,  de sorte que les thèmes soient pris en considération.

gtk_icon_factory_new ()

GtkIconFactory* 		gtk_icon_factory_new 		(void);

gtk_icon_factory_remove_default ()

void 		gtk_icon_factory_remove_default 		(GtkIconFactory *factory);

gtk_icon_set_add_source ()

void 		gtk_icon_set_add_source 		(GtkIconSet *icon_set,
							 const GtkIconSource *source);

Les configurations d'icônes ont des listes de  GtkIconSource  qu'elles  utilisent comme icônes de base pour traduire les icônes dans des états différents et des tailles différentes. Les icônes sont dimensionnées, configurées pour paraître inactives, etc. dans gtk_icon_set_render_icon(), mais GtkIconSet a besoin d'images de base pour travailler. Les images de base et la façon de les utiliser est décrit par un  GtkIconSource.

Cette fonction copie source, de sorte que vous pouvez réutiliser la même source immédiatement sans affecter la configuration d'icône.

Un exemple d'utilisation de cette fonction : une icône "Page précédente" d'un explorateur Web peut pointer dans différentes positions en Arabe ou en Français; elle peut avoir une autre apparence quand elle est désactivée; et elle peut changer de taille suivant le mode de la barre d'outils (petites/ grandes icônes). Ainsi une seule configuration d'icônes contient toutes ces variantes d'icônes, et vous peuvez ajouter une source séparée à chacune.

 Vous devriez presque toujours ajouter une source d'icône par défaut avec tous les  champs génériques, elles seront utilisées pour revenir  en arrière si aucune source spécifique ne correspond. GtkIconSetpréfère toujours plus de sources d'icônes spécifiques à plus de sources d'icônes génériques. L'ordre dans lequel vous ajoutez les sources à la configuration d'icône n'importe pas.

gtk_icon_set_new_from_pixbuf()crée une nouvelle configuration d'icône avec une source d'icône par défaut basé sur un pixbuf donné.

gtk_icon_set_copy ()

GtkIconSet* 		gtk_icon_set_copy 		(GtkIconSet *icon_set);

Copie  icon_set par valeur.

gtk_icon_set_new ()

GtkIconSet* 		gtk_icon_set_new 		(void);

Habituellement vous utiliserez  gtk_widget_render_icon() à la place d'utiliser  GtkIconSet directement.Le cas où on utilisere  GtkIconSet diretement est lorsqu'on crée des configurations d'icônes spécifiques pour les mettre dans un  GtkIconFactory.

gtk_icon_set_new_from_pixbuf ()

GtkIconSet* 		gtk_icon_set_new_from_pixbuf 		(GdkPixbuf *pixbuf);

Crée un nouveau  GtkIconSet avec pixbuf comme image par défaut /image retour en arrière. Si vous n'ajoutez pas de GtkIconSource additionnel à la configuration d'icônes, toutes les variantes de l'icône seront créées à partir de pixbuf, en utilisant les dimensions, la pixelisation, etc. requis pour ajuster la taille de l'icône ou lui donner une apparence inactive / pré-allumée.

gtk_icon_set_ref ()

GtkIconSet* 		gtk_icon_set_ref 		(GtkIconSet *icon_set);

Incrémente le compteur de référence sur  icon_set.

gtk_icon_set_render_icon ()

GdkPixbuf* 		gtk_icon_set_render_icon 		(GtkIconSet *icon_set,
								 GtkStyle *style,
								 GtkTextDirection direction,
								 GtkStateType state,
								 GtkIconSize size,
								 GtkWidget *widget,
								 const char *detail);

Rend une icône en utilisant  gtk_style_render_icon(). Dans la plus part des cas,  gtk_widget_render_icon()est mieux, puisqu'il fournit  automatiquement  la plus part des arguments de  configuration du widget courant. Cette fonction ne retourne jamais  NULL; si l'icône ne peut pas être rendue (peut-être parce que le chargement d'un fichier image échoue), une icône  "image manquante" par défaut sera retournée à la place.

gtk_icon_set_unref ()

void 		gtk_icon_set_unref 		(GtkIconSet *icon_set);

Décrémente le conteur de référence sur  icon_set, et libère la mémoire si le conteur de référence est à 0.

gtk_icon_size_lookup ()

gboolean gtk_icon_size_lookup (GtkIconSize size,
gint *width,
gint *height);

Déduit la taille en pixels d'une icône à partir de sa taille sémantique qui peut être modifiée en fonction des  préférences de l'utilisateur pour le  GtkSettings par défaut. (Voir gtk_icon_size_lookup_for_settings().) Habituellement size serait GTK_ICON_SIZE_MENU, GTK_ICON_SIZE_BUTTON, etc. Cette fonction normalement n'est pas utile, gtk_widget_render_icon()est la solution d'usage pour obtenir une icône à afficher, puis elle observe  juste la taille du pixbuf rendu. Il peut ne pas correspondre à la largeur/ hauteur retournée par  gtk_icon_size_lookup(), parce que les thèmes ne sont pas libres de rendre le pixbuf comme ils le veulent, y compris changer la taille d'usage. (?)

gtk_icon_size_lookup_for_settings ()

gboolean 		gtk_icon_size_lookup_for_settings 		(GtkSettings *settings,
									 GtkIconSize size,
									 gint *width,
									 gint *height);

Déduit la taille en pixels d'une icône à partir de sa taille sémantique qui peut être modifiée en fonction des  préférences de l'utilisateur pour le  GtkSettings par défaut.Habituellement size serait GTK_ICON_SIZE_MENU, GTK_ICON_SIZE_BUTTON, etc. Cette fonction normalement n'est pas utile, gtk_widget_render_icon() est la solution d'usage pour obtenir une icône à afficher, puis elle observe  juste la taille du pixbuf rendu. Il peut ne pas correspondre à la largeur/ hauteur retournée par  gtk_icon_size_lookup(), parce que les thèmes ne sont pas libres de rendre le pixbuf comme ils le veulent, y compris changer la taille d'usage. (?)

Since 2.2

gtk_icon_size_register ()

GtkIconSize gtk_icon_size_register (const gchar *name,
gint width,
gint height);

Enregistre une nouvelle taille d'icône, Registers a new icon size,le long d'une même ligne comme GTK_ICON_SIZE_MENU, etc. Retourne un entier pour la taille.

gtk_icon_size_register_alias ()

void 		gtk_icon_size_register_alias 		(const gchar *alias,
							 GtkIconSize target);

Enregistre  alias  comme un autre nom de  target. Ainsi l'appel de  gtk_icon_size_from_name() avec  alias en argument retournera target.

gtk_icon_size_from_name ()

GtkIconSize 		gtk_icon_size_from_name 		(const gchar *name);

Cherche la taille de l'icône associée à name.

gtk_icon_size_get_name ()

const gchar* 		gtk_icon_size_get_name 		(GtkIconSize size);

Obtient le nom canonique de la taille donnée d'icône.  La chaîne retournée est allouée de façon statique et ne doit pas être libérée.

gtk_icon_set_get_sizes ()

void 		gtk_icon_set_get_sizes 		(GtkIconSet *icon_set,
						 GtkIconSize **sizes,
						 gint *n_sizes);

Obtient la liste des tailles d'icônes que la configuration d'icônes peut rendre;  Le tableau retourné doit être libéré avec g_free().

gtk_icon_source_get_direction ()

GtkTextDirection 		gtk_icon_source_get_direction 		(const GtkIconSource *source);

Obtient une direction de texte que la source d'icône applique. La valeur retournée est seulement utile / significative si la direction de texte n'a pas un caractère générique.

gtk_icon_source_get_direction_wildcarded ()

gboolean 		gtk_icon_source_get_direction_wildcarded  	(const GtkIconSource *source);

Obtient la valeur définie par  gtk_icon_source_set_direction_wildcarded().

gtk_icon_source_get_filename ()

const 		gchar* gtk_icon_source_get_filename 		(const GtkIconSource *source);

Recherche le nom de fichier source, ou  NULL si aucun n'est défini. Le nom de fichier n'est pas copié, et ne doit pas être modifié ou être amené à persister après le temps de vie de la source d'icônes.

gtk_icon_source_get_pixbuf ()

GdkPixbuf* 		gtk_icon_source_get_pixbuf 		(const GtkIconSource *source);

Recherche le pixbuf source, ou NULL s'il n'est pas défini. De plus, si une source de  nom de fichier est utilisée, cette fonction dans certains cas retournera le pixbuf  chargé avec le nom de fichier.Cela vaut, par exemple, pour le GtkIconSource passé à la fonction virtuelle GtkStyle::render_icon() . Le compteur de référence sur le  pixbuf n'est pas incrémenté.

gtk_icon_source_get_icon_name ()

const gchar* 		tk_icon_source_get_icon_name 		(const GtkIconSource *source);

Recherche le nom d'icône de la source, ou NULL s'il n'est pas défini. Ce nom d'icône n'est pas une copie, et ne doit pas être modifié ou être amené à persister après le temps de vie de la source d'icônes.

gtk_icon_source_get_size ()

GtkIconSize 		gtk_icon_source_get_size 		(const GtkIconSource *source);

Obetient la taille de l'icône que la source applique. La valeur retournée est seulement utile/ significative si la taille de l'icône n'a pas un caractère générique.

gtk_icon_source_get_size_wildcarded ()

gboolean 		gtk_icon_source_get_size_wildcarded 		(const GtkIconSource *source);

Donne la valeur définie par gtk_icon_source_set_size_wildcarded().

gtk_icon_source_get_state ()

GtkStateType 		gtk_icon_source_get_state 		(const GtkIconSource *source);

Donne  l'état du widget que la source d'icône applique. La valeur retournée est seulement utile/ significative si l'état du widget n'a pas un caractère générique.

gtk_icon_source_get_state_wildcarded ()

gboolean 		gtk_icon_source_get_state_wildcarded		(const GtkIconSource *source);

Donne la valeur définie par  gtk_icon_source_set_state_wildcarded().

gtk_icon_source_new ()

GtkIconSource* 		gtk_icon_source_new 		(void);

Créé un nouveau GtkIconSource. Un GtkIconSource contient un  GdkPixbuf (ou un nom de fichier image) qu'il utilise comme image de base pour une ou plusieurs icônes dans un GtkIconSet, avec des psécifications pour les icônes de la configuration d'icône qui seront basées sur ce pixbuf ou ce fichier image. Une configuration d'icône contient un ensemble d'icônes qui représentent "le même" concept logique dans des états différents, des directions de texte globales différentes, et des tailles différentes.

Ainsi, par exemple l'icône "Page précédente" de l'explorateur web doit pointer dans deux directions différente selon qu'il s'agisse d'un contexte arabe ou français; elle peut apparaître différemment si elle est inactivée; et peut changer de taille suivant le mode de la barre d'outils sélectionné (petites/grandes icônes). Aussi une seule configuration d'icônes contiendra toutes ces variantes d'icônes.  GtkIconSet contient une liste de GtkIconSource à partir desquels la configuration d'icône va dériver des variantes d'icône spécifiques pour l'eensemble.

Dans des cas plus simples,  GtkIconSet contient un seul pixbuf source duquel dérivera toutes les variantes. La fonction très pratique  gtk_icon_set_new_from_pixbuf() manipule ce cas; si vous avez seulement un seul pibuf source, utilisez seulement cette fonction.

Si vous voulez utiliser un pixbuf de base différent pour différentes variantes d'icônes, vous devez créer des sources d'icônes multiples, marquez quelles variantes elles auront créées, et ajoutez  les à la configuration d'icônes avec  gtk_icon_set_add_source().

Par défaut, les paramètres de la source d'icône ont tous un caractère générique.  c'est pourquoi, la source d'icône sera utilisée comme l'icône de nase pour n'importe quelle direction de texte, état de widget, ou taille d'icône.

gtk_icon_source_set_direction ()

void 		gtk_icon_source_set_direction 		(GtkIconSource *source,
							 GtkTextDirection direction);

Définit la direction de texte  prévue pour que  la source d'icônes l'utilise.

La définition de la direction de texte dans une source d'icônes ne provoque pas de différence sur la direction de texte a un caractère générique. Donc, vous appellerez généralement gtk_icon_source_set_direction_wildcarded() pour enlever ce caractère générique en plus d'appeler cette fonction.

gtk_icon_source_set_direction_wildcarded ()

void 		gtk_icon_source_set_direction_wildcarded	(GtkIconSource *source,
						        	 gboolean setting);

Si une direction de text a un caractère générique, sa source peut être utilisée comme l'image de base pour une icône dans tous les  GtkTextDirection. Si une direction de texte n'a pas de caractère générique, alors la direction de texte que la source d'icônes applique  devra être définie avec gtk_icon_source_set_direction(), et la source d'icônes sera seulement utilisée avec cette direction de texte.

GtkIconSet  préfère les sources sans caractère générique (exact matches) avant les sources à caractère générique, et elles utilisent une association exacte (exact match) quand c'est possible.

gtk_icon_source_set_filename ()

void 		gtk_icon_source_set_filename 		(GtkIconSource *source,
							 const gchar *filename);

Définit le nom d'un fichier image à utiliser comme base lors de la créations de variantes d'icônes pour GtkIconSet. Le nom de fichier doit être absolu.

gtk_icon_source_set_pixbuf ()

void 			gtk_icon_source_set_pixbuf 		(GtkIconSource *source,
								 GdkPixbuf *pixbuf);

Définit un pixbuf à utiliser comme image de base lors de la cration de variantes d'icônes pour  GtkIconSet.

gtk_icon_source_set_icon_name ()

void 		gtk_icon_source_set_icon_name 		(GtkIconSource *source,
							 const gchar *icon_name);

Définit le nom de l'icône à rechercher dans le thème d'icône courant pour l'utiliser comme image de base lors de la création de variantes d'icônes pour GtkIconSet.

gtk_icon_source_set_size ()

void 		gtk_icon_source_set_size 		(GtkIconSource *source,
							 GtkIconSize size);

Définit la taille de l'icône qu'il est prévu que la source d'icône  utilise.

gtk_icon_source_set_size_wildcarded ()

void 		gtk_icon_source_set_size_wildcarded 		(GtkIconSource *source,
								 gboolean setting);

Si la taille de l'icône a un caractère générique, sa source peut être utilisée comme image de base pour une icône de toute taille. Si la taille n'a pas de caractère générique, alors la taille que la source applique doit être définie avec gtk_icon_source_set_size() et ma source d'icônes sera seulement utilisée avec cette taille spécifique.

GtkIconSet  préfère les sources sans caractère générique (exact matches) avant les sources à caractère générique, et elles utilisent une association exacte (exact match) quand c'est possible.

GtkIconSet généralement dimensionnera les images sources à caractère générique pour créer une icône correspondant à une taille donnée, mais il ne changera pas la taille des images sources qui sont associées exactement (match exactly).

gtk_icon_source_set_state ()

void 		gtk_icon_source_set_state 		(GtkIconSource *source,
							 GtkStateType state);

Définit l'état du widget qu'il est prévu que la source d'icônes utilise.

La définition de l'état du widget pour une source d'icône ne provoque pas de différence si l'état a un caractère générique. Donc, vous devez généralement appeler  gtk_icon_source_set_state_wildcarded() pour enlever ce caractère générique en plus d'appeler cette fonction.

gtk_icon_source_set_state_wildcarded ()

void 		gtk_icon_source_set_state_wildcarded
							(GtkIconSource *source,
							 gboolean setting);

Si l'état du widget a un caractère générique, la source être utilisée comme image de base pour une icône dans tout GtkStateType. Si l'état du widget n'a pas un caractère générique, alors l'état que la source applique doit être défini avec gtk_icon_source_set_state() et la source d'icônes sera utilisée seulement avec cet état spécifique.

GtkIconSet  préfère les sources sans caractère générique (exact matches) avant les sources à caractère générique, et elles utilisent une association exacte (exact match) quand c'est possible.