使用 AFX_EXT_CLASS 導出和導入
擴展 DLL 使用 AFX_EXT_CLASS 宏導出類;鏈接到擴展 DLL 的可執(zhí)行文件使用該宏導入類。用于生成擴展 DLL 的相同頭文件可通過 AFX_EXT_CLASS 宏與鏈接到 DLL 的可執(zhí)行文件一起使用。
在 DLL 的頭文件中,將 AFX_EXT_CLASS 關(guān)鍵字添加到類的聲明中,如下所示:
class AFX_EXT_CLASS CMyClass : public CDocument
{
// <body of class>
};
當定義了預處理器符號 _AFXDLL 和 _AFXEXT 時,該宏被 MFC 定義為 __declspec(dllexport)。但當定義了 _AFXDLL 而未定義 _AFXEXT 時,該宏被定義為 __declspec(dllimport)。定義后,預處理器符號 _AFXDLL 指示共享 MFC 版本正在由目標可執(zhí)行文件(DLL 或應用程序)使用。當 _AFXDLL 和 _AFXEXT 都定義了時,這指示目標可執(zhí)行文件是擴展 DLL。
由于從擴展 DLL 導出時,AFX_EXT_CLASS 被定義為 __declspec(dllexport),因此可以導出整個類,而不必將該類的所有符號的修飾名放到 .def 文件中。此方法由 MFC 示例 DLLHUSK 使用。
雖然使用此方法可以避免創(chuàng)建 .def 文件和類的所有修飾名,但由于名稱可以按序號導出,因此創(chuàng)建 .def 文件的效率更高。若要使用 .def 文件導出方法,請將下列代碼放在頭文件的開頭和結(jié)尾處:
#undef AFX_DATA
#define AFX_DATA AFX_EXT_DATA
// <body of your header file>
#undef AFX_DATA
#define AFX_DATA
警告
導出內(nèi)聯(lián)函數(shù)時要小心,因為它們有可能導致版本沖突。內(nèi)聯(lián)函數(shù)擴展到應用程序代碼中;因此,如果以后重寫內(nèi)聯(lián)函數(shù),除非重新編譯應用程序本身,否則內(nèi)聯(lián)函數(shù)不會被更新。通常,不用重新生成使用 DLL 函數(shù)的應用程序就可以更新 DLL 函數(shù)。
導出類中的個別成員
有時,您可能希望導出類中的個別成員。例如,如果導出 CDialog 派生類,可能只需要導出構(gòu)造函數(shù)和 DoModal 調(diào)用。可以對需要導出的個別成員使用 AFX_EXT_CLASS。
例如:
class CExampleDialog : public CDialog
{
public:
AFX_EXT_CLASS CExampleDialog();
AFX_EXT_CLASS int DoModal();
...
// rest of class definition
...
};
您不再導出類的所有成員,但由于 MFC 宏的工作方式,您可能會遇到其他問題。幾個 MFC 的 Helper 宏實際聲明或定義數(shù)據(jù)成員。因此,還必須從 DLL 導出這些數(shù)據(jù)成員。
例如,當生成擴展 DLL 時,DECLARE_DYNAMIC 宏的定義如下:
#define DECLARE_DYNAMIC(class_name) \
protected: \
static CRuntimeClass* PASCAL _GetBaseClass(); \
public: \
static AFX_DATA CRuntimeClass class##class_name; \
virtual CRuntimeClass* GetRuntimeClass() const; \
以 static AFX_DATA 打頭的行聲明類的內(nèi)部靜態(tài)對象。若要正確導出該類并從客戶端可執(zhí)行文件訪問運行時信息,必須導出此靜態(tài)對象。由于靜態(tài)對象是用 AFX_DATA 修飾符聲明的,因此只需在生成 DLL 時將 AFX_DATA 定義為 __declspec(dllexport),并在生成客戶端可執(zhí)行文件時將 AFX_DATA 定義為 __declspec(dllimport)。由于已經(jīng)以此方式定義了 AFX_EXT_CLASS,因此只需參考類定義,將 AFX_DATA 重定義為與 AFX_EXT_CLASS 相同。
例如:
#undef AFX_DATA
#define AFX_DATA AFX_EXT_CLASS
class CExampleView : public CView
{
DECLARE_DYNAMIC()
// ... class definition ...
};
#undef AFX_DATA
#define AFX_DATA
MFC 總是在其宏的內(nèi)部定義的數(shù)據(jù)項上使用 AFX_DATA 符號,因此此技術(shù)適用于所有這類情況。例如,它適用于 DECLARE_MESSAGE_MAP。