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

Weitere Informationen

IPropertyPage::GetPageInfo

IPropertyPageSite::GetLocaleID

OLESTR