CArchive::MapObject

サブオブジェクトが参照できるように、外部ファイルにシリアル化せず、使用可能であるオブジェクトをマップに設定するには、このメンバー関数を呼び出します。

void MapObject(
   const CObject* pOb 
);

パラメーター

• pOb
  格納されているオブジェクトへの定数ポインター。

解説

たとえば、ドキュメントをシリアル化できない場合がありますが、ドキュメントの一部である項目をシリアル化します。MapObjectを呼び出して、それらの項目、またはサブオブジェクトが、文書を参照するようにします。また、シリアル化されたサブ項目は m_pDocument のバック ポインターをシリアル化できます。

であり、CArchive のオブジェクトから読み込むとき MapObject を呼び出すことができます。MapObject は、シリアル化および逆シリアル化の際に CArchive のオブジェクトによって維持される内部のデータ構造に、指定したオブジェクトを追加しますが ReadObject と WriteObject, とは異なりオブジェクトでシリアル化して呼び出すことはありません。

使用例

//MyDocument.h
class CMyDocument : public CDocument
{
public:
   DECLARE_SERIAL(CMyDocument)

   CObList m_listOfSubItems;

   virtual void Serialize(CArchive& ar);
};

//MyDocument.cpp
IMPLEMENT_SERIAL(CMyDocument, CDocument, 1)

void CMyDocument::Serialize(CArchive& ar)
{
   CDocument::Serialize(ar);

   if (ar.IsStoring())
   {
      // TODO: add storing code here
   }
   else
   {
      // TODO: add loading code here
   }

   ar.MapObject(this);  

   //serialize the subitems in the document;
   //they will be able to serialize their m_pDoc
   //back pointer
   m_listOfSubItems.Serialize(ar);
}

//SubItem.h
class CSubItem : public CObject
{
   DECLARE_SERIAL(CSubItem)
   CSubItem() : m_i(0) {};

public:
   CSubItem(CMyDocument * pDoc)
     { m_pDoc = pDoc; }

   // back pointer to owning document
   CMyDocument* m_pDoc; 
   WORD m_i; // other item data

   virtual void Serialize(CArchive& ar);
};

//SubItem.cpp
IMPLEMENT_SERIAL(CSubItem, CObject, 1);

void CSubItem::Serialize(CArchive& ar)

{
   if (ar.IsStoring())
   {
      // will serialize a reference 
      // to the "mapped" document pointer
      ar << (CObject *)m_pDoc;
      ar << m_i;
   }
   else
   {
      // Will load a reference to
      // the "mapped" document pointer
      ar >> (CObject *&) m_pDoc;
      ar >> m_i;
   }
}

必要条件

ヘッダー : afx.h

参照

関連項目

CArchive クラス

階層図

CArchive::ReadObject

CArchive::WriteObject