Propriedade Form.OnInsert (Access)

Define ou retorna o valor da caixa de ferramentas Antes de inserir na janela Propriedades de um formulário. String de leitura/gravação.

Sintaxe

expressão. OnInsert

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

Comentários

Esta propriedade é útil para alterar programaticamente a ação que o Microsoft Access realiza quando um evento é acionado. Por exemplo, você pode alterar os parâmetros de uma expressão entre as chamadas de eventos ou alternar entre um procedimento de evento e uma expressão ou uma macro, dependendo das circunstâncias nas quais o evento foi disparado.

Embora o nome da propriedade seja OnInsert, a configuração dessa propriedade realmente define o valor da caixa Antes de inserir.

O evento BeforeInsert ocorre quando o usuário digita o primeiro caractere em um novo registro, mas antes do registro é realmente criado.

O valor OnInsert será um dos seguintes, consoante a seleção escolhida na janela Escolher Construtor (aceda ao selecionar o botão Criar junto à caixa Antes de Inserir no janela Propriedades do formulário):

• Se escolher Construtor de Expressões, o valor será =expressão, em que expressão é a expressão da janela do Construtor de Expressões.

• Se escolher Construtor de Macros, o valor é o nome da macro.

• Se escolher o Construtor de Código, o valor será [Procedimento de Evento].

Se a caixa Antes de inserir estiver em branco, o valor da propriedade será uma sequência de caracteres vazia.

Exemplo

O exemplo seguinte imprime o valor da propriedade OnInsert na janela Imediato do formulário Entrada de Encomenda .

Debug.Print Forms("Order Entry").OnInsert

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.