Coleções de Objetos

Objetos é o conjunto de propriedades e que geram comportamentos. Por exemplo a janela do Editor do Visual Basic for Applications, como qualquer outra janela, tem seu comportamento: pode ser aberta, fechada, redimensionada, movida, minimizada.

Propriedades

As propriedades são características que o objeto possui, como por exemplo: nome, cor, tamanho, ícone, etc. São palavras reservadas, parecidas com instruções.

Métodos

Da mesma forma que ocorre com as propriedades, só que os métodos seus valores não podem ser alterados.

Eventos

São comportamentos gerados pelo usuário, como por exemplo: o ato de clicar, duplo-clique, mover o mouse sobre um objeto, etc.

Objetos mais utilizados no Excel

Os Objetos mais utilizados no Excel são: Application, WorkBook, WorkSheet e Range.

Application

Application é o objeto de topo hierárquico, representa o próprio Excel.

Propriedades:

Propriedades

Caption

Menção exibida na barra de títulos do Excel

 

DisplayAlerts

TRUE – as mensagens de alerta são exibidas durante a execução da subrotina. False caso contrário. Exemplo:

Sub excluirPlanilha()
Application.DisplayAlerts = False ' Desabilita a exibição de mensagens de aviso
Sheets("Plan2").Delete
MsgBox "A planilha foi excluída com sucesso!"
Application.DisplayAlerts = True ' Habilita a exibição de mensagens
Sheets("Plan3").Delete
MsgBox "A planilha foi excluída com sucesso!"
End Sub

Path

Nome da directoria onde o Excel está instalado.

 

ScreenUpdating

True – altera o écran (tela) consoante a subrotina que executa. Caso contrário, o écran não é alterado durante a execução da subrotina.

 

WindoWorkSheetState

O estado da janela da aplicação:

XlNormal – janela tamanho normal

XlMaximized – janela tamanho maximizado

XlMinimized – janela com tamanho minimizado

 

DisplayStatusBar

Mostra ou esconde a StatusBar.

True – exibe

 

 

onKey

Permite habilitar ou desabilitar tecla de atalho.

Application.OnKey "^a", "" ' Desabilita o atalho Ctrl + A

Application.OnKey "^a" ' Habilita o atalho Ctrl + A

FullName

Exibe o caminho e o nome da pasta.

Range("a1").Value = Workbooks(1).FullName

 

 

DisplayFormulaBar

Mostra ou esconde a Barra de Formulas

True – exibe. Exemplo:

Sub barraFormula()
Application.DisplayFormulaBar = False ' Oculta a barra de fórmula
MsgBox "A barra de fórmula foi Desabilitada!"
Application.DisplayFormulaBar = True ' Exibe a barra de fórmula
MsgBox "A barra de fórmula foi Habilitada!"
End Sub

 

Eventos do WorkSheet - Exemplos:

Private Sub Worksheet_Activate()
Range("A2").Value = ""
Range("A1").Value = "Evento Activate"
MsgBox "Plan1 está selecionada"
End Sub

Private Sub Worksheet_BeforeDoubleClick(ByVal Target As Range, Cancel As Boolean)
Range("A1").Value = "Evento Duplo Click"
Range("A2").Value = Target.Address
End Sub

Private Sub Worksheet_Deactivate()
Range("A2").Value = ""
Range("A1").Value = "Evento Deactivate"
MsgBox "Plan1 perdeu a seleção"
End Sub

Private Sub Worksheet_SelectionChange(ByVal Target As Range)
Range("A1").Value = "O intervalo de células selecionado é " & Target.Address
Range("A2").Value = "Existem " & Target.Count & " célula(s) selecionada(s)"
End Sub

Métodos

Métodos

Calculate

Implica o cálculo de todas as fórmulas de todas as WorkSheet e WorkBookS abertos.
Argumentos : não tem

Help

Exibe um tópico do Help de um determinado arquivo de Help.
Argumentos:
Helpfile: nome do ficheiro, incluindo a path se necessário
Helpcontextid: número que faz referência ao índice de help

Quit

Fecha aplicação do Excel. (se a propriedade Display alerts estiver com o valor False, o Excel não solicitará a gravação de alterações nos arquivos).
Argumentos : não tem

Run

Utilizado para executar uma subrotina de VBA ou uma Macro.
Argumentos :
Macro: nome da macro ou subrotina a executar

WorkBook

O Objeto WorkBook, na hierarquia de objetos segue de imediato o objeto application e representa um arquivo do Excel.

Propriedades

Propriedades

Name

Nome do arquivo. Não permite a alteração do nome, para isso é necessário proceder ao Save/As.

Path

Pasta onde o arquivo se encontra.

Saved

True – se não houve nenhuma alteração no arquivo desde a última gravação.
False – caso contrário
Exemplo:
If not(activeWorkbook.Saved) Then
ActiveWorkbook.Save
End If

Métodos

Métodos

Activate

Ativa um documento (pasta) aberto. Equivalente a ir ao Window e selecionar um documento aberto, trazendo-o para a janela principal do Excel.
Argumentos: não tem

Close

Fecha um documento.
Argumentos:
SaveChanges – se True, o documento é gravado antes de ser fechado; False caso contrário.
FileName – se o argumento SaveChanges estiver a TRUE, o WorkBook é gravado com o nome aqui indicado.
RoutWorkBook – se TRUE e o WorkBook tiver endereços para envio atribuídos, envia o ficheiro por e-mail antes de fechar, caso contrário não.

Protect

Protege um documento contra qualquer tipo de alteração.
Argumentos:
Password: Password a utilizar na proteção.
Structure: True protege também a estrutura.
WindoWorkSheet: True a estrutura do WorkBook na janela é protegida.

Save

Grava o WorkBook.
Argumentos: Não Tem.

SaveCopyAs

Cria uma cópia do documento em questão.
Argumentos:
FileName: nome da cópia pretendida para o arquivo.

WorkSheet

Na hierarquia situa-se abaixo do objeto WorkBook, uma vez que um WorkBook é constituído por um conjunto de WorkSheets.

Propriedades

Propriedades

Index

Índice de uma WorkSheet num WorkBook.

Name

Nome da WorkSheet.

UsedRange

Traduz o range na WorkSheet que contêm dados.

Visible

True – está visível.False – está escondida, mas o utilizador pode vizualizá-la recorrendo ao Menu Format.
XlVeryHidden – está escondida e ninguém a pode visualizar, a menos que volte a aplicar uma subrotina que a coloque visível.

 

Métodos

Métodos

Activate

Ativa uma determinada WorkSheet. Equivalente a estarmos a trabalhar num WorkBook e clicarmos nela para visualizarmos o seu conteúdo.
Argumentos: Não Tem

Calculate

Faz o cálculo de todas as fórmulas constantes da WorkSheet.
Argumentos: Não Tem

Delete

Apaga uma WorkSheet do WorkBook.
Argumentos: Não Tem

Protect

Protege uma WorkSheet contra qualquer tipo de alteração.
Argumentos:
Password: Password a utilizar na proteção.
DrawingObjects: True- protege os objectos gráficos.
Contents – True- protege as células e conteúdos.
Scenarios – True – protege os cenários referente à WorkSheet
UserInterfaceOnly – True – protege os interfaces contra alterações apesar de poder alterar as subrotinas.

Cell

Referência uma célula, através dos seus índices numéricos.
Argumentos:
Número da Linha
Número da Coluna
Ex: Célula C5 será representado por Cells( 5, 3)

Range

Objeto utilizado para representar uma ou mais células de uma WorkSheet.

Propriedades

Propriedades

Count

Número de Células num Range. Read-Only

Dependents

Retorna um range, que contém todos os dependentes (valores indexados pelas fórmulas) do range em questão. Read-Only

Name

Nome de um range. Read/Write

Value

Valor constante de um range (célula ou conjunto de células). Read/Write

Formula

Traduz a fórmula contida num range como uma string.
Read/Write

Text

Busca o conteúdo de uma célula mas em formato de texto.

Métodos

Métodos

Calculate

Faz o cálculo da fórmula constantes do range.
Argumentos: Não Tem

ClearContents

Apaga o conteúdo (fórmulas e valores) de uma célula, deixando os formatos.
Argumentos: Não Tem

Copy

Copia o conteúdo de um range para um outro de igual dimensão ou então para o clipboard.
Argumentos:
Destination – range para o qual os valores vão ser copiados (na ausência deste parâmetro a cópia é feita para o clipboard)

OffSet

Provoca um deslocamento de um determinado número de linhas e de colunas, tendo como base o range ao qual este método está a ser aplicado.
Argumentos:
RowOffset – número de linhas que se desloca
ColumnOffset – número de colunas que se desloca

EntireRow

Faz referência à(s) linha(s) indicadas por um determinado range.
Argumentos: Não Tem

Select

Seleciona o range em questão.
Argumentos:
Replace- (Opcional)

Cell

Referência uma célula, através dos seus índices numéricos.
Argumentos:
Número da Linha
Número da Coluna
Ex: Célula C5 será representado por Cells( 5, 3)