Stock Items

Stock Items — Menu/ barre d'outils commun prédéfini  et icônes correspondantes

Synopsis

#include <gtk/gtk.h>

GtkStockItem;
void gtk_stock_add (const GtkStockItem *items,
 guint n_items);
void gtk_stock_add_static (const GtkStockItem *items,
 guint n_items);
GtkStockItem* gtk_stock_item_copy (const GtkStockItem *item);
void gtk_stock_item_free (GtkStockItem *item);
GSList* gtk_stock_list_ids (void);
gboolean gtk_stock_lookup (const gchar *stock_id,
 GtkStockItem *item);
void gtk_stock_set_translate_func (const gchar *domain,
 GtkTranslateFunc func,
 gpointer data,
 GtkDestroyNotify notify);
#define GTK_STOCK_ABOUT
#define GTK_STOCK_ADD
#define GTK_STOCK_APPLY
#define GTK_STOCK_BOLD
#define GTK_STOCK_CANCEL
#define GTK_STOCK_CDROM
#define GTK_STOCK_CLEAR
#define GTK_STOCK_CLOSE
#define GTK_STOCK_COLOR_PICKER
#define GTK_STOCK_CONVERT
#define GTK_STOCK_CONNECT
#define GTK_STOCK_COPY
#define GTK_STOCK_CUT
#define GTK_STOCK_DELETE
#define GTK_STOCK_DIALOG_AUTHENTICATION
#define GTK_STOCK_DIALOG_ERROR
#define GTK_STOCK_DIALOG_INFO
#define GTK_STOCK_DIALOG_QUESTION
#define GTK_STOCK_DIALOG_WARNING
#define GTK_STOCK_DIRECTORY
#define GTK_STOCK_DISCONNECT
#define GTK_STOCK_DND
#define GTK_STOCK_DND_MULTIPLE
#define GTK_STOCK_EDIT
#define GTK_STOCK_EXECUTE
#define GTK_STOCK_FILE
#define GTK_STOCK_FIND
#define GTK_STOCK_FIND_AND_REPLACE
#define GTK_STOCK_FLOPPY
#define GTK_STOCK_FULLSCREEN
#define GTK_STOCK_GOTO_BOTTOM
#define GTK_STOCK_GOTO_FIRST
#define GTK_STOCK_GOTO_LAST
#define GTK_STOCK_GOTO_TOP
#define GTK_STOCK_GO_BACK
#define GTK_STOCK_GO_DOWN
#define GTK_STOCK_GO_FORWARD
#define GTK_STOCK_GO_UP
#define GTK_STOCK_HARDDISK
#define GTK_STOCK_HELP
#define GTK_STOCK_HOME
#define GTK_STOCK_INDENT
#define GTK_STOCK_INDEX
#define GTK_STOCK_INFO
#define GTK_STOCK_ITALIC
#define GTK_STOCK_JUMP_TO
#define GTK_STOCK_JUSTIFY_CENTER
#define GTK_STOCK_JUSTIFY_FILL
#define GTK_STOCK_JUSTIFY_LEFT
#define GTK_STOCK_JUSTIFY_RIGHT
#define GTK_STOCK_LEAVE_FULLSCREEN
#define GTK_STOCK_MEDIA_FORWARD
#define GTK_STOCK_MEDIA_NEXT
#define GTK_STOCK_MEDIA_PAUSE
#define GTK_STOCK_MEDIA_PLAY
#define GTK_STOCK_MEDIA_PREVIOUS
#define GTK_STOCK_MEDIA_RECORD
#define GTK_STOCK_MEDIA_REWIND
#define GTK_STOCK_MEDIA_STOP
#define GTK_STOCK_MISSING_IMAGE
#define GTK_STOCK_NETWORK
#define GTK_STOCK_NEW
#define GTK_STOCK_NO
#define GTK_STOCK_OK
#define GTK_STOCK_OPEN
#define GTK_STOCK_ORIENTATION_LANDSCAPE
#define GTK_STOCK_ORIENTATION_PORTRAIT
#define GTK_STOCK_ORIENTATION_REVERSE_LANDSCAPE
#define GTK_STOCK_ORIENTATION_REVERSE_PORTRAIT
#define GTK_STOCK_PASTE
#define GTK_STOCK_PREFERENCES
#define GTK_STOCK_PRINT
#define GTK_STOCK_PRINT_PREVIEW
#define GTK_STOCK_PROPERTIES
#define GTK_STOCK_QUIT
#define GTK_STOCK_REDO
#define GTK_STOCK_REFRESH
#define GTK_STOCK_REMOVE
#define GTK_STOCK_REVERT_TO_SAVED
#define GTK_STOCK_SAVE
#define GTK_STOCK_SAVE_AS
#define GTK_STOCK_SELECT_ALL
#define GTK_STOCK_SELECT_COLOR
#define GTK_STOCK_SELECT_FONT
#define GTK_STOCK_SORT_ASCENDING
#define GTK_STOCK_SORT_DESCENDING
#define GTK_STOCK_SPELL_CHECK
#define GTK_STOCK_STOP
#define GTK_STOCK_STRIKETHROUGH
#define GTK_STOCK_UNDELETE
#define GTK_STOCK_UNDERLINE
#define GTK_STOCK_UNDO
#define GTK_STOCK_UNINDENT
#define GTK_STOCK_YES
#define GTK_STOCK_ZOOM_100
#define GTK_STOCK_ZOOM_FIT
#define GTK_STOCK_ZOOM_IN
#define GTK_STOCK_ZOOM_OUT

Description

Les Stock items  représentent les menus  utilisés en général ou les items de barres d'outils comme  "Ouvrir" ou "Sortie". Chaque stock item est identifié par un  stock ID (identifiant du stock); Les stock IDs sont de simples chaînes, mais des macros comme GTK_STOCK_OPEN sont fournis pour éviter des erreurs de types dans les chaînes. Les applications peuvent enregistrer leurs propres stock items en plus de ceux qui sont intégrés à GTK+.

Chaque stock ID peut être associé avec un  GtkStockItem qui contient le label visible par lutilisateur, l'accélérateurs clavier, et  le domaine de traduction de l'item  menu ou  barre d'outils; et/ou avec une icône stockée dans un  GtkIconFactory.  Voir GtkIconFactory pour plus d'informations sur les icônes. La connexion entre un GtkStockItem  et des stock icons est purement conventionnelle  (par le fait qu'il emploient le même stock ID); il est possible d'enregistrer un stock item mais pas une icône, et vice versa. (?) Les Stock icons peuvent avoir une variante  RTL  qui passe à l'usage local droite-gauche.

Details

GtkStockItem


typedef struct {
gchar *stock_id;
gchar *label; //si dessous tous les label seront traduits en français ça ne veut pas dire que ça apparaîtra dans vos applications aussi facilement ! :)
GdkModifierType modifier;
guint keyval;
gchar *translation_domain;
} GtkStockItem;


gtk_stock_add ()


void 		gtk_stock_add 		(const GtkStockItem *items,
 guint n_items);

Enregistre chacun des stock items dans items. Si un item existe déjà avec le même stock ID qu'un stock item déjà compris dans  items, l'ancien item sera remplacé. Les  stock items sont copiés, aussi GTK+ ne peut pas contenir de pointeur dans  items et items ne peut pas être libéré. Utilisez gtk_stock_add_static() si items est persistant et que  GTK+ n'a pas besoin de copier le tableau.

items : Un GtkStockItem ou un tableau d'items
n_items : nombre de GtkStockItem dans items

gtk_stock_add_static ()


void 		gtk_stock_add_static 		(const GtkStockItem *items,
 guint n_items);

Un peu comme gtk_stock_add(), mais ne copie pas l'items, aussi items doit persister jusqu'à ce que l'application se termine.

items : Un GtkStockItem ou tableau de GtkStockItem
n_items : Nombre d'items

gtk_stock_item_copy ()


GtkStockItem* 		gtk_stock_item_copy 		(const GtkStockItem *item);

Copie un stock item, très utile pour des raccourcis de langage et non dans les application.

item : Un  GtkStockItem
Retourne : Un nouveau GtkStockItem

gtk_stock_item_free ()


void 		gtk_stock_item_free 		(GtkStockItem *item);

Libère un stock item alloué dans un  bloc mémoire, comme ceux retournés par  gtk_stock_item_copy(). Libère aussi les champs à l'intérieur du  stock item, s'il ne sont pas NULL.

item : Un GtkStockItem

gtk_stock_list_ids ()


GSList* 		gtk_stock_list_ids 		(void);

Recherche une liste de tous les stock IDs connus ajoutés à un  GtkIconFactory ou enregistrés avec gtk_stock_add(). La liste doit être linérée avec g_slist_free(), et chaque chaîne dans la liste doit être libérée avec g_free().

Retourne : Une liste de stock IDs connus

gtk_stock_lookup ()


gboolean 		gtk_stock_lookup 		(const gchar *stock_id,
 GtkStockItem *item);

Remplit item avec les valeurs enregistrées pour  stock_id, retourne  TRUE si stock_id est connu.

stock_id : Un nom de stock item
item : stock item à initialiser avec les valeurs
Retourne : TRUE si  item a été initialisé

gtk_stock_set_translate_func ()


void 		gtk_stock_set_translate_func 		(const gchar *domain,
 GtkTranslateFunc func,
 gpointer data,
 GtkDestroyNotify notify);

Définit une fonction à utiliser pour traduire le  label d'un stock item.

Si aucune fonction n'est enregistrée pour le domaine de traduction, dgettext() est utilisée.

domain : Le domaine de traduction pour la func qui doit être utilisée
func : Un GtkTranslateFunc
data : Données à passer à  func
notify : Un GtkDestroyNotify qui est appelé quand data n'est plus nécessaire

Depuis  2.8


GTK_STOCK_ABOUT


#define GTK_STOCK_ABOUT 	"gtk-about"

Item "Au sujet de" 

Depuis 2.6


GTK_STOCK_ADD


#define GTK_STOCK_ADD 	"gtk-add"

Item "Ajouter".

GTK_STOCK_APPLY


#define GTK_STOCK_APPLY 	"gtk-apply"
Item "Appliquer".

GTK_STOCK_BOLD


#define GTK_STOCK_BOLD 		"gtk-bold"

Item "Gras".

GTK_STOCK_CANCEL


#define GTK_STOCK_CANCEL 	"gtk-cancel"

Item  "Annuler".

GTK_STOCK_CDROM


#define GTK_STOCK_CDROM 	"gtk-cdrom"

Item "CD-Rom".

GTK_STOCK_CLEAR


#define GTK_STOCK_CLEAR 	"gtk-clear"

Item "Effacer".

GTK_STOCK_CLOSE


#define GTK_STOCK_CLOSE 	"gtk-close"

Item "fermer".

GTK_STOCK_COLOR_PICKER


#define GTK_STOCK_COLOR_PICKER 		"gtk-color-picker"

Item "Pipette de couleur".

Depuis 2.2


GTK_STOCK_CONVERT


#define GTK_STOCK_CONVERT 	"gtk-convert"
Item  "Convertir".

GTK_STOCK_CONNECT


#define GTK_STOCK_CONNECT 	"gtk-connect"

Item "Connexion".

Depuis 2.6


GTK_STOCK_COPY


#define GTK_STOCK_COPY 		"gtk-copy"

Item  "Copier".

GTK_STOCK_CUT


#define GTK_STOCK_CUT 		"gtk-cut"

Item  "Couper".

GTK_STOCK_DELETE


#define GTK_STOCK_DELETE 	"gtk-delete"

Item "Supprimer".

GTK_STOCK_DIALOG_AUTHENTICATION


#define GTK_STOCK_DIALOG_AUTHENTICATION

Item "Autentification".

Depuis 2.4


GTK_STOCK_DIALOG_ERROR


#define GTK_STOCK_DIALOG_ERROR 		"gtk-dialog-error"

Item "Erreur".

GTK_STOCK_DIALOG_INFO


#define GTK_STOCK_DIALOG_INFO 		"gtk-dialog-info"

Item "Information".

GTK_STOCK_DIALOG_QUESTION


#define GTK_STOCK_DIALOG_QUESTION 	"gtk-dialog-question"

Item "Question".

GTK_STOCK_DIALOG_WARNING


#define GTK_STOCK_DIALOG_WARNING 		"gtk-dialog-warning"

Item "Attention".

GTK_STOCK_DIRECTORY


#define GTK_STOCK_DIRECTORY 		"gtk-directory"

Item "Répertoire".

Depuis 2.6


GTK_STOCK_DISCONNECT


#define GTK_STOCK_DISCONNECT 		"gtk-disconnect"

Icône  "Déconnexion".

Depuis 2.6


GTK_STOCK_DND


#define GTK_STOCK_DND 		"gtk-dnd"

Icône  "Glisser - Déposer" .


GTK_STOCK_DND_MULTIPLE


#define GTK_STOCK_DND_MULTIPLE 		"gtk-dnd-multiple"

Icône "Glisser-Déposer multiples".


GTK_STOCK_EDIT


#define GTK_STOCK_EDIT		 "gtk-edit"

Item  "Edition".

Depuis 2.6


GTK_STOCK_EXECUTE


#define GTK_STOCK_EXECUTE 		"gtk-execute"

Item  "Exécuter".


GTK_STOCK_FILE


#define	 GTK_STOCK_FILE		 "gtk-file"

Icône "Fichier".

Depuis 2.6


GTK_STOCK_FIND


#define GTK_STOCK_FIND		 "gtk-find"

ITem  "Chercher".


GTK_STOCK_FIND_AND_REPLACE


#define GTK_STOCK_FIND_AND_REPLACE 		"gtk-find-and-replace"

Item "Chercher et Remplacer".


GTK_STOCK_FLOPPY


#define GTK_STOCK_FLOPPY 	"gtk-floppy"

Item "Disquette".


GTK_STOCK_FULLSCREEN


#define GTK_STOCK_FULLSCREEN 		"gtk-fullscreen"

Item  "Plein écran".

Depuis 2.8


GTK_STOCK_GOTO_BOTTOM


#define	 GTK_STOCK_GOTO_BOTTOM		 "gtk-goto-bottom"

Item  " "Bas.


GTK_STOCK_GOTO_FIRST


#define GTK_STOCK_GOTO_FIRST 		"gtk-goto-first"

Item "Premier". Variante RTL 


GTK_STOCK_GOTO_LAST


#define GTK_STOCK_GOTO_LAST 		"gtk-goto-last"

Item  "Dernier" item. Variante RTL 


GTK_STOCK_GOTO_TOP


#define	 GTK_STOCK_GOTO_TOP 		"gtk-goto-top"

Item  "Dessus".


GTK_STOCK_GO_BACK


#define GTK_STOCK_GO_BACK 		"gtk-go-back"

Item  "Arrière". variante RTL 


GTK_STOCK_GO_DOWN


#define GTK_STOCK_GO_DOWN 		"gtk-go-down"

Item  "En bas".


GTK_STOCK_GO_FORWARD


#define	 GTK_STOCK_GO_FORWARD		 "gtk-go-forward"

Itel  "Vers l'avant". variante RTL 


GTK_STOCK_GO_UP


#define	 GTK_STOCK_GO_UP 		"gtk-go-up"

Item "En haut".


GTK_STOCK_HARDDISK


#define GTK_STOCK_HARDDISK         "gtk-harddisk"

Item "Disque Dur".

Depuis 2.4


GTK_STOCK_HELP


#define GTK_STOCK_HELP 		"gtk-help"

Item  "Aide".


GTK_STOCK_HOME


#define	 GTK_STOCK_HOME			 "gtk-home"

Item "Accueil" .


GTK_STOCK_INDENT


#define GTK_STOCK_INDENT 		"gtk-indent"

Item  "Retrait". variante RTL

Depuis 2.4


GTK_STOCK_INDEX


#define GTK_STOCK_INDEX 		"gtk-index"

Item "Index".


GTK_STOCK_INFO


#define GTK_STOCK_INFO 		"gtk-info"

Item "Info".

Depuis 2.8


GTK_STOCK_ITALIC


#define GTK_STOCK_ITALIC 		"gtk-italic"

Item "Italique".


GTK_STOCK_JUMP_TO


#define GTK_STOCK_JUMP_TO	 "gtk-jump-to"

Item "Sauter à". variante RTL


GTK_STOCK_JUSTIFY_CENTER


#define GTK_STOCK_JUSTIFY_CENTER		 "gtk-justify-center"

Item "Centrer".


GTK_STOCK_JUSTIFY_FILL


#define GTK_STOCK_JUSTIFY_FILL		 "gtk-justify-fill"

Item  "Justifier".


GTK_STOCK_JUSTIFY_LEFT


#define GTK_STOCK_JUSTIFY_LEFT		 "gtk-justify-left"

Item  "Aligner à gauche".


GTK_STOCK_JUSTIFY_RIGHT


#define GTK_STOCK_JUSTIFY_RIGHT 	"gtk-justify-right"

Item "Aligner à droite".


GTK_STOCK_LEAVE_FULLSCREEN


#define GTK_STOCK_LEAVE_FULLSCREEN		 "gtk-leave-fullscreen"

Item "Quitter le plein écran".

Depuis 2.8


GTK_STOCK_MEDIA_FORWARD


#define GTK_STOCK_MEDIA_FORWARD 		"gtk-media-forward"

Item "Media en avant". variante RTL

Depuis 2.6


GTK_STOCK_MEDIA_NEXT


#define GTK_STOCK_MEDIA_NEXT 		"gtk-media-next"

Item  "Media suivant". variante RTL 

Depuis 2.6


GTK_STOCK_MEDIA_PAUSE


#define GTK_STOCK_MEDIA_PAUSE 		"gtk-media-pause"

Item "Media Pause".

Depuis 2.6


GTK_STOCK_MEDIA_PLAY


#define GTK_STOCK_MEDIA_PLAY 		"gtk-media-play"

Item "Media Jouer". variante RTL 

Depuis 2.6


GTK_STOCK_MEDIA_PREVIOUS


#define GTK_STOCK_MEDIA_PREVIOUS		 "gtk-media-previous"

Item "Media précédent". variante RTL

Depuis 2.6


GTK_STOCK_MEDIA_RECORD


#define GTK_STOCK_MEDIA_RECORD		 "gtk-media-record"

Item "Media Enregistrer".

Depuis 2.6


GTK_STOCK_MEDIA_REWIND


#define GTK_STOCK_MEDIA_REWIND		 "gtk-media-rewind"

Item "Media arrière". variante RTL

Depuis 2.6


GTK_STOCK_MEDIA_STOP


#define GTK_STOCK_MEDIA_STOP 		"gtk-media-stop"

Item  "Media Arrêt".

Depuis 2.6


GTK_STOCK_MISSING_IMAGE


#define GTK_STOCK_MISSING_IMAGE 		"gtk-missing-image"

Icône "Image manquante".


GTK_STOCK_NETWORK


#define GTK_STOCK_NETWORK 		"gtk-network"

Item  "Réseau".

Depuis 2.4


GTK_STOCK_NEW


#define GTK_STOCK_NEW		 "gtk-new"

Item "Nouveau".


GTK_STOCK_NO


#define GTK_STOCK_NO "gtk-no"

Item  "Non".


GTK_STOCK_OK


#define GTK_STOCK_OK 		"gtk-ok"

Item "OK".


GTK_STOCK_OPEN


#define GTK_STOCK_OPEN 			"gtk-open"

Item "Ouvrir" .


GTK_STOCK_ORIENTATION_LANDSCAPE


#define GTK_STOCK_ORIENTATION_LANDSCAPE 		"gtk-orientation-landscape"

Item  "Orientation  Paysage".

Depuis 2.10


GTK_STOCK_ORIENTATION_PORTRAIT


#define GTK_STOCK_ORIENTATION_PORTRAIT 		"gtk-orientation-portrait"

Item "Orientation Portrait".

Depuis 2.10


GTK_STOCK_ORIENTATION_REVERSE_LANDSCAPE


#define GTK_STOCK_ORIENTATION_REVERSE_LANDSCAPE 	"gtk-orientation-reverse-landscape"

Item "Orientation Paysage Inversé".

Depuis 2.10


GTK_STOCK_ORIENTATION_REVERSE_PORTRAIT


#define GTK_STOCK_ORIENTATION_REVERSE_PORTRAIT 		"gtk-orientation-reverse-portrait"

Item  "Orientation  Portrait Inversé".

Depuis 2.10


GTK_STOCK_PASTE


#define GTK_STOCK_PASTE		 "gtk-paste"

Item "Coller".


GTK_STOCK_PREFERENCES


#define GTK_STOCK_PREFERENCES		 "gtk-preferences"

Item "Préferences".


GTK_STOCK_PRINT


#define GTK_STOCK_PRINT 		"gtk-print"

Item "Imprimer".


GTK_STOCK_PRINT_PREVIEW


#define GTK_STOCK_PRINT_PREVIEW 		"gtk-print-preview"

Item  "Prévualiser l'impression".


GTK_STOCK_PROPERTIES


#define GTK_STOCK_PROPERTIES 		"gtk-properties"

Item "Propriétés".


GTK_STOCK_QUIT


#define GTK_STOCK_QUIT 		"gtk-quit"

Item  "Quitter".


GTK_STOCK_REDO


#define GTK_STOCK_REDO		 "gtk-redo"

Item  "Refaire". variante RTL


GTK_STOCK_REFRESH


#define GTK_STOCK_REFRESH 		"gtk-refresh"

Item "Rafraichir".


GTK_STOCK_REMOVE


#define GTK_STOCK_REMOVE		 "gtk-remove"

Itel  "Enlever".


GTK_STOCK_REVERT_TO_SAVED


#define GTK_STOCK_REVERT_TO_SAVED 		"gtk-revert-to-saved"

Item "Inerser". variante RTL


GTK_STOCK_SAVE


#define GTK_STOCK_SAVE		 "gtk-save"

Item  "Enregistrer".


GTK_STOCK_SAVE_AS


#define GTK_STOCK_SAVE_AS 		"gtk-save-as"

Item "Enregistrer sous".


GTK_STOCK_SELECT_ALL


#define GTK_STOCK_SELECT_ALL 		"gtk-select-all"

Item " Tout sélectionner".

Depuis  2.10


GTK_STOCK_SELECT_COLOR


#define GTK_STOCK_SELECT_COLOR		"gtk-select-color"

Item  "Couleur".


GTK_STOCK_SELECT_FONT


#define GTK_STOCK_SELECT_FONT 		"gtk-select-font"

Item  "Police".


GTK_STOCK_SORT_ASCENDING


#define GTK_STOCK_SORT_ASCENDING 		"gtk-sort-ascending"

Item  "Croissant".


GTK_STOCK_SORT_DESCENDING


#define GTK_STOCK_SORT_DESCENDING		 "gtk-sort-descending"

Item  "Décroissant".


GTK_STOCK_SPELL_CHECK


#define GTK_STOCK_SPELL_CHECK 			"gtk-spell-check"

Item "Contrôle de l'orthographe".


GTK_STOCK_STOP


#define GTK_STOCK_STOP		 "gtk-stop"

Item "Stop".


GTK_STOCK_STRIKETHROUGH


#define GTK_STOCK_STRIKETHROUGH 		"gtk-strikethrough"

Item "Barré".


GTK_STOCK_UNDELETE


#define GTK_STOCK_UNDELETE 		"gtk-undelete"

Item "Restaurer". variante RTL


GTK_STOCK_UNDERLINE


#define GTK_STOCK_UNDERLINE 		"gtk-underline"

Item "SOuligner".


GTK_STOCK_UNDO


#define GTK_STOCK_UNDO		 "gtk-undo"

Item  "Annuler" . variante RTL


GTK_STOCK_UNINDENT


#define GTK_STOCK_UNINDENT 		"gtk-unindent"

Item  "Supprimer le retrait". variante RTL

Depuis 2.4


GTK_STOCK_YES


#define GTK_STOCK_YES		 "gtk-yes"

Item  "Oui".


GTK_STOCK_ZOOM_100


#define GTK_STOCK_ZOOM_100 		"gtk-zoom-100"

Item "Zoom 100%" .


GTK_STOCK_ZOOM_FIT


#define GTK_STOCK_ZOOM_FIT 		"gtk-zoom-fit"

Item  "Zoom ajusté".


GTK_STOCK_ZOOM_IN


#define GTK_STOCK_ZOOM_IN 		"gtk-zoom-in"

Item  "Zoom avant".


GTK_STOCK_ZOOM_OUT


#define GTK_STOCK_ZOOM_OUT		 "gtk-zoom-out"

Item "Zoom arrière".