Método Application.GetOption (Access)

O método GetOption retorna o valor atual de uma opção na caixa de diálogo Opções de Acesso , disponível escolhendo o botão Microsoft Office e escolhendo Opções de Acesso. Variant.

Sintaxe

expressão. GetOption (OptionName)

expressão Uma variável que representa um Aplicativo objeto.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Optionname	Obrigatório	String	O nome da opção. Para obter uma lista de cadeias de caracteres de argumento de nome de opção, consulte Definir opções do Visual Basic.

Valor de retorno

Variant

Comentários

Os métodos GetOption e SetOption fornecem um meio de alterar as opções de ambiente do código Visual Basic. Com esses métodos, você pode definir ou ler qualquer opção disponível na caixa de diálogo Opções do Access.

As configurações de opções disponíveis dependem do tipo de opção que esteja sendo definida. Existem três tipos gerais de opções:

• Opções Sim/Não, que podem ser definidas ao marcar ou desmarcar uma caixa de seleção.

• Opções que podem ser definidas ao inserir uma cadeia de caracteres ou um valor numérico.

• Opções predefinidas que podem ser escolhidas em uma caixa de listagem, caixa de combinação ou grupo de opções.

Para opções que o usuário define selecionando ou desmarcando uma caixa de seleção, o método GetOption retornará True (1) se a configuração de opção for Sim (a caixa de seleção está selecionada) ou False (0) se a configuração da opção for Não (a caixa de seleção está desmarcada). Para definir uma opção desse tipo usando o método SetOption , especifique True ou False para o argumento de configuração, como no exemplo a seguir.

Application.SetOption "Show Status Bar", True

Para opções que o usuário define digitando uma cadeia de caracteres ou valor numérico, o método GetOption retorna a configuração conforme ela é exibida na caixa de diálogo. O exemplo a seguir retorna uma cadeia de caracteres que contém a configuração de margem esquerda.

Dim varSetting As Variant 
varSetting = Application.GetOption("Left Margin")

Para definir este tipo de opção utilizando o método SetOption, especifique a sequência ou o valor numérico que seria digitado na caixa de diálogo. O exemplo a seguir define o modelo de formulário padrão como OrderTemplate.

Application.SetOption "Form Template", "OrderTemplate"

Para opções com configurações que são opções em caixas de lista ou caixas de combinação, o método GetOption retorna um número correspondente à posição da configuração na lista. A indexação começa com zero, portanto, o método GetOption retorna zero para o primeiro item, 1 para o segundo item e assim por diante. Por exemplo, se a opção Tipo de Campo Padrão na guia Designers de Objetos for definida como AutoNumber, o sexto item da lista, o método GetOption retornará 5.

Para definir esse tipo de opção, especifique a posição numérica da opção dentro da lista como o argumento setting para o método SetOption. O exemplo a seguir define a opção Tipo de Campo Padrão como Número Automático.

Application.SetOption "Default Field Type", 5

Outras opções são definidas escolhendo um botão de opção em um grupo de opções na caixa de diálogo Opções de Acesso . No Visual Basic, essas opções também são definidas especificando a posição de uma determinada opção no grupo de opções. A primeira opção no grupo é numerada como zero, a segunda, 1 e assim por diante. Por exemplo, se a opção Comportamento de Seleção na guia Designers de Objetos estiver definida como Parcialmente Fechada, o método GetOption retornará zero, como no exemplo a seguir.

Debug.Print Application.GetOption("Selection Behavior")

Para definir uma opção que seja membro de um grupo de opções, especifique o número de índice da opção no grupo. O exemplo a seguir define Comportamento de Seleção como Totalmente Fechado.

Application.SetOption "Selection Behavior", 1

Observação

Quando você sai do Microsoft Access, você pode redefinir todas as opções para suas configurações originais usando o método SetOption em todas as opções alteradas. Convém criar variáveis públicas para armazenar os valores das configurações originais. Você pode incluir o código para redefinir opções no procedimento de evento Fechar para um formulário ou em um procedimento de saída personalizado que o usuário deve executar para sair do aplicativo.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.