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 bereitgestellt.

Syntax

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

Angehörige

cbSize

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

Flags

Von Aufrufern bereitgestellte Bitkennzeichnungen, wie in der folgenden Tabelle beschrieben.

Flagge	Definition
DPF_ICONID_AS_HICON	Wenn festgelegt, enthält IconID einen Symbolziehpunkt. Wenn nicht festgelegt, enthält IconID einen Symbolressourcenbezeichner.
DPF_USE_HDLGTEMPLATE	Wenn festgelegt, enthält hDlgTemplate- ein Vorlagenhandle. Wenn nicht festgelegt, enthält DlgTemplateID- einen Vorlagenressourcenbezeichner.

Optionaler, vom Aufrufer bereitgestellter DLGPROC--typierter Zeiger auf eine Dialogfeldprozedur, die zum Verarbeiten von Nachrichten verwendet wird, die vom System gesendet werden, wenn Benutzerereignisse auftreten. Wenn NULL-, liefert CPSUI eine Dialogfeldprozedur. Weitere Informationen finden Sie im Abschnitt "Hinweise" weiter unten.

DlgProc

Definiert das DLGPROC Member DlgProc.

pTabName

Vom Aufrufer bereitgestellter Zeiger auf eine MIT NULL beendete Zeichenfolge, die auf der Seitenregisterkarte angezeigt werden soll.

IconID

Der vom Anrufer bereitgestellte Aufrufer kann eine der folgenden Sein:

• Ein Symbolressourcenbezeichner. Dies kann anwendungsdefiniert sein, oder es kann sich um einen der von CPSUI bereitgestellten, IDI_CPSUI-Präfix-Symbolressourcenbezeichner handeln.

• Ein Symbolziehpunkt. Wenn ein Handle angegeben ist, muss DPF_ICONID_AS_HICON im Flags Member festgelegt werden.

Das angegebene Symbol wird auf der Seitenregisterkarte angezeigt. Wenn dieser Wert null ist, wird kein Symbol angezeigt.

DUMMYUNIONNAME

Definiert die DUMMYUNIONNAME Union.

DUMMYUNIONNAME.DlgTemplateID

Vom Aufrufer bereitgestellter Ressourcenbezeichner für eine Dialogfeldvorlage. Dies kann auf eine vom Anwendung bereitgestellte DIALOG-Ressource oder eine der folgenden CPSUI-bereitgestellten Bezeichner sein (definiert in compstui.h):

Bezeichner	Seitentyp
DP_STD_DOCPROPPAGE1	Nichtstrukturansichtsseite, die für die Layout- Seite eines Druckdokuments verwendet wird.
DP_STD_DOCPROPPAGE2	Nontreeview page, used for a print document's Paper/Quality page.
DP_STD_TREEVIEWPAGE	Generische Strukturansichtsseite.

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

Dieses Element wird nicht verwendet, wenn DPF_USE_HDLGTEMPLATE in Flagsfestgelegt ist.

DUMMYUNIONNAME.hDlgTemplate

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

Wird nur verwendet, wenn DPF_USE_HDLGTEMPLATE in Flagsfestgelegt ist.

Bemerkungen

CPSUI erstellt eine Eigenschaftenblattseite, indem eine PROPSHEETPAGE- Struktur zugeordnet und an CreatePropertySheetPageübergeben wird. Wenn der Aufrufer einen DLGPROC-typierten Zeiger auf eine Dialogfeldprozedur in DlgProcangegeben hat, wird diese Prozedur für die Behandlung der Fenstermeldungen der Seite verwendet. Wenn DlgProc NULL-ist, werden die eigenen Dialogfeldprozeduren von CPSUI verwendet.

Wenn die von DlgProc hervorgehobene Dialogfeldprozedur mit einem Nachrichtenwert von WM_INITDIALOGaufgerufen wird, empfängt sie die PROPSHEETPAGE- Struktur als Eingabe und erhält außerdem eine PSPINFO- Struktur.

Wenn eine vom Aufrufer bereitgestellte Dialogfeldprozedur eine Meldung behandelt, sollte ein Wert ungleich Null zurückgegeben werden. Wenn die Funktion die Nachricht nicht behandelt, sollte sie null zurückgeben, was dazu führt, dass CPSUI die Nachricht behandelt.

Anforderungen

Anforderung	Wert
Header-	compstui.h (include Compstui.h)