Propriété de Albiri Sigue
customer 27921 at Fri Mar 11 19:19:45 +0100 2011
Chapitre 11
Utilisation des menus 139
Options des menus et XML
Les éléments item et group peuvent contenir plusieurs attributs correspondant aux méthodes
de Menu et MenuItem.
Titre
Le titre d’un choix de menu est fourni par l’attribut android:title d’un élément item.
Ce titre peut être une chaîne littérale ou une référence vers une ressource chaîne
(@string/truc, par exemple).
Icône
Les choix de menus peuvent posséder des icônes qui sont fournies sous la forme d’une
référence vers une ressource Drawable (@drawable/eject, par exemple) via l’attribut
android:icon d’un élément item.
Ordre
Par défaut, l’ordre des choix du menu est déterminé par celui de leur apparition dans le
fichier XML. Vous pouvez modifier cet ordre à l’aide de l’attribut android:orderInCategory de l’élément item. Sa valeur est un indice commençant à 0, qui précise son ordre
d’apparition dans la catégorie courante. Les éléments group peuvent utiliser l’attribut
android:menuCategory pour indiquer une catégorie différente de celle par défaut pour
leurs éléments item.
Cependant, il est généralement plus simple de placer les éléments dans le bon ordre dans
le fichier XML.
Activation
Les item et les group peuvent être rendus actifs ou inactifs dans le fichier XML, à l’aide
de leur attribut android:enabled. Par défaut, ils sont considérés comme actifs. Les objets
item et group inactifs apparaissent dans le menu mais ne peuvent pas être sélectionnés.
Vous pouvez modifier l’état d’un item en cours d’exécution grâce à la méthode setEnabled()
de MenuItem et celui d’un group via la méthode setGroupEnabled() de Menu.
Visibilité
De même, les objets item et group peuvent être visibles ou non, selon la valeur de leur attribut
android:visible. Par défaut, ils sont visibles ; les objets item et group invisibles n’apparaissent pas dans le menu. Vous pouvez modifier cet état en cours d’exécution en appelant la
méthode setVisible() d’un MenuItem ou la méthode setGroupVisible() d’un Menu.
Dans le fichier XML présenté plus haut, le groupe other_stuff est invisible. Si nous le
rendons visible dans le code Java, les deux choix du groupe apparaîtront comme par
magie.
Livre Android.book Page 139 Dimanche, 8. novembre 2009 12:23 12
customer 27921 at Fri Mar 11 19:19:45 +0100 2011
Chapitre 11
Utilisation des menus 139
Options des menus et XML
Les éléments item et group peuvent contenir plusieurs attributs correspondant aux méthodes
de Menu et MenuItem.
Titre
Le titre d’un choix de menu est fourni par l’attribut android:title d’un élément item.
Ce titre peut être une chaîne littérale ou une référence vers une ressource chaîne
(@string/truc, par exemple).
Icône
Les choix de menus peuvent posséder des icônes qui sont fournies sous la forme d’une
référence vers une ressource Drawable (@drawable/eject, par exemple) via l’attribut
android:icon d’un élément item.
Ordre
Par défaut, l’ordre des choix du menu est déterminé par celui de leur apparition dans le
fichier XML. Vous pouvez modifier cet ordre à l’aide de l’attribut android:orderInCategory de l’élément item. Sa valeur est un indice commençant à 0, qui précise son ordre
d’apparition dans la catégorie courante. Les éléments group peuvent utiliser l’attribut
android:menuCategory pour indiquer une catégorie différente de celle par défaut pour
leurs éléments item.
Cependant, il est généralement plus simple de placer les éléments dans le bon ordre dans
le fichier XML.
Activation
Les item et les group peuvent être rendus actifs ou inactifs dans le fichier XML, à l’aide
de leur attribut android:enabled. Par défaut, ils sont considérés comme actifs. Les objets
item et group inactifs apparaissent dans le menu mais ne peuvent pas être sélectionnés.
Vous pouvez modifier l’état d’un item en cours d’exécution grâce à la méthode setEnabled()
de MenuItem et celui d’un group via la méthode setGroupEnabled() de Menu.
Visibilité
De même, les objets item et group peuvent être visibles ou non, selon la valeur de leur attribut
android:visible. Par défaut, ils sont visibles ; les objets item et group invisibles n’apparaissent pas dans le menu. Vous pouvez modifier cet état en cours d’exécution en appelant la
méthode setVisible() d’un MenuItem ou la méthode setGroupVisible() d’un Menu.
Dans le fichier XML présenté plus haut, le groupe other_stuff est invisible. Si nous le
rendons visible dans le code Java, les deux choix du groupe apparaîtront comme par
magie.
Livre Android.book Page 139 Dimanche, 8. novembre 2009 12:23 12