GlideMenu (g_menu e g_item) - Cliente

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura

    • . GlideMenu A API fornece métodos que podem ser usados em menus de contexto de IU e em OnShow Scripts para personalizar itens de menu de contexto de IU.

    Não há construtor para GlideMenu classe. Acesso GlideMenu métodos que usam g_menu objeto global.
    • g_menu É o menu de contexto de IU que está prestes a ser mostrado. . OnShow o script pode fazer mudanças na aparência do menu antes que ele seja exibido usando esses métodos.
    • g_item É o item de menu de contexto de IU atual que está prestes a ser mostrado. É usado em vários dos g_menu métodos para especificar um item.

    GlideMenu - clearImage(item GlideMenuItem)

    Limpa a imagem de um item.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    item GlideMenuItem Especifica o item para ter sua imagem removida da exibição.
    Tabela 2. Retornos
    Tipo Descrição
    vazio 
    g_menu.clearImage(g_item);

    GlideMenu - clearSelected()

    Limpa todas as imagens de seleção dos itens no menu.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 4. Retorna
    Tipo Descrição
    vazio

    GlideMenu - getItem (Itemid de cadeia de caracteres)

    Retorna um item de menu por ID de item.

    Pode ser necessário encontrar um item em um menu para que ele possa ser alterado antes de ser exibido. Cada item de menu pode receber um ID exclusivo quando o item de menu é criado (seja em uma entrada de menu de contexto de IU ou em AddAction() Na Ação de script dinâmico).

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    Itemid Cadeia de caracteres Especifica o item a ser retornado.
    Tabela 6. Retornos
    Tipo Descrição
    GlideMenuItem O item de menu

    GlideMenu - setDisabled (item GlideMenuItem)

    Desabilita um item de menu para que ele não possa ser selecionado. O item de menu desabilitado é exibido em uma cor mais clara (esmaecido) para indicar que está desabilitado.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    item GlideMenuItem O item a ser desabilitado.
    Tabela 8. Retornos
    Tipo Descrição
    vazio 
    g_menu.setDisabled(g_item);

    GlideMenu - setEnabled(item GlideMenuItem)

    Habilita o item de menu especificado.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    item GlideMenuItem O item a ser habilitado.
    Tabela 10. Retornos
    Tipo Descrição
    vazio 
    g_menu.setEnabled(g_item);

    GlideMenu - setHidden(item GlideMenuItem)

    Oculta o item de menu especificado.

    Ao ocultar itens de menu, as barras separadoras não são ajustadas, portanto, é possível acabar com o menu mostrando dois separadores em uma linha.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    item GlideMenuItem O item a ser oculto.
    Tabela 12. Retornos
    Tipo Descrição
    vazio 
    g_menu.setHidden(g_item);

    GlideMenu - setImage(item GlideMenuItem, cadeia de caracteres imgSrc)

    Define uma imagem para um item.

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    item GlideMenuItem o item para exibir a imagem.
    imgSrc Cadeia de caracteres a imagem a ser anexada ao item de menu.
    Tabela 14. Retornos
    Tipo Descrição
    vazio 
    g_menu.setImage(g_item, 'images/checked.gifx');

    GlideMenu - setLabel(item GlideMenuItem, rótulo de cadeia de caracteres)

    Define o rótulo de exibição de um item de menu. O rótulo pode conter HTML.

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    item GlideMenuItem o item a ser rotulado.
    rótulo Cadeia de caracteres o rótulo a ser exibido. A cadeia de caracteres pode conter HTML.
    Tabela 16. Retornos
    Tipo Descrição
    vazio 
    g_menu.setLabel(g_item, "This is a new label");

    GlideMenu - setVisible(item GlideMenuItem)

    Exibe o item especificado.

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    item GlideMenuItem O item a ser exibido.
    Tabela 18. Retornos
    Tipo Descrição
    vazio 
    g_menu.setVisible(g_item);