Compartilhar via

Ação da macro DefinirItemDoMenu

Aplica-se ao: Access 2013, Office 2013

Use a ação DefinirItemDoMenu para definir o estado de itens de menu (habilitado ou desabilitado, selecionado ou não selecionado) em menus personalizados ou globais, na guia Suplementos.

Observação

A ação SetMenuItem funciona apenas com menus personalizados e globais criados usando macros de menu. A ação SetMenuItem está incluída no Microsoft Access apenas para compatibilidade com versões anteriores. Ele não funciona com a funcionalidade da barra de comandos. No entanto, você pode usar as propriedades Enabled e State em um módulo de Visual Basic for Applications (VBA) para desabilitar ou habilitar e selecionar ou desmarcar itens em menus de atalho ou menus personalizados ou globais.

Setting

A ação DefinirItemDoMenu tem os seguintes argumentos.

Argumento da ação

Descrição

Índice de menu

O índice do menu que contém o comando para o qual você deseja definir o estado. Insira um valor inteiro, começando em 0, para o índice do menu desejado no menu personalizado ou global. Insira o valor de índice na caixa Índice de Menu na seção Argumentos da Ação do painel Construtor de Macros. O índice é relativo à posição do menu na macro de menu do menu personalizado ou global (a posição da ação AdicionarMenu desse menu na macro de menu, contando de 0). A exibição do menu pode ser ligeiramente diferente, porque você pode usar expressões condicionais na macro de menu para ocultar ou exibir itens de menu personalizado. Este é um argumento obrigatório. Se você selecionar um menu com este argumento e deixar em branco os argumentos Índice de comando e Índice de subcomando, o próprio nome do menu poderá ser habilitado ou desabilitado. Não é possível, entretanto, selecionar ou desmarcar um nome de menu (o Access ignora as configurações Marcar e Desmarcar do argumento Sinalizador para nomes de menu).

Índice de comando

O índice do comando para o qual você deseja definir o estado. Insira um valor inteiro, começando em 0, para o índice do comando desejado no menu selecionado pelo argumento Índice de menu. O índice é relativo à posição do comando no grupo de macros que define o menu selecionado do menu personalizado ou global (a posição da macro desse comando no grupo de macros, contando de 0). A exibição do menu pode ser ligeiramente diferente, porque você pode usar expressões condicionais no grupo de macros do menu para ocultar ou exibir os comandos do menu personalizado.

Índice de subcomando

O índice do subcomando para o qual você deseja definir o estado. Isso só será aplicável se o comando desejado tiver um submenu. Insira um valor inteiro, começando em 0, para o índice do subcomando desejado no submenu selecionado pelo argumento Índice de comando. O índice é relativo à posição do subcomando no grupo de macros que define o submenu selecionado do menu personalizado ou global (a posição da macro desse subcomando no grupo de macros, contando de 0).

Flag

O estado para o qual você deseja definir o comando ou o subcomando. Clique em Cinza (para desabilitar o comando — ele ficará esmaecido), em Anular Cinza (para habilitá-lo), em Marcar (para colocar uma marca no comando — geralmente indicando que ele foi selecionado ou alternado) ou em Desmarcar (para remover a marca). O padrão é Anular Cinza.

Comentários

A ação DefinirItemDoMenu funciona somente em um menu personalizado ou global. Se a janela ativa não tiver um menu personalizado ou global, a execução de uma macro contendo a ação DefinirItemDoMenu causará um erro em tempo de execução.

Você pode usar essa ação para definir o estado de comandos e subcomandos de menu, mas não de subcomandos de subcomandos.

Para executar a ação DefinirItemDoMenu em um módulo do VBA (Visual Basic for Applications), use o método SetMenuItem do objeto DoCmd.

  • Last updated on