Normaliser les noms de contrôles GTK+
Ce document concerne la version 1.2 de GTK+.
Normaliser les noms des contrôles, widgets en anglais, permet de disposer par la suite de code propre et facilement lisible. Une normalisation du nom de ces contrôles est proposée ci-dessous. Celle-ci est utilisée pour nommer les contrôles GTK+ et GNOME en s'aidant éventuellement du constructeur d'interfaces Glade.
Le principe est décrit dans ce paragraphe. Le nom des contrôles est séparé en deux. La première partie est un préfixe sur trois caractères qui permet d'identifier le type du contrôle. La deuxième partie permet de nommer le contrôle en lui-même.
Ainsi, par exemple, un contrôle de type GtkEntry et destiné à saisir le
nom d'un client sera nommé entCustomerName.
Enfin, remarquons que deux types de préfixes existent :
- les préfixes par construction ;
- les préfixes alternatifs, pour éviter les doublons.
Cette norme est utilisable ou adaptable à d'autres outils gérant des contrôles.
Un outil de vérification du nommage de vos fichiers Glade est disponible.
Les préfixes à utiliser en fonction du type du contrôle sont décrits dans les tableaux suivants.
Contrôles GTK+ basiques
| Type de contrôle | Préfixe |
|---|---|
| GtkButton | btn |
| GtkCheckButton | chb |
| GtkCheckMenuItem | cmi |
| GtkCList | cls |
| GtkClock | clc * |
| GtkColorSelectionDialog | csd |
| GtkCombo | cmb |
| GtkCTree | ctr |
| GtkDial | dil * |
| GtkDialog | dlg |
| GtkDrawingArea | dra |
| GtkEntry | ent |
| GtkFileSelection | fls |
| GtkFixed | fxd |
| GtkFontSelectionDialog | fsd |
| GtkFrame | frm |
| GtkHandleBox | hnb |
| GtkHBox | hbx |
| GtkHButtonBox | hbb |
| GtkHPaned | hpn |
| GtkHSeparator | hsp |
| GtkLabel | lbl |
| GtkList | lst |
| GtkMenu | men |
| GtkMenuBar | mnb |
| GtkMenuItem | mni |
| GtkNotebook | ntb |
| GtkOptionMenu | opm |
| GtkPixmap | pxm |
| GtkPixmapMenuItem | pmi |
| GtkProgressBar | prb |
| GtkRadioButton | rdb |
| GtkRadioMenuItem | rmi |
| GtkScrolledWindow | scw |
| GtkSpinButton | spb |
| GtkStatusbar | stt |
| GtkTable | tbl |
| GtkText | txt |
| GtkToggleButton | tgb |
| GtkToolbar | tlb |
| GtkTree | tre |
| GtkVBox | vbx |
| GtkVButtonBox | vbb |
| GtkViewport | vwp |
| GtkVPaned | vpn |
| GtkVSeparator | vsp |
| GtkWindow | wnd |
* Ces contrôles sont classés dans l'onglet GNOME dans Glade
Contrôles GTK+ additionnels
| Type de contrôle | Préfixe |
|---|---|
| GtkAccelLabel | acl |
| GtkAlignment | alg |
| GtkArrow | arr |
| GtkAspectFrame | asf |
| GtkCalendar | cln |
| GtkColorSelection | cls |
| GtkCurve | crv |
| GtkEventBox | evb |
| GtkFontSelection | fns |
| GtkGammaCurve | gmc |
| GtkHRuler | hrl |
| GtkHScale | hsc |
| GtkHScrollbar | hsr ** |
| GtkImage | img |
| GtkInputDialog | ind |
| GtkLayout | lyt |
| GtkPacker | pck |
| GtkPreview | prv |
| GtkVRuler | vrl |
| GtkVScale | vsc |
| GtkVScrollbar | vsr ** |
** Ces contrôles sont renommés pour éviter les doublons
Contrôles GNOME
| Type de contrôle | Préfixe |
|---|---|
| GnomeAbout | abt |
| GnomeAnimator | anm |
| GnomeApp | app |
| GnomeAppBar | apb |
| GnomeCanvas | cnv |
| GnomeCalculator | cll ** |
| GnomeColorPicker | clp |
| GnomeDateEdit | dte |
| GnomeDialog | dlo ** |
| GnomeDock | dck |
| GnomeDockItem | dci |
| GnomeDateEdit | dte |
| GnomeDruid | drd |
| GnomeDruidPageStandard | dps |
| GnomeDruidPageStart | dpt ** |
| GnomeDruidPageFinish | dpf |
| GnomeEntry | enr ** |
| GnomeFileEntry | fle |
| GnomeFontPicker | fnp |
| GnomeHRef | hrf |
| GnomeIconEntry | ice |
| GnomeIconList | icl |
| GnomeIconSelection | ics |
| GnomeLess | lss |
| GnomeMessageBox | msb |
| GnomeNumberEntry | nme |
| GnomePaperSelector | pps |
| GnomePixmap | pxp ** |
| GnomePixmapEntry | pxe |
| GnomePropertyBox | prb |
| GnomeSpell | spl |
** Ces contrôles sont renommés pour éviter les doublons