Propriedade Form.DefaultControl (Access)

A propriedade DefaultControl retorna um objeto Control com o qual você pode definir as propriedades padrão para um determinado tipo de controle em um formulário específico. Somente leitura.

Sintaxe

expressão. DefaultControl (ControlType)

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

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
ControlType	Obrigatório	Long	Uma constante AcControlType que indica o tipo de controle para o qual as configurações de propriedade padrão devem ser definidas.

Comentários

A propriedade DefaultControl permite que você defina as propriedades padrão de um controle do código. Depois de definir as propriedades padrão para um determinado tipo de controle, cada controle criado posteriormente desse tipo terá os mesmos valores padrão.

Por exemplo, se você definir a propriedade FontSize do botão de comando padrão como 12, cada novo botão de comando terá um tamanho de fonte de 12 pontos.

Nem todas as propriedades de um controle estão disponíveis como propriedades padrão. As propriedades padrão disponíveis para um controle dependem do tipo do controle.

A propriedade DefaultControl retorna um objeto Control do tipo especificado pelo argumento ControlType . Este objeto de controle não representa um controle real em um formulário, mas, em vez disso, um controle padrão que é um modelo para todas as subsequentemente criado controles desse tipo. Você definir o padrão para as propriedades de controle para o objeto de controle retornado pela propriedade DefaultControl da mesma maneira que você faria definir propriedades para um controle individual em um formulário.

A propriedade DefaultControl pode ser usada somente no modo Design do formulário ou modo Design do relatório. Se você tentar aplicar essa propriedade para um formulário ou relatório que não esteja no modo de Design, isso resultará em um erro em tempo de execução.

Se você tentar definir uma propriedade que não pode ser definida como uma propriedade padrão com a propriedade DefaultControl, isso resultará em um erro em tempo de execução. Para determinar quais propriedades podem ser propriedades padrão, liste a coleção Properties do objeto Control retornado pela propriedade DefaultControl.

Exemplo

O exemplo a seguir cria um novo formulário e usa a propriedade DefaultControl para retornar um objeto Control que representa o botão de comando padrão. O procedimento define algumas das propriedades padrão para o botão de comando e cria um novo botão de comando no formulário.

Sub SetDefaultProperties() 
 Dim frm As Form, ctlDefault As Control, ctlNew As Control 
 
 ' Create new form. 
 Set frm = CreateForm 
 ' Return Control object representing default command button. 
 Set ctlDefault = frm.DefaultControl(acCommandButton) 
 ' Set some default properties. 
 With ctlDefault 
 .FontWeight = 700 
 .FontSize = 12 
 .Width = 3000 
 .Height = 1000 
 End With 
 ' Create new command button. 
 Set ctlNew = CreateControl(frm.Name, acCommandButton, , , , 500, 500) 
 ' Set control's caption. 
 ctlNew.caption = "New Command Button" 
 ' Restore form. 
 DoCmd.Restore 
End Sub

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.