IPropertyPageImpl 類別
這個類別會實作 IUnknown
並提供 IPropertyPage 介面的預設實作。
重要
這個類別及其成員不能用於在 Windows 執行階段 中執行的應用程式。
語法
template<class T>
class IPropertyPageImpl
參數
T
您的類別衍生自 IPropertyPageImpl
。
成員
公用建構函式
名稱 | 描述 |
---|---|
IPropertyPageImpl::IPropertyPageImpl | 建構函式。 |
公用方法
名稱 | 描述 |
---|---|
IPropertyPageImpl::Activate | 建立屬性頁的對話框視窗。 |
IPropertyPageImpl::Apply | 將目前的屬性值套用至透過 SetObjects 指定的基礎物件。 ATL 實作會傳回S_OK。 |
IPropertyPageImpl::D eactivate | 終結使用 Activate 建立的視窗。 |
IPropertyPageImpl::GetPageInfo | 擷取屬性頁的相關信息。 |
IPropertyPageImpl::Help | 叫用屬性頁的 Windows 說明。 |
IPropertyPageImpl::IsPageDirty | 指出屬性頁自啟動后是否已變更。 |
IPropertyPageImpl::Move | 放置和調整屬性頁對話框的大小。 |
IPropertyPageImpl::SetDirty | 將屬性頁的狀態標示為已變更或未變更。 |
IPropertyPageImpl::SetObjects | 提供與屬性頁相關聯之物件的指標陣列 IUnknown 。 這些物件會透過呼叫 Apply 來接收目前的屬性值。 |
IPropertyPageImpl::SetPageSite | 提供屬性頁與 IPropertyPageSite 屬性框架通訊的指標。 |
IPropertyPageImpl::Show | 讓屬性頁對話框可見或看不見。 |
IPropertyPageImpl::TranslateAccelerator | 處理指定的擊鍵。 |
公用資料成員
名稱 | 描述 |
---|---|
IPropertyPageImpl::m_bDirty | 指定屬性頁的狀態是否已變更。 |
IPropertyPageImpl::m_dwDocString | 儲存與描述屬性頁之文字字串相關聯的資源識別符。 |
IPropertyPageImpl::m_dwHelpContext | 儲存與屬性頁相關聯之說明主題的內容標識碼。 |
IPropertyPageImpl::m_dwHelpFile | 儲存與描述屬性頁的說明檔名稱相關聯的資源識別碼。 |
IPropertyPageImpl::m_dwTitle | 儲存與出現在屬性頁索引標籤中的文字字串相關聯的資源識別碼。 |
IPropertyPageImpl::m_nObjects | 儲存與屬性頁相關聯的物件數目。 |
IPropertyPageImpl::m_pPageSite | IPropertyPageSite 指向屬性頁與屬性框架通訊的介面。 |
IPropertyPageImpl::m_ppUnk | 指向與屬性頁相關聯之物件的指標數位列 IUnknown 。 |
IPropertyPageImpl::m_size | 以像素為單位儲存屬性頁對話框的高度和寬度。 |
備註
IPropertyPage 介面可讓物件管理屬性表內的特定屬性頁。 類別 IPropertyPageImpl
提供這個介面的預設實作,並藉由將資訊傳送至偵錯組建中的傾印裝置來實 IUnknown
作。
繼承階層架構
IPropertyPage
IPropertyPageImpl
需求
標頭: atlctl.h
IPropertyPageImpl::Activate
建立屬性頁的對話框視窗。
HRESULT Activate(
HWND hWndParent,
LPCRECT pRect,
BOOL bModal);
備註
根據預設,不論 bModal 參數的值為何,對話框一律為無模式。
請參閱 Windows SDK 中的 IPropertyPage::Activate 。
IPropertyPageImpl::Apply
將目前的屬性值套用至透過 SetObjects
指定的基礎物件。
HRESULT Apply();
傳回值
傳回S_OK。
備註
請參閱 Windows SDK 中的 IPropertyPage::Apply 。
IPropertyPageImpl::D eactivate
終結使用 Activate 建立的對話框視窗。
HRESULT Deactivate();
備註
請參閱 Windows SDK 中的 IPropertyPage::D eactivate 。
IPropertyPageImpl::GetPageInfo
以 數據成員中包含的信息填入 pPageInfo 結構。
HRESULT GetPageInfo(PROPPAGEINFO* pPageInfo);
備註
GetPageInfo
會載入與 m_dwDocString、 m_dwHelpFile和 m_dwTitle相關聯的字串資源。
請參閱 Windows SDK 中的 IPropertyPage::GetPageInfo 。
IPropertyPageImpl::Help
叫用屬性頁的 Windows 說明。
HRESULT Help(PROPPAGEINFO* pPageInfo);
備註
請參閱 Windows SDK 中的 IPropertyPage::Help 。
IPropertyPageImpl::IPropertyPageImpl
建構函式。
IPropertyPageImpl();
備註
初始化所有數據成員。
IPropertyPageImpl::IsPageDirty
指出屬性頁自啟動后是否已變更。
HRESULT IsPageDirty(void);
備註
IsPageDirty
如果頁面在啟動后已變更,則會傳回S_OK。
IPropertyPageImpl::m_bDirty
指定屬性頁的狀態是否已變更。
BOOL m_bDirty;
IPropertyPageImpl::m_nObjects
儲存與屬性頁相關聯的物件數目。
ULONG m_nObjects;
IPropertyPageImpl::m_dwHelpContext
儲存與屬性頁相關聯之說明主題的內容標識碼。
DWORD m_dwHelpContext;
IPropertyPageImpl::m_dwDocString
儲存與描述屬性頁之文字字串相關聯的資源識別符。
UINT m_dwDocString;
IPropertyPageImpl::m_dwHelpFile
儲存與描述屬性頁的說明檔名稱相關聯的資源識別碼。
UINT m_dwHelpFile;
IPropertyPageImpl::m_dwTitle
儲存與出現在屬性頁索引標籤中的文字字串相關聯的資源識別碼。
UINT m_dwTitle;
IPropertyPageImpl::m_pPageSite
指向 屬性頁與屬性框架通訊的 IPropertyPageSite 介面。
IPropertyPageSite* m_pPageSite;
IPropertyPageImpl::m_ppUnk
指向與屬性頁相關聯之物件的指標數位列 IUnknown
。
IUnknown** m_ppUnk;
IPropertyPageImpl::m_size
以像素為單位儲存屬性頁對話框的高度和寬度。
SIZE m_size;
IPropertyPageImpl::Move
放置和調整屬性頁對話框的大小。
HRESULT Move(LPCRECT pRect);
備註
請參閱 Windows SDK 中的 IPropertyPage::Move 。
IPropertyPageImpl::SetDirty
根據 bDirty 的值,將屬性頁的狀態標示為已變更或未變更。
void SetDirty(BOOL bDirty);
參數
bDirty
[in]如果為 TRUE,則屬性頁的狀態會標示為已變更。 否則,它會標示為未變更。
備註
如有必要, SetDirty
通知框架屬性頁已變更。
IPropertyPageImpl::SetObjects
提供與屬性頁相關聯之物件的指標陣列 IUnknown
。
HRESULT SetObjects(ULONG nObjects, IUnknown** ppUnk);
備註
請參閱 Windows SDK 中的 IPropertyPage::SetObjects 。
IPropertyPageImpl::SetPageSite
提供屬性頁與 屬性框架通訊的 IPropertyPageSite 指標。
HRESULT SetPageSite(IPropertyPageSite* pPageSite);
備註
請參閱 Windows SDK 中的 IPropertyPage::SetPageSite 。
IPropertyPageImpl::Show
讓屬性頁對話框可見或看不見。
HRESULT Show(UINT nCmdShow);
備註
請參閱 Windows SDK 中的 IPropertyPage::Show 。
IPropertyPageImpl::TranslateAccelerator
處理 中指定的 pMsg
擊鍵。
HRESULT TranslateAccelerator(MSG* pMsg);
備註
請參閱 Windows SDK 中的 IPropertyPage::TranslateAccelerator 。
另請參閱
IPropertyPage2Impl 類別
IPerPropertyBrowsingImpl 類別
ISpecifyPropertyPagesImpl 類別
類別概觀