Quais objetos do Excel são baseados em zero e quais são baseados em um?

20

O uso do VBA para acessar a primeira planilha em uma planilha é Planilhas (1). O primeiro item em um ListBox é myListBox.List (0). Ouvi dizer que as coleções são baseadas em 1, mas não sei o que são. Matrizes VBA são baseadas em 0. As funções de seqüência de caracteres do Excel como MID são baseadas em 1. Existe um princípio geral sobre o que é baseado em 0 ou 1, ou você poderia fornecer uma lista de cada um?

Noumenon
fonte
cell (1,1) .characters (index, length) é baseado em 1, mas faz algum tipo de recorte de limite para que cell (1,1) .characters (0, length) = cell (1,1) .characters (1, comprimento) (excel 2013)
seanv507

Respostas:

24

Existem 3 tipos principais de construções de agrupamento disponíveis no VBA, com distinções entre índices

  • Coleções - índice baseado em 1

    • Exceções baseadas em 0: coleções UserForm, como guias, páginas, controles (ListBox, TextBox)
    • Coleções são objetos nativos do Excel que contêm grupos (ou listas) de objetos logicamente relacionados
    • Normalmente usado para armazenar objetos complexos, mas também para tipos básicos
    • Coleções do Excel:

      • Pastas de trabalho, folhas, intervalos, formas
      • Planilhas (1) é o primeiro no arquivo, Células (1, 1) é a célula na primeira linha e na primeira coluna
    • A principal vantagem das coleções é a conveniência de acessar elementos pelo nome

      • O loop For-Each é muito eficiente (comparado ao processamento de arrays For-Each)
      • Porém, acessar itens individuais por índice é mais rápido do que acessá-los por nome

  • Matrizes - baseadas em 0 por padrão, mas o primeiro índice pode ser alterado para qualquer número (ilustrado abaixo)

    • Matrizes são variáveis ​​que contêm um conjunto de variáveis ​​relacionadas
    • Normalmente usado para tipos de dados primitivos como Booleano, Inteiro, Longo, String, Duplo, etc
    • Uma vez definido, ele conterá apenas um tipo de itens: Dim x() As Long

      • Para conter objetos mais complexos, uma matriz pode ser definida como Dim x() As Variant
      • As variantes podem ser qualquer tipo de objeto, incluindo pastas de trabalho, planilhas, intervalos e matrizes

        • Dim x As Variant: x = Array(1) '1 Variant variable containing 1 array
        • Dim y(2) As Variant '1 Variant array containing 3 arrays
        • y(0) = Array(1): y(1) = Array(2): y(2) = Array(3)
    • A principal vantagem das matrizes é o desempenho ao acessar itens por índice

      • For index=0 To 10loops são mais rápidos que For-Eachloops

  • Dicionários - não indexados, mas os índices podem ser simulados com Chaves

    • Nativo para script VB, não VBA (deve usar uma biblioteca externa)
    • Pode conter qualquer tipo de objeto, incluindo matrizes, coleções ou outros dicionários

Um ListBox é um objeto complexo e pode ser acessado através da coleção de controles baseada em 0

A propriedade .List () do ListBox é uma matriz baseada em 0

Outras notas

  • Índices baseados em 0 são o padrão para outros idiomas

  • O VBA introduziu o conceito baseado em 1 para torná-lo mais intuitivo para novos usuários:

    • Folha1 a Folha3, com contagem de coleção de 3 mais fácil de usar do que
    • Folha0 a Folha2, com coleção Contagem de 3

Alguns exemplos práticos da diferença entre seus índices:

Public Sub vbaCollections()
    Dim c As New Collection     '1-based index

    c.Add Item:="a", Key:="1"   'index 1; Key must a String
    c.Add Item:="b", Key:="2"   'index 2
    c.Add Item:="c", Key:="3"   'index 3

    Debug.Print c.Count         '3;   Items in index sequence: a,b,c, Keys: "1","2","3"
    Debug.Print c.Item(1)       'a;   not available for Dictionaries
    'Debug.Print c.Key("1")     'invalid, so is: c.Key(1)

    c.Remove Index:=2
    Debug.Print c.Count         '2;   items in index sequence: a,c, Keys: "1","3"
    'c.Remove Item:="c"         'invalid, so is: c.Remove Key:="3"

    'c.Add Item:="c", Key:="3", Before:=1   'Key must be unique - Error
    c.Add Item:="c", Key:="5", Before:=1    'allows duplicate Item
    Debug.Print c.Count         '3;   items in index sequence: c,a,c, Keys: "5","1","3"
End Sub

Public Sub vbaArrays()
    Dim a() As Long, b(3) As Long   'Arrays default to "Option Base {0 | 1}"
    Dim c(0 To 0)                   'if "Option Base" not defined, it defaults to 0
    Dim ar(1) As Worksheet: Set ar(0) = Worksheets(1)   'array with 1 Worksheets object

    ReDim a(3)          'creates an array of 4 elements; indexes 0,1,2,3
        Debug.Print "LB: " & LBound(a) & ", UB: " & UBound(a)   'LB: 0, UB: 3
        Debug.Print UBound(a) - LBound(a)                       '3, array b() is the same

    'even whith "Option Base 1", the following still default to 0
    Dim v As Variant:  v = Split("A B")         'array with 2 items: v(0) = "A", v(1) = "B"
    'UserForm1.ListBox1.List = Array("Test")    'array with 1 item: .List(0,0) = "Test"

    ReDim a(0 To 3)     'creates an array of 4 elements; indexes 0,1,2,3
    a(0) = 1:   a(1) = 2:   a(2) = 3    'a(3) defaults to 0

        Debug.Print "LB: " & LBound(a) & ", UB: " & UBound(a)   'LB: 0, UB: 3
        Debug.Print UBound(a) - LBound(a)                       '3; offset index by -1

    ReDim a(1 To 3)     'creates an array of 3 elements; indexes 1,2,3
    a(1) = 1:   a(2) = 2:   a(3) = 3

        Debug.Print "LB: " & LBound(a) & ", UB: " & UBound(a)   'LB: 1, UB: 3
        Debug.Print UBound(a) - LBound(a)                       '2; offset count by +1

    ReDim a(5 To 7)     'creates an array of 3 elements; indexes 5,6,7
    a(5) = 1:   a(6) = 2:   a(7) = 3

        Debug.Print "LB: " & LBound(a) & ", UB: " & UBound(a)   'LB: 5, UB: 7
        Debug.Print UBound(a) - LBound(a)                       '2; offset count by +1

    ReDim a(-3 To -1)   'creates an array of 3 elements; indexes -3,-2,-1
    a(-3) = 1:  a(-2) = 2:  a(-1) = 3

        Debug.Print "LB: " & LBound(a) & ", UB: " & UBound(a)   'LB: -3, UB: -1
        Debug.Print UBound(a) - LBound(a)                       '2; offset count by +1
End Sub

Public Sub vbsDictionaries()
    Dim d As Object         'not indexed (similar to linked lists)
    Set d = CreateObject("Scripting.Dictionary")    'native to VB Script, not VBA

    d.Add Key:="a", Item:=1 'index is based on Key (a, b, c)
    d.Add Key:="b", Item:=2
    d.Add Key:="c", Item:=3
    Debug.Print d.Count     '3; Keys: a,b,c, Items: 1,2,3

    Debug.Print d(1)        'output is empty ("") - adds new element: Key:="1", Item:=""
    Debug.Print d.Count     '4; Keys: a,b,c,1, Items: 1,2,3,Empty
    Debug.Print d("a")      '1
    Debug.Print d(1)        'output is Empty ("") from element with Key:="1"

    'd.Add Key:="b", Item:=2        'attempt to add existing element: Key:="b" - Error

    'd.Keys  - 0-based array (not available for Collections)
    'd.Items - 0-based array (not available for Collections)

    d.Remove d.Keys()(1)            'remove element Item:=2 (Key:="b")
        Debug.Print d.Count         '3; Keys: a,c,1, Items: 1,3,""
    d.Remove d.Items()(0)           'remove Items element 0 (Key:="1", Item:="")
        Debug.Print d.Count         '2; Keys: a,c, Items: 1,3
    d.Remove "c"                    'remove element Key:="c" (Item:=3)
        Debug.Print d.Count         '1; Keys: a, Items: 1

    d.Add Key:="c", Item:=3
        Debug.Print d.Count         '2; Keys: a,c, Items: 1,3

    'd.Remove d.Items()(0)          'invalid
    Debug.Print d.Items()(d.Count - 1)  '3
    d.Remove d.Keys()(d.Count - 1)  'remove last element; access last Key by Key
        Debug.Print d.Count         '1; Keys: a, Items: 1

    Debug.Print d.Exists("a")       'True (not available for Collections)
    Debug.Print d.Exists(2)         'False
End Sub

Leitura adicional:

paul bica
fonte