Mostrar tudo

Ocultar tudo

Devolve uma Variante (tipo de dados Variante: tipo de dados predefinido para variáveis que não possuem caracteres de declaração de tipo quando uma instrução do tipo Def não está em vigor. Uma Variante pode armazenar dados numéricos, de cadeia, de data/hora, Nulo ou Vazio.) (Data (matriz: variável que contém um número finito de elementos com um nome e um tipo de dados comuns. Cada elemento de uma matriz é identificado por um número de índice exclusivo. As alterações efectuadas num elemento de uma matriz não afectam os outros elementos.)).

Sintaxe

Matriz(listaarg)

O argumento (argumento: valor que fornece informações a uma acção, evento, método, propriedade, função ou procedimento.) listaarg obrigatório é uma lista, delimitada por vírgulas, de valores que estão atribuídos aos elementos da matriz incluída na Variante. Se não estiverem especificados argumentos, é criada uma matriz de comprimento zero.

Observações

A notação utilizada para fazer referência a um elemento de uma matriz é composta pelo nome da variável (variável: um local de armazenamento com nome que pode conter dados que é possível modificar durante a execução do programa. Cada variável possui um nome que a identifica exclusivamente no respectivo nível de âmbito. Um tipo de dados pode ser ou não especificado.), seguido de parênteses que incluem um número de índice, que indica o elemento pretendido. No exemplo seguinte, a primeira instrução (instrução: unidade sintacticamente completa que expressa um tipo específico de operação, declaração ou definição. Normalmente, uma instrução aparece numa linha de um procedimento ou na secção de declarações, mas também é possível aparecerem duas ou mais instruções numa linha, separadas por dois pontos (:).) cria uma variável com o nome A como uma Variante. A segunda instrução atribui uma matriz à variável A. A última instrução atribui o valor incluído no segundo elemento da matriz a outra variável.

Dim A As Variant
A = Array(10,20,30)
B = A(2)

O vínculo inferior de uma matriz criada utilizando a função Matriz é determinado pelo vínculo inferior especificado com a instrução Base de Opção, a menos que a Matriz esteja qualificada com o nome da biblioteca de tipos (por exemplo VBA.Matriz). Se estiver qualificado com o nome da biblioteca de tipos, a Matriz não é afectada pela Base de Opção.

 Nota   Uma Variante que não está declarada como uma matriz pode incluir uma matriz. Uma variável Variante pode incluir uma matriz de qualquer tipo, excepto cadeias de comprimento fixo e tipos definidos pelo utilizador (tipo de dados definido pelo utilizador: numa base de dados do Microsoft SQL Server é uma definição do tipo de dados que uma coluna pode conter. O tipo é definido pelo utilizador com base nos tipos de dados existentes no sistema. As regras e predefinições apenas podem estar dependentes de tipos de dados definidos pelo utilizador.). Apesar de uma Variante que contém uma matriz ser conceptualmente diferente de uma matriz em que os elementos são de tipo Variante, os elementos de matriz são acedidos da mesma forma.

Exemplo

Este exemplo utiliza a função Matriz para devolver uma Variante que contém uma matriz.

Dim MyWeek, MyDay
MyWeek = Array("Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun")
' Return values assume lower bound set to 1 (using Option Base
' statement).
MyDay = MyWeek(2)    ' MyDay contains "Tue".
MyDay = MyWeek(4)    ' MyDay contains "Thu".