CAtlBaseModule 類別
這個類別會在每個 ATL 專案中具現化。
語法
class CAtlBaseModule : public _ATL_BASE_MODULE
成員
公用建構函式
名稱 | 描述 |
---|---|
CAtlBaseModule::CAtlBaseModule | 建構函式。 |
公用方法
名稱 | 描述 |
---|---|
CAtlBaseModule::AddResourceInstance | 將資源實例新增至預存控制碼清單。 |
CAtlBaseModule::GetHInstanceAt | 傳回指定之資源實例的控制碼。 |
CAtlBaseModule::GetModuleInstance | 從 CAtlBaseModule 物件傳回模組實例。 |
CAtlBaseModule::GetResourceInstance | 從 CAtlBaseModule 物件傳回資源實例。 |
CAtlBaseModule::RemoveResourceInstance | 從預存控制碼清單中移除資源實例。 |
CAtlBaseModule::SetResourceInstance | 設定 物件的資源實例 CAtlBaseModule 。 |
公用資料成員
名稱 | 描述 |
---|---|
CAtlBaseModule::m_bInitFailed | 變數,指出模組初始化是否失敗。 |
備註
每個 ATL 專案中都有具名_AtlBaseModule的實例,其中包含模組實例的 CAtlBaseModule
控制碼、包含資源的模組控制碼(預設為一個和相同),以及提供主要資源的模組控制碼陣列。 CAtlBaseModule
可以從多個執行緒安全地存取。
此類別會取代舊版 ATL 中使用的過時 CComModule 類別。
繼承階層架構
CAtlBaseModule
需求
標頭: atlcore.h
CAtlBaseModule::AddResourceInstance
將資源實例新增至預存控制碼清單。
bool AddResourceInstance(HINSTANCE hInst) throw();
參數
hInst
要加入的資源實例。
傳回值
如果已成功新增資源,則傳回 true,否則傳回 false。
CAtlBaseModule::CAtlBaseModule
建構函式。
CAtlBaseModule() throw();
備註
建立 CAtlBaseModule
。
CAtlBaseModule::GetHInstanceAt
傳回指定之資源實例的控制碼。
HINSTANCE GetHInstanceAt(int i) throw();
參數
i
資源實例的數目。
傳回值
傳回資源實例的控制碼,如果沒有對應的資源實例,則傳回 Null。
CAtlBaseModule::GetModuleInstance
從 CAtlBaseModule
物件傳回模組實例。
HINSTANCE GetModuleInstance() throw();
傳回值
傳回模組實例。
CAtlBaseModule::GetResourceInstance
傳回資源實例。
HINSTANCE GetResourceInstance() throw();
傳回值
傳回資源實例。
CAtlBaseModule::m_bInitFailed
變數,指出模組初始化是否失敗。
static bool m_bInitFailed;
備註
如果模組初始化,則為 True;如果模組無法初始化,則為 false。
CAtlBaseModule::RemoveResourceInstance
從預存控制碼清單中移除資源實例。
bool RemoveResourceInstance(HINSTANCE hInst) throw();
參數
hInst
要移除的資源實例。
傳回值
如果已成功移除資源,則傳回 true,否則傳回 false。
CAtlBaseModule::SetResourceInstance
設定 物件的資源實例 CAtlBaseModule
。
HINSTANCE SetResourceInstance(HINSTANCE hInst) throw();
參數
hInst
新的資源實例。
傳回值
傳回更新的資源實例。
另請參閱
意見反映
https://aka.ms/ContentUserFeedback。
即將推出:我們會在 2024 年淘汰 GitHub 問題,並以全新的意見反應系統取代並作為內容意見反應的渠道。 如需更多資訊,請參閱:提交及檢視以下的意見反映: