Partager via

COleSafeArray::Create

  • Article

Alloue et initialise les données de tableau.

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

Paramètres

  • vtSrc
    Le type de base du tableau (autrement dit, VARTYPE de chaque élément du tableau).VARTYPE est limité à un sous-ensemble de types variant.Ni VT_ARRAY ni la balise de VT_BYREF ne peut être défini.VT_EMPTY et VT_NULL sont les types de base non valides pour le tableau.Tous les autres types sont juridiques.

  • dwDims
    Nombre de dimensions du tableau.Cela peut être modifié après que le tableau soit créée avec Redim.

  • rgElements
    Pointeur vers un tableau du nombre d'éléments pour chaque dimension du tableau.

  • rgsabounds
    Pointeur vers un vecteur des limites (une pour chaque dimension) à allouer au tableau.

Notes

Cette fonction effacera les données actuelles de la matrice si nécessaire.Sur l'erreur, la fonction lève CMemoryException.

Exemple

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);

Configuration requise

Header: afxdisp.h

Voir aussi

Référence

Classe de COleSafeArray

Graphique de la hiérarchie

SafeArrayCreate