COleSafeArray::Create

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

配列にデータを割り当て、初期化します。

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

パラメータ

vtSrc
配列の基本の型 (配列の各要素の VARTYPE)。VARTYPE は、バリアント型のサブセットに限定されます。VT_ARRAY フラグと VT_BYREF フラグは設定できません。VT_EMPTY と VT_NULL は、この配列の有効な基本型ではありません。その他の型は有効です。
dwDims
配列の次元数。配列の作成後でも Redim を使用して変更できます。
rgElements
配列の各次元の要素数が入っている配列へのポインタ。
rgsabounds
配列に割り当てる境界のベクタ (各次元に 1 つ) へのポインタ。

解説

必要に応じて、現在の配列データをクリアします。エラーの場合、関数は CMemoryException クラスをスローします。

使用例

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