Ação da macro DefinirPropriedade

Aplica-se ao: Access 2013, Office 2013

Você pode usar a ação DefinirPropriedade para definir uma propriedade para um controle em um formulário ou relatório.

Setting

A ação DefinirPropriedade tem os seguintes argumentos.

Argumento da ação	Descrição
Nome do controle	Digite o nome do campo ou do controle para o qual você deseja definir o valor da propriedade. Use somente o nome do controle, e não a sintaxe completa. Deixe este argumento em branco para definir a propriedade do formulário ou do relatório atual.
Propriedade	Selecione a propriedade a ser definida. Consulte a seção Comentários deste artigo para obter uma lista das propriedades que podem ser definidas com esta ação.
Valor	Digite o valor com o qual a propriedade deve ser definida. Para propriedades cujos valores sejam Sim ou Não, use -1 para Sim e 0 para Não.

Comentários

• Você pode usar a ação DefinirPropriedade para definir estas propriedades de um controle: Habilitado, Visível, Locked, Esquerdo, Superior, Largura, Altura, Cor de Primeiro Plano, Cor do Fundo ou Legenda.

• Se você inserir um valor inválido para o argumento Valor , nenhum erro ocorrerá, mas o Access poderá alterar a propriedade para um valor diferente, dependendo de como ele interpreta o argumento.

• A ação DefinirPropriedade poderá ser usada em uma macro autônoma somente se você precedê-la com uma ação que selecione o formulário ou o relatório contendo o controle para o qual está definindo a propriedade. Se o formulário ou o relatório não estiver aberto, você poderá usar a ação AbrirFormulário ou a ação AbrirRelatório para abri-lo ou selecioná-lo. Se o formulário ou o relatório já estiver aberto, use a ação SelecionarObjeto para selecioná-lo. Depois use a ação DefinirPropriedade para definir a propriedade. A seleção do objeto não será necessária se você usar a ação DefinirPropriedade em uma macro que esteja inserida em um controle do mesmo formulário ou relatório como o controle para o qual você está definindo a propriedade.

• Para executar a ação DefinirPropriedade em um módulo do VBA, use o método SetProperty do objeto DoCmd.

Exemplo

O exemplo a seguir mostra como usar a ação SetProperty para alternar a visibilidade da caixa de texto MyTextBox .

Código de exemplo fornecido por: a Referência do programador do Microsoft Access 2010.

    Submacro: TestVisible
        SetProperty
            Control Name Text40
            Property Visible
            Value =Not[Text40].[Visible]
    End Submacro