GlideMenu (g_menu e g_item) – Cliente

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.

GlideMenu - clearImage(item GlideMenuItem)

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. 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(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. 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 (acinzentado) 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 que o menu acerte 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 que a imagem seja exibida.
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(GlideMenuItem item)

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);