Dos objetos utilizados para programação VBA no Excel, sem dúvidas Range é aquele com utilização mais frequente.
Alterar a cor de preenchimento, inserir valores e alterar o tamanho da fonte são exemplos comuns de ações realizadas durante a execução de macros. Estas ações são modificações de Propriedades do objeto Range.
Extraímos do help do Excel a lista de propriedades a seguir.
Nome | Descrição |
AddIndent | Retorna ou define um valor Variant que indica se o texto será recuado automaticamente quando o alinhamento de texto em uma célula for definido como distribuição igual (horizontal ou verticalmente). |
Address | Retorna um valor String que representa a referência de intervalo no idioma da macro. |
AddressLocal | Retorna a referência ao intervalo do intervalo especificado no idioma do usuário. String de Leitura/gravação |
AllowEdit | Retorna um valor Boolean que indica se o intervalo pode ser editado em uma planilha protegida. |
Application | Ao ser usada sem um qualificador de objeto, essa propriedade retorna um objeto Application que representa o aplicativo Microsoft Excel. Ao ser usada com um qualificador de objeto, essa propriedade retorna um objeto Application que representa o criador do objeto do especificado (é possível usar essa propriedade com um objeto de automação OLE para retornar o aplicativo desse objeto). Somente leitura. |
Areas | Retorna uma coleção Areas representando todos os intervalos em uma seleção de várias áreas. Somente leitura. |
Borders | Retorna uma coleção Borders que representa as bordas de um estilo ou de um intervalo de células (inclusive um intervalo definido como parte de um formato condicional). |
Cells | Retorna um objeto Range que representa as células no intervalo especificado. |
Characters | Retorna um objeto Characters representando um intervalo de caracteres dentro do texto do objeto. Você pode usar o objeto Characters para formatar caracteres dentro de uma seqüência de caracteres de texto. |
Column | Retorna o número da primeira coluna na primeira área do intervalo especificado. Long somente leitura |
Columns | Retorna um objeto Range que representa as colunas no intervalo especificado. |
ColumnWidth | Retorna ou define a largura de todas as colunas no intervalo especificado. Variant de leitura/gravação |
Comment | Retorna um objeto Comment que representa o comentário associado à célula do canto superior esquerdo do intervalo. |
Count | Retorna um valor Long que representa o número de objetos na coleção. |
CountLarge | Somente leitura. |
CurrentArray | Quando a célula especificada é parte de uma matriz, retorna um objeto Range representando toda a matriz. Somente leitura. |
CurrentRegion | Retorna um objeto Range representando a região atual. A região atual é um intervalo limitado por qualquer combinação de linhas e colunas em branco. Somente leitura. |
Dependents | Retorna um objeto Range que representa o intervalo contendo todos os dependentes de uma célula. Isso pode ser uma seleção múltipla (uma união de objetos Range) se houver mais de um dependente. Objeto Range somente leitura. |
DirectDependents | Retorna um objeto Range que representa o intervalo contendo todos os dependentes diretos de uma célula. Isso pode ser uma seleção múltipla (uma união de objetos Range) se houver mais de um dependente. Objeto Range somente leitura. |
DirectPrecedents | Retorna um objeto Range que representa o intervalo contendo todos os precedentes diretos de uma célula. Isso pode ser uma seleção múltipla (uma união de objetos Range) se houver mais de um precedente. Objeto Range somente leitura. |
End | Retorna um objeto Range representando a célula no fim da região que contém o intervalo de origem. Equivalente a pressionar END+SETA PARA CIMA, END+SETA PARA BAIXO, END+SETA PARA A ESQUERDA ou END+SETA PARA A DIREITA. Objeto Range somente leitura. |
EntireColumn | Retorna um objeto Range representando a coluna (ou colunas) inteira que contém o intervalo especificado. Somente leitura. |
EntireRow | Retorna um objeto Range representando a linha (ou linhas) inteira que contém o intervalo especificado. Somente leitura. |
Errors | Permite que o usuário acesse opções de verificação de erros. |
Font | Retorna um objeto Font que representa a fonte do objeto especificado. |
FormatConditions | Retorna uma coleção FormatConditions representando todos os formatos condicionais do intervalo especificado. Somente leitura. |
Formula | Retorna ou define um valor Variant que representa a fórmula do objeto em notação de estilo A1 e no idioma da macro. |
FormulaArray | Retorna ou define a fórmula de matriz de um intervalo. Retorna (ou pode ser definida como) uma única fórmula ou uma matriz do Visual Basic. Se o intervalo especificado não contiver uma fórmula de matriz, essa propriedade retornará null. Variant de leitura/gravação |
FormulaHidden | Retorna ou define um valor Variant que indica se a fórmula ficará oculta quando a planilha for protegida. |
FormulaLocal | Retorna ou define a fórmula do objeto, usando referências de estilo A1 no idioma do usuário. Variant de leitura/gravação. |
FormulaR1C1 | Retorna ou define a fórmula do objeto, usando notação de estilo L1C1 no idioma da macro. Variant de leitura/gravação. |
FormulaR1C1Local | Retorna ou define a fórmula do objeto, usando notação de estilo R1C1 no idioma do usuário. Variant de leitura/gravação. |
HasArray | True se a célula especificada fizer parte de uma fórmula de matriz. Variant somente leitura |
HasFormula | True se todas as células no intervalo contiverem fórmulas; False se nenhuma das células no intervalo contiver uma fórmula; null caso contrário. Variant somente leitura |
Height | Retorna ou define um valor Variant que representa a altura, em pontos, do intervalo. |
Hidden | Retorna ou define um valor Variant que indica se as linhas ou colunas estão ocultas. |
HorizontalAlignment | Retorna ou define um valor Variant que representa o alinhamento horizontal do objeto especificado. |
Hyperlinks | Retorna uma coleção Hyperlinks que representa os hiperlinks do intervalo. |
ID | Retorna ou define um valor String que representa o rótulo de identificação da célula especificada quando a página é salva como página da Web. |
IndentLevel | Retorna ou define um valor Variant que representa o nível de recuo da célula ou o intervalo. Pode ser um inteiro de 0 a 15. |
Interior | Retorna um objeto Interior que representa o interior do objeto especificado. |
Item | Retorna um objeto Range representando um intervalo em um deslocamento para o intervalo especificado. |
Left | Retorna um valor Variant que representa a distância, em pontos, entre o limite esquerdo da coluna A e o limite esquerdo do intervalo. |
ListHeaderRows | Retorna o número de linhas de cabeçalho do intervalo especificado. Long somente leitura. |
ListObject | Retorna um objeto ListObject referente ao objeto Range. ListObject somente leitura. |
LocationInTable | Retorna uma constante que descreve a parte do relatório de tabela dinâmica que contém o canto superior esquerdo do intervalo especificado. Pode ser uma das constantes XlLocationInTable a seguir. Long somente leitura. |
Locked | Retorna ou define um valor Variant que indica se o objeto está bloqueado. |
MDX | Somente leitura. |
MergeArea | Retorna um objeto Range representando o intervalo mesclado que contém a célula especificada. Se a célula especificada não estiver em um intervalo mesclado, essa propriedade retornará a célula especificada. Variant somente leitura. |
MergeCells | True se o intervalo contiver células mescladas. Variant de leitura/gravação. |
Name | Retorna ou define um valor Variant que representa o nome do objeto. |
Next | Retorna um objeto Range que representa a próxima célula. |
NumberFormat | Retorna ou define um valor Variant que representa o código de formatação do objeto especificado. |
NumberFormatLocal | Retorna ou define um valor Variant que representa o código de formatação do objeto como uma seqüência de caracteres no idioma do usuário. |
Offset | Retorna um objeto Range que representa um intervalo que é deslocado do intervalo especificado. |
Orientation | Retorna ou define um valor Variant que representa a orientação do texto. |
OutlineLevel | Retorna ou define o nível de tópico atual da linha ou coluna especificada. Variant de leitura/gravação. |
PageBreak | Retorna ou define a posição de uma quebra de página. Pode ser uma das seguintes constantes XlPageBreak: xlPageBreakAutomatic,xlPageBreakManual ou xlPageBreakNone. Long de leitura/gravação. |
Parent | Retorna o objeto pai do objeto especificado. Somente leitura. |
Phonetic | Retorna o objeto Phonetic, que contém informações sobre uma determinada seqüência de caracteres de texto fonético em uma célula. |
Phonetics | Retorna a coleção Phonetics do intervalo. Somente leitura. |
PivotCell | Retorna um objeto PivotCell que representa uma célula em um relatório de tabela dinâmica. |
PivotField | Retorna um objeto PivotField representando o campo de tabela dinâmica que contém o canto superior esquerdo do intervalo especificado. |
PivotItem | Retorna um objeto PivotItem representando o item de tabela dinâmica que contém o canto superior esquerdo do intervalo especificado. |
PivotTable | Retorna um objeto PivotTable que representa o relatório de tabela dinâmica que contém o canto superior esquerdo do intervalo especificado. |
Precedents | Retorna um objeto Range que representa todos os precedentes de uma célula. Pode ser uma seleção múltipla (uma união de objetos Range) caso haja mais de um precedente. Somente leitura. |
PrefixCharacter | Retorna o caractere de prefixo da célula. Variant somente leitura. |
Previous | Retorna um objeto Range que representa a próxima célula. |
QueryTable | Retorna um objeto QueryTable que representa a tabela de consulta que intercepta o objeto Range especificado. |
Range | Retorna um objeto Range que representa uma célula ou um intervalo de células. |
ReadingOrder | Retorna ou define a ordem de leitura do objeto especificado. Pode ser uma das seguintes constantes : xlRTL (direita para esquerda), xlLTR (esquerda para direita) ou xlContext. Long de leitura/gravação. |
Resize | Redimensiona o intervalo especificado. Retorna um objeto Range representando o intervalo redimensionado. |
Row | Retorna o número da primeira linha da primeira área do intervalo. Long somente leitura. |
RowHeight | Retorna a altura de todas as linhas no intervalo especificado, medida em pontos. Retorna null se as linhas no intervalo especificado não tiverem todas a mesma altura. Variant de leitura/gravação. |
Rows | Retorna um objeto Range que representa as linhas no intervalo especificado. Objeto Range somente leitura. |
ServerActions | Somente leitura. |
ShowDetail | True se a estrutura de tópicos for expandida para o intervalo especificado (de modo que o detalhe da coluna ou linha esteja visível). O intervalo especificado precisa ser uma única linha ou coluna de resumo na estrutura de tópicos. Variant de leitura/gravação. Para o objeto PivotItem (ou o objeto Range se o intervalo estiver em um relatório de tabela dinâmica), esta propriedade será definida como True se o item estiver exibindo detalhe. |
ShrinkToFit | Retorna ou define um valor Variant que indica. |
SmartTags | Retorna um objeto SmartTags que representa o identificador da célula especificada. |
SoundNote | Essa propriedade não deve ser usada. As notas sonoras foram removidas do Microsoft Excel. |
Style | Retorna ou define um valor Variant, contendo um objeto Style, que representa o estilo do intervalo especificado. |
Summary | True se o intervalo for uma linha ou coluna de resumo de tópicos. O intervalo deve ser uma linha ou uma coluna. Variant somente leitura. |
Text | Retorna ou define o texto do objeto especificado. String somente leitura. |
Top | Retorna um valor Variant que representa a distância, em pontos, entre a parte superior da linha 1 e a parte superior do intervalo. |
UseStandardHeight | True se a altura de linha do objeto Range for igual à altura padrão da planilha. Retorna Null quando o intervalo contém mais de uma linha e nem todas as linhas têm a mesma altura. Variant de leitura/gravação. |
UseStandardWidth | True se a largura de coluna do objeto Range for igual à largura padrão da planilha. Retorna null quando o intervalo contém mais de uma coluna e nem todas as colunas têm a mesma largura. Variant de leitura/gravação. |
Validation | Retorna o objeto Validation representando a validação de dados do intervalo especificado. Somente leitura. |
Value | Retorna ou define um valor Variant que representa o valor do intervalo especificado. |
Value2 | Retorna ou define o valor da célula. Variant de leitura/gravação. |
VerticalAlignment | Retorna ou define um valor Variant que representa o alinhamento vertical do objeto especificado. |
Width | Retorna um valor Variant que representa a largura, em pontos, do intervalo. |
Worksheet | Retorna um objeto Worksheet representando a planilha que contém o intervalo especificado. Somente leitura. |
WrapText | Retorna ou define um valor Variant que indica se o Microsoft Excel faz retorno automático do texto no objeto. |
XPath | Retorna um objeto XPath que representa o Xpath do elemento mapeado para o objeto Range especificado. O contexto do intervalo determina se a ação terá êxito ou retornará um objeto vazio. Somente leitura. |
Deixe um comentário