DLGPAGE-Struktur (compstui.h)

Die DLGPAGE-Struktur wird zum Angeben einer Eigenschaftenblattseite für die ComPropSheet-Funktion von CPSUI verwendet. Die Adresse der Struktur ist in einer COMPROPSHEETUI-Struktur enthalten, und alle Memberwerte werden vom ComPropSheet-Aufrufer angegeben.

Syntax

typedef struct _DLGPAGE {
  WORD      cbSize;
  WORD      Flags;
  DLGPROC   DlgProc;
  LPTSTR    pTabName;
  ULONG_PTR IconID;
  union {
    WORD   DlgTemplateID;
    HANDLE hDlgTemplate;
  } DUMMYUNIONNAME;
} DLGPAGE, *PDLGPAGE;

Member

cbSize

Vom Aufrufer bereitgestellte Größe der DLGPAGE-Struktur in Bytes.

Flags

Vom Aufrufer bereitgestellte Bitflags, wie in der folgenden Tabelle beschrieben.

Flag	Definition
DPF_ICONID_AS_HICON	Wenn festgelegt, enthält IconID ein Symbolhandle. Wenn nicht festgelegt, enthält IconID einen Symbolressourcenbezeichner.
DPF_USE_HDLGTEMPLATE	Wenn festgelegt, enthält hDlgTemplate ein Vorlagenhandle. Falls nicht festgelegt, enthält DlgTemplateID einen Vorlagenressourcenbezeichner.

Optional, vom Aufrufer bereitgestellter DLGPROC-typisierter Zeiger auf eine Dialogfeldprozedur, die zum Verarbeiten von Nachrichten verwendet wird, die vom System gesendet werden, wenn Benutzerereignisse auftreten. Bei NULL stellt CPSUI eine Dialogfeldprozedur bereit. Weitere Informationen finden Sie weiter unten im Abschnitt Hinweise.

DlgProc

Definiert das DLGPROC-MemberDlgProc.

pTabName

Vom Aufrufer bereitgestellter Zeiger auf eine NULL-beendete Zeichenfolge, die auf der Seitenregisterkarte angezeigt wird.

IconID

Aufrufer-bereitgestellt, kann einer der folgenden sein:

• Ein Symbolressourcenbezeichner. Dies kann anwendungsdefiniert sein oder einer der von CPSUI bereitgestellten, IDI_CPSUI Symbolressourcenbezeichner sein.

• Ein Symbolhandle. Wenn ein Handle angegeben wird, muss DPF_ICONID_AS_HICON im Flags-Element festgelegt werden.

Das angegebene Symbol wird auf der Registerkarte "Seite" angezeigt. Wenn dieser Wert 0 ist, wird kein Symbol angezeigt.

DUMMYUNIONNAME

Definiert die DUMMYUNIONNAME-Union .

DUMMYUNIONNAME.DlgTemplateID

Vom Aufrufer bereitgestellte Ressourcenbezeichner für eine Dialogfeldvorlage. Dies kann auf eine von der Anwendung bereitgestellte DIALOG-Ressource verweisen, oder es kann sich um einen der folgenden CPSUI-bereitgestellten Bezeichner (definiert in compstui.h) handelt:

Bezeichner	Seitentyp
DP_STD_DOCPROPPAGE1	Seite "Nontreeview", die für die Layoutseite eines Druckdokuments verwendet wird.
DP_STD_DOCPROPPAGE2	Seite "Nontreeview", die für die Seite "Papier/Qualität " eines Druckdokuments verwendet wird.
DP_STD_TREEVIEWPAGE	Generische Treeview-Seite.

Die von CPSUI bereitgestellten Bezeichner beziehen sich auf Vorlagen, die CPSUI-Optionstypen anzeigen können. Die Seitengröße für diese Vorlagen beträgt 252 x 216 Dialogfeldeinheiten. Weitere Informationen finden Sie unter CPSUI-bereitgestellte Seiten und Vorlagen.

Dieses Element wird nicht verwendet, wenn DPF_USE_HDLGTEMPLATE in Flags festgelegt ist.

DUMMYUNIONNAME.hDlgTemplate

Vom Aufrufer bereitgestelltes Handle für eine DLGTEMPLATE-Struktur .

Wird nur verwendet, wenn DPF_USE_HDLGTEMPLATE in Flags festgelegt ist.

Hinweise

CPSUI erstellt eine Eigenschaftenblattseite, indem eine PROPSHEETPAGE-Struktur zugewiesen und an CreatePropertySheetPage übergeben wird. Wenn der Aufrufer einen DLGPROC-typisierten Zeiger auf eine Dialogfeldprozedur in DlgProc angegeben hat, wird diese Prozedur für die Verarbeitung der Fenstermeldungen der Seite verwendet. Wenn DlgProc NULL ist, werden CPSUI-eigene Dialogfeldprozeduren verwendet.

Wenn die Dialogfeldprozedur, auf die von DlgProc verwiesen wird, mit dem Nachrichtenwert WM_INITDIALOG aufgerufen wird, empfängt sie die PROPSHEETPAGE-Struktur als Eingabe und empfängt auch eine PSPINFO-Struktur .

Wenn eine vom Aufrufer bereitgestellte Dialogfeldprozedur eine Nachricht verarbeitet, sollte sie einen Wert ohne Zero zurückgeben. Wenn die Funktion die Nachricht nicht verarbeitet, sollte sie null zurückgeben, was dazu führt, dass CPSUI die Nachricht verarbeitet.

Anforderungen

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