CRuntimeClass::FromName

Call this function to retrieve the CRuntimeClass structure associated with the familiar name.

static CRuntimeClass* PASCAL FromName(
   LPCSTR lpszClassName 
);
static CRuntimeClass* PASCAL FromName(
   LPCWSTR lpszClassName 
);

Parameters

  • lpszClassName
    The familiar name of a class derived from CObject.

Return Value

A pointer to a CRuntimeClass object, corresponding to the name as passed in lpszClassName. The function returns NULL if no matching class name was found.

Example

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

Requirements

Header: afx.h

See Also

Reference

CRuntimeClass Structure

Hierarchy Chart

CRuntimeClass::m_lpszClassName

Other Resources

CRuntimeClass Members