PROPPAGEINFO-Struktur (ocidl.h)
Enthält Parameter, die zum Beschreiben einer Eigenschaftenseite für einen Eigenschaftenrahmen verwendet werden. Eine Eigenschaftenseite füllt eine vom Aufrufer bereitgestellte Struktur in der IPropertyPage::GetPageInfo-Methode aus.
Syntax
typedef struct tagPROPPAGEINFO {
ULONG cb;
LPOLESTR pszTitle;
SIZE size;
LPOLESTR pszDocString;
LPOLESTR pszHelpFile;
DWORD dwHelpContext;
} PROPPAGEINFO, *LPPROPPAGEINFO;
Member
cb
Die Größe der Struktur in Bytes.
pszTitle
Zeiger auf einen OLESTR,der die Zeichenfolge enthält, die auf der Registerkarte für diese Seite angezeigt wird. Die Zeichenfolge muss CoTaskMemAlloc zugeordnet werden. Der Aufrufer von IPropertyPage::GetPageInfo ist für die Freigabe des Arbeitsspeichers mit CoTaskMemFree verantwortlich.
size
Erforderliche Abmessungen des Dialogfelds der Seite in Pixel.
pszDocString
Zeiger auf eine Textzeichenfolge, die die Seite beschreibt, die im Dialogfeld Eigenschaftenblatt angezeigt werden kann (die aktuelle Frameimplementierung verwendet dieses Feld nicht). Der Text muss Mit CoTaskMemAlloc zugeordnet werden. Der Aufrufer von IPropertyPage::GetPageInfo ist für die Freigabe des Arbeitsspeichers mit CoTaskMemFree verantwortlich.
pszHelpFile
Zeiger auf einen OLESTR , der den einfachen Namen der Hilfedatei enthält, die diese Eigenschaftenseite beschreibt, die anstelle der Implementierung von IPropertyPage::Help verwendet wird. Wenn der Benutzer die Hilfe drückt, wird normalerweise die Help-Methode aufgerufen. Wenn diese Methode fehlschlägt, öffnet der Frame das Hilfesystem mit dieser Hilfedatei (präfixiert mit dem Wert des HelpDir-Schlüssels in den Registrierungseinträgen der Eigenschaftenseite unter seiner CLSID) und weist das Hilfesystem an, den im Feld dwHelpContext beschriebenen Kontext anzuzeigen. Der Pfad muss CoTaskMemAlloc zugeordnet werden. Der Aufrufer von IPropertyPage::GetPageInfo ist für die Freigabe des Arbeitsspeichers mit CoTaskMemFree verantwortlich.
dwHelpContext
Kontextbezeichner für das Hilfethema in pszHelpFile , das diese Seite beschreibt.
Hinweise
Die in dieser Struktur angegebenen Elemente pszTitle, pszDocString und pszHelpFile sollten Text enthalten, der für das Gebietsschema vertraulich ist, das über IPropertyPageSite::GetLocaleID abgerufen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | ocidl.h |