共用方式為


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 字段所描述的內容。 路徑必須配置 CoTaskMemAllocIPropertyPage::GetPageInfo 的呼叫端負責使用 CoTaskMemFree 釋放記憶體。

dwHelpContext

pszHelpFile 中描述此頁面之說明主題的內容標識符。

備註

這個結構中指定的 pszTitlepszDocStringpszHelpFile 成員應該包含透過 IPropertyPageSite::GetLocaleID 取得的地區設定所區分的文字。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 ocidl.h

另請參閱

IPropertyPage::GetPageInfo

IPropertyPageSite::GetLocaleID

OLESTR