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 取得的地區設定所區分的文字。

規格需求

另請參閱

IPropertyPage：：GetPageInfo

IPropertyPageSite：：GetLocaleID

OLESTR