--- sourceDocument: Referência de API do Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Referência de API do Xanadu ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # GlideMenu (g_menu e g_item) -- Cliente # GlideMenu (g_menu e g_item) -- Cliente {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura A API GlideMenu fornece métodos que podem ser usados em menus de contexto de IU e em scripts `onShow` para personalizar itens de 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 da IU que está prestes a ser mostrado. O script `onShow` 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. Ele é usado em vários métodos g_menu para especificar um item. {#c_GlideMenuAPI__ul_thk_zzw_hv} ## GlideMenu - clearImage(item GlideMenuItem) {#ariaid-title2} Limpa a imagem de um item. {#r_GM-clearImage_GMI__table_k1g_m1x_hv__entry__3} | Nome | Tipo | Descrição | |-|-|-| | item | GlideMenuItem | Especifica o item a ter sua imagem removida da exibição. | [Tabela 1. Parâmetros] {#r_GM-clearImage_GMI__table_k1g_m1x_hv} {#r_GM-clearImage_GMI__table_l1g_m1x_hv__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 2. Retorna] {#r_GM-clearImage_GMI__table_l1g_m1x_hv} g_menu.clearImage(g_item); ## GlideMenu -- clearSelected() {#ariaid-title3} Limpa todas as imagens de seleção dos itens no menu. {#r_GM-clearSelected__table_wtx_x1x_hv__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 3. Parâmetros] {#r_GM-clearSelected__table_wtx_x1x_hv} {#r_GM-clearSelected__table_xtx_x1x_hv__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 4. Retorna] {#r_GM-clearSelected__table_xtx_x1x_hv} ## GlideMenu -- getItem(cadeia de caracteres itemID) {#ariaid-title4} 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). {#r_GM-getItem_S__table_tnn_gbx_hv__entry__3} | Nome | Tipo | Descrição | |-|-|-| | ID do item | Cadeia de caracteres | Especifica o item a ser retornado. | [Tabela 5. Parâmetros] {#r_GM-getItem_S__table_tnn_gbx_hv} {#r_GM-getItem_S__table_unn_gbx_hv__entry__2} | Tipo | Descrição | |-|-| | GlideMenuItem | O item de menu | [Tabela 6. Retorna] {#r_GM-getItem_S__table_unn_gbx_hv} ## GlideMenu - setDisabled(item GlideMenuItem) {#ariaid-title5} 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. {#r_GM-setDisabled_GMI__table_d21_5bx_hv__entry__3} | Nome | Tipo | Descrição | |-|-|-| | item | GlideMenuItem | O item a ser desabilitado. | [Tabela 7. Parâmetros] {#r_GM-setDisabled_GMI__table_d21_5bx_hv} {#r_GM-setDisabled_GMI__table_e21_5bx_hv__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 8. Retorna] {#r_GM-setDisabled_GMI__table_e21_5bx_hv} g_menu.setDisabled(g_item); ## GlideMenu - setEnabled(item GlideMenuItem) {#ariaid-title6} Habilita o item de menu especificado. {#r_GM-setEnabled_GMI__table_hb4_gcx_hv__entry__3} | Nome | Tipo | Descrição | |-|-|-| | item | GlideMenuItem | O item a ser habilitado. | [Tabela 9. Parâmetros] {#r_GM-setEnabled_GMI__table_hb4_gcx_hv} {#r_GM-setEnabled_GMI__table_ib4_gcx_hv__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 10. Retorna] {#r_GM-setEnabled_GMI__table_ib4_gcx_hv} g_menu.setEnabled(g_item); ## GlideMenu - setHidden(item GlideMenuItem) {#ariaid-title7} Oculta o item de menu especificado. Ao ocultar itens de menu, as barras separadoras não são ajustadas, portanto, é possível que o menu acerte mostrando dois separadores em uma linha. {#r_GM-setHidden_GMI__table_g3l_scx_hv__entry__3} | Nome | Tipo | Descrição | |-|-|-| | item | GlideMenuItem | O item a ser oculto. | [Tabela 11. Parâmetros] {#r_GM-setHidden_GMI__table_g3l_scx_hv} {#r_GM-setHidden_GMI__table_h3l_scx_hv__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 12. Retorna] {#r_GM-setHidden_GMI__table_h3l_scx_hv} g_menu.setHidden(g_item); ## GlideMenu -- setImage(item GlideMenuItem, cadeia de caracteres imgSrc) {#ariaid-title8} Define uma imagem para um item. {#r_GM-setImage_GMI_S__table_w1f_2dx_hv__entry__3} | Nome | Tipo | Descrição | |-|-|-| | item | GlideMenuItem | o item para que a imagem seja exibida. | | imgSrc | Cadeia de caracteres | a imagem a ser anexada ao item de menu. | [Tabela 13. Parâmetros] {#r_GM-setImage_GMI_S__table_w1f_2dx_hv} {#r_GM-setImage_GMI_S__table_x1f_2dx_hv__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 14. Retorna] {#r_GM-setImage_GMI_S__table_x1f_2dx_hv} g_menu.setImage(g_item, 'images/checked.gifx'); ## GlideMenu - setLabel(item GlideMenuItem, rótulo de cadeia de caracteres) {#ariaid-title9} Define o rótulo de exibição de um item de menu. O rótulo pode conter HTML. {#r_GM-setLabel_GMI_S__table_ixl_rdx_hv__entry__3} | 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 15. Parâmetros] {#r_GM-setLabel_GMI_S__table_ixl_rdx_hv} {#r_GM-setLabel_GMI_S__table_jxl_rdx_hv__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 16. Retorna] {#r_GM-setLabel_GMI_S__table_jxl_rdx_hv} g_menu.setLabel(g_item, "This is a new label"); ## GlideMenu - setVisible(GlideMenuItem item) {#ariaid-title10} Exibe o item especificado. {#r_GM-setVisible_GMI__table_y2z_f2x_hv__entry__3} | Nome | Tipo | Descrição | |-|-|-| | item | GlideMenuItem | O item a ser exibido. | [Tabela 17. Parâmetros] {#r_GM-setVisible_GMI__table_y2z_f2x_hv} {#r_GM-setVisible_GMI__table_z2z_f2x_hv__entry__2} | Tipo | Descrição | |-|-| | vazio | | [Tabela 18. Retorna] {#r_GM-setVisible_GMI__table_z2z_f2x_hv} g_menu.setVisible(g_item);