GlideMenu (g_menu et g_item) : client

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 2 minutes de lecture

    • L’API GlideMenu fournit des méthodes qui peuvent être utilisées dans les menus contextuels de l’interface utilisateur et dans les scripts onShow pour personnaliser les éléments du menu contextuel de l’interface utilisateur.

    Il n’existe pas de constructeur pour la classe GlideMenu . Accédez aux méthodes GlideMenu à l’aide de l’objet global g_menu .
    • g_menu s’agit du menu contextuel de l’interface utilisateur qui est sur le point d’être affiché. Le script onShow peut modifier l’apparence du menu avant qu’il ne soit affiché à l’aide de ces méthodes.
    • g_item s’agit de l’élément de menu contextuel de l’interface utilisateur actuel qui est sur le point d’être affiché. Il est utilisé dans plusieurs des méthodes de g_menu pour spécifier un élément.

    GlideMenu : clearImage(élément GlideMenuItem)

    Efface l’image pour un élément.

    Tableau 1. Paramètres
    Nom Type Description
    élément Élément GlideMenuItem Spécifie que l’image de l’élément doit être supprimée de l’affichage.
    Tableau 2. Renvoie
    Type Description
    nul 
    g_menu.clearImage(g_item);

    GlideMenu : clearSelected()

    Efface toutes les images de sélection des éléments du menu.

    Tableau 3. Paramètres
    Nom Type Description
    Aucun
    Tableau 4. Renvoie
    Type Description
    nul

    GlideMenu : getItem(String itemID)

    Renvoie un élément de menu par ID d’élément.

    Il peut être nécessaire de trouver un élément dans un menu pour pouvoir le modifier avant d’être affiché. Chaque élément de menu peut se voir attribuer un ID unique lors de la création de l’élément de menu (soit à partir d’une entrée de menu contextuel de l’interface utilisateur, soit à partir de la méthode addAction() dans l’action de script dynamique).

    Tableau 5. Paramètres
    Nom Type Description
    ID élément Chaîne Spécifie l’élément à renvoyer.
    Tableau 6. Renvoie
    Type Description
    Élément GlideMenuItem L’élément de menu

    GlideMenu : setDisabled(GlideMenuItem, élément)

    Désactive un élément de menu afin qu’il ne puisse pas être sélectionné. L’élément de menu désactivé s’affiche dans une couleur plus claire (grisée) pour indiquer qu’il est désactivé.

    Tableau 7. Paramètres
    Nom Type Description
    élément Élément GlideMenuItem Élément à désactiver.
    Tableau 8. Renvoie
    Type Description
    nul 
    g_menu.setDisabled(g_item);

    GlideMenu : setEnabled (élément GlideMenuItem)

    Active l’élément de menu spécifié.

    Tableau 9. Paramètres
    Nom Type Description
    élément Élément GlideMenuItem Élément à activer.
    Tableau 10. Renvoie
    Type Description
    nul 
    g_menu.setEnabled(g_item);

    GlideMenu : setHidden(élément GlideMenuItem)

    Masque l’élément de menu spécifié.

    Lors du masquage des éléments de menu, les barres de séparation ne sont pas ajustées, il est donc possible de se retrouver avec le menu affichant deux séparateurs à la suite.

    Tableau 11. Paramètres
    Nom Type Description
    élément Élément GlideMenuItem L’élément à masquer.
    Tableau 12. Renvoie
    Type Description
    nul 
    g_menu.setHidden(g_item);

    GlideMenu : setImage(élément GlideMenuItem, chaîne imgSrc)

    Définit une image pour un élément.

    Tableau 13. Paramètres
    Nom Type Description
    élément Élément GlideMenuItem Élément pour afficher l’image.
    imgSrc Chaîne Image à joindre à l’élément de menu.
    Tableau 14. Renvoie
    Type Description
    nul 
    g_menu.setImage(g_item, 'images/checked.gifx');

    GlideMenu : setLabel(GlideMenuItem, Étiquette de chaîne)

    Définit l’étiquette d’affichage d’un élément de menu. L’étiquette peut contenir du HTML.

    Tableau 15. Paramètres
    Nom Type Description
    élément Élément GlideMenuItem Élément à étiqueter.
    étiquette Chaîne l’étiquette à afficher. La chaîne peut contenir du HTML.
    Tableau 16. Renvoie
    Type Description
    nul 
    g_menu.setLabel(g_item, "This is a new label");

    GlideMenu : setVisible (élément GlideMenuItem)

    Affiche l’élément spécifié.

    Tableau 17. Paramètres
    Nom Type Description
    élément Élément GlideMenuItem L’élément à afficher.
    Tableau 18. Renvoie
    Type Description
    nul 
    g_menu.setVisible(g_item);