GlideMenu (g_menu et g_item) : client

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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’est le menu contextuel de l’interface utilisateur qui est sur le point de s’afficher. Le script onShow peut apporter des modifications à l’apparence du menu avant qu’il ne s’affiche à l’aide de ces méthodes.
    • g_item’est l’élément de menu contextuel d’interface utilisateur actuel qui est sur le point d’être affiché. Il est utilisé dans plusieurs des méthodes g_menu pour spécifier un élément.

    GlideMenu - clearImage(élément GlideMenuItem)

    Efface l’image d’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 afin qu’il puisse être modifié 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(élément GlideMenuItem)

    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é) 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é.

    Lorsque vous masquez des éléments de menu, les barres de séparation ne sont pas ajustées, il est donc possible que le menu affiche deux séparateurs à la suite.

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

    GlideMenu - setImage(GlideMenuItem item, String imgSrc)

    Définit l’image d’un élément.

    Tableau 13. Paramètres
    Nom Type Description
    élément Élément GlideMenuItem élément dans lequel l’image doit être affichée.
    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 item, étiquette de chaîne)

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

    Tableau 15. Paramètres
    Nom Type Description
    élément Élément GlideMenuItem L’élément à étiqueter.
    étiquette Chaîne Étiquette à afficher. La chaîne peut contenir du code 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ément à afficher.
    Tableau 18. Renvoie
    Type Description
    nul 
    g_menu.setVisible(g_item);