CRuntimeClass 構造体

から派生した各クラス CObject は、 CRuntimeClass 実行時にオブジェクトまたは基本クラスに関する情報を取得するために使用できる 構造体に関連付けられている。

構文

struct CRuntimeClass

メンバー

パブリック メソッド

名前	説明
CRuntimeClass::CreateObject	実行時に オブジェクトを作成します。
CRuntimeClass::FromName	使い慣れたクラス名を使用して、実行時に オブジェクトを作成します。
CRuntimeClass::IsDerivedFrom	クラスが指定したクラスから派生したかどうかを判断します。

パブリック データ メンバー

名前	説明
CRuntimeClass::m_lpszClassName	クラスの名前。
CRuntimeClass::m_nObjectSize	オブジェクトのサイズ (バイト単位)。
CRuntimeClass::m_pBaseClass	基本クラスの CRuntimeClass 構造体へのポインター。
CRuntimeClass::m_pfnCreateObject	オブジェクトを動的に作成する関数へのポインター。
CRuntimeClass::m_pfnGetBaseClass	構造体を返 CRuntimeClass します (動的にリンクされている場合にのみ使用できます)。
CRuntimeClass::m_wSchema	クラスのスキーマ番号。

注釈

CRuntimeClass は 構造体であるため、基本クラスを持つ必要があります。

実行時にオブジェクトのクラスを決定する機能は、関数引数の追加の型チェックが必要な場合、またはオブジェクトのクラスに基づいて特殊な目的のコードを記述する必要がある場合に便利です。 実行時クラス情報は、C++ 言語では直接サポートされていません。

CRuntimeClass は、基本クラスの へのポインターや、関連するクラスの ASCII クラス名など、関連する C++ CRuntimeClass オブジェクトに関する情報を提供します。 この構造体には、オブジェクトの動的な作成、使い慣れた名前を使用したオブジェクトの型の指定、関連するクラスが特定のクラスから派生した場合の判断に使用できるさまざまな関数も実装されています。

の使用の詳細については、「 CRuntimeClassクラス情報への アクセスRun-Time参照してください。

継承階層

CRuntimeClass

要件

ヘッダー: afx.h

CRuntimeClass::CreateObject

実行時に指定したクラスを動的に作成するには、この関数を呼び出します。

CObject* CreateObject();

static CObject* PASCAL CreateObject(LPCSTR lpszClassName);

static CObject* PASCAL CreateObject(LPCWSTR lpszClassName);

パラメーター

lpszClassName
作成するクラスの使い慣れた名前。

戻り値

新しく作成された オブジェクトへのポインター。クラス名が見つからない場合、またはオブジェクトを作成するメモリが不足している場合は NULL。

注釈

から派生したクラスは CObject 動的な作成をサポートできます。これは、実行時に指定されたクラスのオブジェクトを作成する機能です。 たとえば、ドキュメント、ビュー、フレームのクラスは、動的な作成をサポートする必要があります。 動的な作成とメンバーの詳細については CreateObject 、「 CObject クラスと CObject クラス: 機能レベルの指定」 を参照してください。

例

IsDerivedFrom の例を参照してください。

CRuntimeClass::FromName

この関数を呼び出して、使い慣れた CRuntimeClass 名前に関連付けられている構造体を取得します。

static CRuntimeClass* PASCAL FromName(LPCSTR lpszClassName);

static CRuntimeClass* PASCAL FromName(LPCWSTR lpszClassName);

パラメーター

lpszClassName
から派生したクラスの使い慣れた名前 CObject。

戻り値

CRuntimeClasslpszClassName で渡された名前に対応する オブジェクトへのポインター。 一致するクラス名が見つからなかった場合、関数は NULL を返します。

例

// This example creates an object if CAge is defined.

CRuntimeClass* pClass = CRuntimeClass::FromName(_T("CAge"));
if (pClass == NULL)
{
   // not found, display a warning for diagnostic purposes
   AfxMessageBox(_T("Warning: CMyClass not defined"));
   return NULL;
}

// attempt to create the object with the found CRuntimeClass
CObject* pObject = pClass->CreateObject();

CRuntimeClass::IsDerivedFrom

この関数を呼び出して、呼び出し元のクラスが pBaseClass パラメーターで指定されたクラスから派生 したかどうかを判断 します。

BOOL IsDerivedFrom(const CRuntimeClass* pBaseClass) const;

パラメーター

pBaseClass
から派生したクラスの使い慣れた名前 CObject。

戻り値

を呼び出すクラスが IsDerivedFrom 、構造体 CRuntimeClass がパラメーターとして指定されている基本クラスから派生する場合は TRUE、それ以外の場合は FALSE。

注釈

リレーションシップは、メンバーのクラスから派生クラスのチェーンを上まで上に "walking" することで決定されます。 この関数は、基本クラスに一致が見つからない場合にのみ FALSE を返します。

注意

構造体を CRuntimeClass 使用するには、実行時オブジェクト情報を取得するクラスの実装に IMPLEMENT_DYNAMIC、IMPLEMENT_DYNCREATE、または IMPLEMENT_SERIAL マクロを含める必要があります。

の使用の詳細については、「 CRuntimeClassCObject クラス: クラス情報への アクセスRun-Time参照してください。

例

// This example creates an object from the run-time class. It only 
// creates objects derived from CWnd.

// We only want to create an object derived from CWnd.
if (!pClass->IsDerivedFrom(RUNTIME_CLASS(CWnd)))
{
   TRACE(_T("Error; Object %s is not derived from CWnd\n"),
      pClass->m_lpszClassName);
   return FALSE;
}

// Get a pointer to the base class CRuntimeClass.
#ifdef _AFXDLL
CRuntimeClass* pBaseClass = pClass->m_pfnGetBaseClass();
#else
CRuntimeClass* pBaseClass = pClass->m_pBaseClass;
#endif
ASSERT(pBaseClass != NULL);

TRACE("Creating object %s derived from %s, with object size %d "
   "and schema %d\n", pClass->m_lpszClassName,
   pBaseClass->m_lpszClassName, pClass->m_nObjectSize,
   pClass->m_wSchema);

// Create the object.
CObject* pObject = pClass->CreateObject();

CRuntimeClass::m_lpszClassName

ASCII クラス名を含む null 終端文字列。

注釈

この名前は、メンバー関数を使用して クラスのインスタンスを作成するために FromName 使用できます。

例

IsDerivedFrom の例を参照してください。

CRuntimeClass::m_nObjectSize

オブジェクトのサイズ (バイト単位)。

注釈

オブジェクトに、割り当てられたメモリを指すデータ メンバーがある場合、そのメモリのサイズは含まれません。

例

IsDerivedFrom の例を参照してください。

CRuntimeClass::m_pBaseClass

アプリケーションが静的に MFC にリンクしている場合、このデータ CRuntimeClass メンバーには、基本クラスの構造体へのポインターが含まれる。

注釈

アプリケーションが MFC ライブラリに動的にリンクしている場合は、次のページ をm_pfnGetBaseClass。

例

IsDerivedFrom の例を参照してください。

CRuntimeClass::m_pfnCreateObject

クラスのオブジェクトを作成する既定のコンストラクターへの関数ポインター。

注釈

このポインターは、 クラスが動的な作成をサポートしている場合にのみ有効です。それ以外の場合、関数は NULL を返します。

CRuntimeClass::m_pfnGetBaseClass

アプリケーションで MFC ライブラリを共有 DLL CRuntimeClass として使用する場合、このデータ メンバーは、基本クラスの構造を返す関数を参照します。

注釈

アプリケーションが MFC ライブラリに静的にリンクしている場合は、「 m_pBaseClass」を参照してください。

例

IsDerivedFromの例を参照してください。

CRuntimeClass:: m_wSchema

スキーマ番号 (シリアル化クラスの場合は-1)。

注釈

スキーマ番号の詳細については、 IMPLEMENT_SERIAL マクロを参照してください。

例

IsDerivedFromの例を参照してください。

関連項目

階層図
CObject:: GetRuntimeClass
CObject::IsKindOf
RUNTIME_CLASS
IMPLEMENT_DYNAMIC
IMPLEMENT_DYNCREATE
IMPLEMENT_SERIAL