PROPSHEETUI_INFO_HEADER Struktur (compstui.h)

Die PROPSHEETUI_INFO_HEADER-Struktur wird als Eingabeparameter für die PFNPROPSHEETUI-typisierte Funktion einer Anwendung verwendet, wenn die Funktion mit dem Grundwert PROPSHEETUI_REASON_GET_INFO_HEADER aufgerufen wird.

Syntax

typedef struct _PROPSHEETUI_INFO_HEADER {
  WORD      cbSize;
  WORD      Flags;
  LPTSTR    pTitle;
  HWND      hWndParent;
  HINSTANCE hInst;
  union {
    HICON     hIcon;
    ULONG_PTR IconID;
  } DUMMYUNIONNAME;
} PROPSHEETUI_INFO_HEADER, *PPROPSHEETUI_INFO_HEADER;

Member

cbSize

CPSUI-bereitgestellte Größe der PROPSHEETUI_INFO_HEADER-Struktur in Bytes.

Flags

Optionale, anwendungsspezifische Bitflags, die die Darstellung der Eigenschaftenblattseite ändern. Die in der folgenden Tabelle aufgeführten Flags können in beliebiger Kombination verwendet werden.

Flag	Beschreibung
PSUIHDRF_DEFTITLE	Wenn festgelegt, sollte CPSUI "Default" in der Titelleistenzeichenfolge enthalten. CPSUI fügt "Default" nach der pTitle-Zeichenfolge und, wenn PSUIHDRF_PROPTITLE festgelegt ist, vor "Properties" hinzu.
PSUIHDRF_EXACT_PTITLE	Falls festgelegt, verwendet CPSUI den von pTitle angegebenen Text ohne Änderung. Dieses Flag überschreibt PSUIHDRF_DEFTITLE und PSUIHDRF_PROPTITLE.
PSUIHDRF_NOAPPLYNOW	Falls festgelegt, sollte CPSUI keine Schaltfläche Jetzt anwenden enthalten.
PSUIHDRF_PROPTITLE	Wenn festgelegt, sollte CPSUI "Eigenschaften" an die Titelleistenzeichenfolge anfügen. (Standardmäßig legt CPSUI dieses Flag vor dem Aufrufen der Anwendung fest.)
PSUIHDRF_USEHICON	Wenn festgelegt, enthält die hIcon/IconID Union ein Symbolhandle. Wenn nicht festgelegt, enthält die Union einen Symbolressourcenbezeichner.

pTitle

Zeichenfolgenbezeichner, der Text darstellt, der auf der Titelleiste des Eigenschaftenblatts angezeigt werden soll. Dies kann ein 32-Bit-Zeiger auf eine NULL-beendete Zeichenfolge oder ein 16-Bit-Zeichenfolgenressourcenbezeichner sein, bei dem HIWORD auf Null festgelegt ist. Bei Druckerschnittstellen-DLLs enthält die Zeichenfolge in der Regel den Namen des Druckers.

hWndParent

Handle mit dem Fenster, das als übergeordnetes Element des Eigenschaftenblatts verwendet werden soll. Standardmäßig stellt CPSUI das Fensterhandle bereit, das es für den hWndOwner-Parameter empfangen hat, an CommonPropertySheetUI, aber die Anwendung kann dieses Handle mit einem anderen überschreiben.

hInst

Anwendungsseitig bereitgestellte instance-Handle, das CPSUI beim Laden von Anwendungsressourcen verwendet.

DUMMYUNIONNAME

Diese Union identifiziert das Symbol, das auf der Titelleiste des Eigenschaftenblatts angezeigt werden soll.

DUMMYUNIONNAME.hIcon

Definiert das HICON-MemberhIcon.

DUMMYUNIONNAME.IconID

Definiert die ULONG_PTR Member IconID. Das Unionmitglied wird von PSUIHDRF_USEICON in Flags ausgewählt.

Anforderungen

Anforderung	Wert
Header	compstui.h (einschließlich Compstui.h)