GlideMenu (g_menu e g_item) - Cliente

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura
  • Os métodos GlideMenu são usados em menus de contexto de IU, nos scripts onShow para personalizar itens do menu de contexto de IU.

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

    GlideMenu - clearImage(GlideMenuItem item)

    Limpa a imagem de um item.

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

    GlideMenu – limparSelected()

    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(cadeia de caracteres itemID)

    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 ser atribuído a um ID exclusivo quando o item de menu é criado (a partir de uma entrada de menu de contexto de IU ou do método addAction() na Ação de script dinâmico).

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

    GlideMenu - setDisabled(GlideMenuItem item)

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

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

    GlideMenu - setEnabled(GlideMenuItem item)

    Habilita o item de menu especificado.

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

    GlideMenu - setHidden(GlideMenuItem item)

    Oculta o item de menu especificado.

    Ao ocultar itens de menu, as barras separadoras não são ajustadas, portanto, é possível terminar 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. Retorna
    Tipo Descrição
    vazio
    g_menu.setHidden(g_item);

    GlideMenu - setImage(GlideMenuItem item, String imgSrc)

    Define uma imagem para um item.

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

    GlideMenu - setLabel(GlideMenuItem item, String label)

    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. Retorna
    Tipo Descrição
    vazio
    g_menu.setLabel(g_item, "This is a new label");

    GlideMenu - setVisible(GlideMenuItem item)

    Exibe o item especificado.

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