Noções básicas sobre objetos, métodos, propriedades e eventos

Artigo
04/07/2023

Objetos e coleções

Um objeto representa um elemento de um aplicativo, como uma planilha, uma célula, um gráfico, um formulário ou um relatório. No código do Visual Basic, você deve identificar um objeto antes de aplicar um dos métodos do objeto ou alterar o valor de uma das suas propriedades.

Uma coleção é um objeto que contém vários objetos, normalmente do mesmo tipo, mas nem sempre. No Microsoft Excel, por exemplo, o objeto Workbooks contém todos os objetos Workbook abertos. No Visual Basic, a coleção Forms contém todos os objetos Form em um aplicativo.

Os itens em uma coleção podem ser identificados por número ou por nome. Por exemplo, o seguinte procedimento identifica o primeiro objeto Workbook aberto.

Sub CloseFirst() 
    Workbooks(1).Close 
End Sub

O procedimento seguinte usa um nome especificado como uma cadeia de caracteres para identificar um objeto Form.

Sub CloseForm() 
    Forms("MyForm.frm").Close 
End Sub

Também é possível manipular uma coleção inteira de objetos se eles compartilharem os mesmos métodos. Por exemplo, o procedimento a seguir fecha todos os formulários abertos.

Sub CloseAll() 
    Forms.Close 
End Sub

Retornar objetos

Todos os aplicativos possuem uma maneira de retornar os objetos que contêm. No entanto, eles não são todos iguais. Assim, você deve consultar o tópico da Ajuda para o objeto ou coleção que está usando no aplicativo para ver como retornar o objeto.

Métodos

Um método é uma ação que um objeto pode executar. Por exemplo, Add é um método do objeto ComboBox, porque ele adiciona uma nova entrada para uma caixa de combinação.

O procedimento a seguir usa o método Add para adicionar um novo item à uma ComboBox.

Sub AddEntry(newEntry as String) 
    Combo1.Add newEntry 
End Sub

Propriedades

Uma propriedade é um atributo que define uma das características do objeto, como tamanho, cor ou localização na tela, ou um aspecto do comportamento dele, como se o objeto está habilitado ou visível. Para alterar as características de um objeto, deve-se alterar os valores de suas propriedades.

Para definir o valor de uma propriedade, siga a referência a um objeto com um período, o nome da propriedade, um sinal de igual (=) e o novo valor da propriedade. Por exemplo, o procedimento a seguir altera a legenda de um formulário do Visual Basic, definindo a propriedade Caption.

Sub ChangeName(newTitle) 
    myForm.Caption = newTitle 
End Sub

Algumas propriedades não podem ser configuradas. O tópico da Ajuda para cada propriedade indica se você pode configurar a propriedade (leitura/gravação), apenas ler a propriedade (somente leitura) ou apenas gravar na propriedade (somente gravação).

É possível recuperar as informações sobre um objeto retornando o valor de uma de suas propriedades. O procedimento a seguir usa uma caixa de mensagem para exibir o título que aparece na parte superior do formulário ativo no momento.

Sub GetFormName() 
    formName = Screen.ActiveForm.Caption 
    MsgBox formName 
End Sub

Eventos

Um evento é uma ação reconhecida por um objeto, como clicar com o mouse ou pressionar uma tecla e, para a qual é possível escrever um código para responder. Os eventos podem ocorrer como resultado de uma ação do usuário ou de um código do programa, ou podem ser disparados pelo sistema.

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.

Partilhar via