Partilhar via

COleSafeArray::Create

  • Artigo

Atribui e inicializa os dados da matriz.

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

Parâmetros

  • vtSrc
    O tipo base da matriz (isto é, VARTYPE de cada elemento da matriz).VARTYPE é restrito a um subconjunto de tipos variantes.VT_ARRAY nem nem o sinalizador de VT_BYREF podem ser definidas.VT_EMPTY e VT_NULL são inválidos tipos base para a matriz.Todos os outros tipos são legais.

  • dwDims
    Número de dimensões na matriz.Isso pode ser modificado após a matriz é criada com Redim.

  • rgElements
    Ponteiro para uma matriz o número de elementos para cada dimensão da matriz.

  • rgsabounds
    Ponteiro para um vetor de limites (um para cada dimensão) para atribuir para a matriz.

Comentários

Essa função desmarcará os dados atuais de matriz se necessário.Em erro, a função gera 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);

Requisitos

Cabeçalho: afxdisp.h

Consulte também

Referência

Classe de COleSafeArray

Gráfico de hierarquia

SafeArrayCreate