CArchive::SetLoadParams

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

更新 : 2007 年 11 月

SetLoadParams は、大量の CObject 派生オブジェクトをアーカイブから読み込むときに呼び出します。

void SetLoadParams(
   UINT nGrowBy = 1024 
);

パラメータ

nGrowBy
サイズを増やす必要があるときに、確保する要素スロットの最小数を指定します。

解説

CArchive は、読み込み配列を使用して、アーカイブに格納されているオブジェクトへの参照を解決します。SetLoadParams を使用すると、読み込み配列の拡張する大きさに、サイズを設定できます。

オブジェクトを読み込んだ後や、MapObject または ReadObject を呼び出した後は、SetLoadParams を呼び出すことはできません。

使用例

class CMyLargeDocument : public CDocument
{
public:
   virtual void Serialize(CArchive& ar);
};
void CMyLargeDocument::Serialize(CArchive& ar)
{
   if (ar.IsStoring())
      ar.SetStoreParams();  // use large defaults
   else
      ar.SetLoadParams();

   if (ar.IsStoring())
   {
      // code for storing CMyLargeDocument
   }
   else
   {
      // code for loading CMyLargeDocument
   }
}