PROPPAGEINFO 結構 (ocidl.h)
包含參數,用來描述屬性框架的屬性頁。 屬性頁會在 IPropertyPage::GetPageInfo 方法中填入呼叫端提供的結構。
語法
typedef struct tagPROPPAGEINFO {
ULONG cb;
LPOLESTR pszTitle;
SIZE size;
LPOLESTR pszDocString;
LPOLESTR pszHelpFile;
DWORD dwHelpContext;
} PROPPAGEINFO, *LPPROPPAGEINFO;
成員
cb
結構的大小,以位元組為單位。
pszTitle
OLESTR 的指標,其中包含出現在此頁面索引標籤中的字串。 字串必須使用 CoTaskMemAlloc 配置。 IPropertyPage::GetPageInfo 的呼叫端負責使用 CoTaskMemFree 釋放記憶體。
size
頁面對話框的必要維度,以像素為單位。
pszDocString
描述頁面的文字字串指標,該字串可以顯示在屬性表對話方塊中, (目前框架實作不會使用此欄位) 。 文字必須使用 CoTaskMemAlloc 配置。 IPropertyPage::GetPageInfo 的呼叫端負責使用 CoTaskMemFree 釋放記憶體。
pszHelpFile
OLESTR 的指標,其中包含說明使用之此屬性頁的簡單名稱,而不是實作 IPropertyPage::Help。 當使用者按下 [說明] 時,通常會呼叫 Help 方法。 如果該方法失敗,框架會開啟說明系統,並使用此說明檔 (前面加上其 CLSID) 屬性頁登錄專案中 HelpDir 索引鍵的值,並指示說明系統顯示 dwHelpContext 字段所描述的內容。 路徑必須配置 CoTaskMemAlloc。 IPropertyPage::GetPageInfo 的呼叫端負責使用 CoTaskMemFree 釋放記憶體。
dwHelpContext
pszHelpFile 中描述此頁面之說明主題的內容標識符。
備註
這個結構中指定的 pszTitle、 pszDocString 和 pszHelpFile 成員應該包含透過 IPropertyPageSite::GetLocaleID 取得的地區設定所區分的文字。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
標頭 | ocidl.h |