Partager via


COleSafeArray::Create

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

COleSafeArray, classe

Graphique de la hiérarchie

Autres ressources

SafeArrayCreate