COleSafeArray::criar

Artigo
08/25/2010

Aloca e inicializa os dados para o array.

void Create(
   VARTYPE vtSrc,
   DWORD dwDims,
   DWORD* rgElements 
);
void Create(
   VARTYPE vtSrc,
   DWORD dwDims,
   SAFEARRAYBOUND* rgsabounds 
);

Parâmetros

vtSrc
O tipo de base da matriz (ou seja, a VARTYPE de cada elemento da matriz).The VARTYPE está restrito a um subconjunto de tipos variantes.Nem o VT_ARRAY nor the VT_BYREF sinalizar pode ser conjunto.VT_EMPTY e VT_NULL inválido são tipos válido de base para a matriz.Todos os outros tipos são legais.
dwDims
Número de dimensões da matriz.Isso pode ser alterado depois da matriz é criada com Set.
rgElements
Ponteiro para uma matriz do número de elementos para cada dimensão da matriz.
rgsabounds
Ponteiro para um vetor de limites (um para cada dimensão) para alocar a matriz.

Comentários

Esta função limpará os dados corrente do array, se necessário.Em erro, a função lança um CMemoryException.

Exemplo

COleSafeArray saMatrix;
DWORD numElements[] = {10, 5};

// creates a 2 dimensional safearray of type VT_I2 
// with size 10x5 elements, with all indices starting at 0(default)
saMatrix.Create(VT_I2, 2, numElements);

ASSERT(saMatrix.GetDim() == 2);

COleSafeArray saVector;
SAFEARRAYBOUND rgsabounds[] = { {5, 2} };

// creates a 1 dimensional safearray of type VT_I1 
// with size 5 elements, with the index starting at 2
saVector.Create(VT_I1, 1, rgsabounds);

ASSERT(saVector.GetDim() == 1);