Objeto UserForm

  • Artigo

Um objetoUserForm é uma janela ou caixa de diálogo que compõe parte da interface do usuário de um aplicativo.

A coleçãoUserForms é uma coleção cujos elementos representam cada UserForm carregado em um aplicativo. A coleção UserForms tem uma propriedade Count , um método Item e um método Add . A contagem especifica o número de elementos na coleção; Item (o membro padrão) especifica um membro de coleção específico; Adicionar coloca um novo elemento UserForm na coleção.

Sintaxe

UserFormUserForms [ . Item ] (índice)

O índice de espaço reservado representa um inteiro com um intervalo de 0 a UserForms.Count – 1. Item é o membro padrão da coleção UserForms e não precisa ser especificado.

Comentários

Use a coleção UserForms para iterar todos os formulários de usuário carregados em um aplicativo. Ele identifica uma variável global intrínseca chamada UserForms. Você pode passar UserForms(index) para uma função cujo argumento é especificado como uma classe UserForm .

Os formulários de usuário têm propriedades que determinam a aparência, como posição, tamanho e cor; e aspectos de seu comportamento.

Os formulários de usuário também podem responder a eventos iniciados por um usuário ou disparados pelo sistema. Por exemplo, você pode escrever código no procedimento de evento Initialize do UserForm para inicializar variáveis no nível do módulo antes que o UserForm seja exibido.

Além de propriedades e eventos, você pode usar métodos para manipular formulários de usuário usando código. Por exemplo, você pode usar o método Move para alterar o local e o tamanho de um UserForm.

Ao criar formulários de usuário, defina a propriedade BorderStyle para definir bordas e defina a propriedade Caption para colocar texto na barra de título. No código, você pode usar os métodos Ocultar e Mostrar para tornar um UserForm invisível ou visível em tempo de execução.

UserForm é um tipo de dados object. Você pode declarar variáveis como tipo UserForm antes de defini-las como uma instância de um tipo de UserForm declarado no momento do design. Da mesma forma, você pode passar um argumento para um procedimento como tipo UserForm. Você pode criar várias instâncias de formulários de usuário em código usando a nova palavra-chave em instruções Dim, Set e Static .

Acesse a coleção de controles em um UserForm usando a coleção Controls . Por exemplo, para ocultar todos os controles em um UserForm, use código semelhante ao seguinte.

For Each Control in UserForm1.Controls
    Control.Visible = False
Next Control

Confira também

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.