INSERTPSUIPAGE_INFO Struktur (compstui.h)

Die INSERTPSUIPAGE_INFO-Struktur wird als Eingabeparameter für die ComPropSheet--Funktion von CPSUI verwendet, wenn der Funktionscode CPSFUNC_INSERT_PSUIPAGEist. Alle Memberwerte müssen vom aufrufer ComPropSheet angegeben werden.

Syntax

typedef struct _INSERTPSUIPAGE_INFO {
  WORD      cbSize;
  BYTE      Type;
  BYTE      Mode;
  ULONG_PTR dwData1;
  ULONG_PTR dwData2;
  ULONG_PTR dwData3;
} INSERTPSUIPAGE_INFO, *PINSERTPSUIPAGE_INFO;

Angehörige

cbSize

Vom Aufrufer bereitgestellte Größe in Byte der INSERTPSUIPAGE_INFO Struktur.

Type

Vom Aufrufer bereitgestellter ganzzahliger Wert, der den Typ der Einfügung angibt, die angefordert wird. Das Element kann eine der folgenden Konstanten enthalten:

PSUIPAGEINSERT_DLL

CPSUI ruft die angegebene PFNPROPSHEETUI typisierter Funktion mit dem Grundwert PROPSHEETUI_REASON_INIT auf. Die Funktion ist in einer separaten DLL enthalten.

PSUIPAGEINSERT_GROUP_PARENT

CPSUI erstellt eine neue übergeordnete Gruppe.

PSUIPAGEINSERT_HPROPSHEETPAGE

CPSUI fügt eine Seite ein, die durch Aufrufen CreatePropertySheetPageerstellt wurde.

(Dies entspricht dem Aufrufen ComPropSheet- mit einem Funktionscode von CPSFUNC_ADD_HPROPSHEETPAGE.)

PSUIPAGEINSERT_PCOMPROPSHEETUI

CPSUI fügt Seiten ein, die durch eine COMPROPSHEETUI- Struktur beschrieben werden.

(Dies entspricht dem Aufrufen ComPropSheet- mit einem Funktionscode von CPSFUNC_ADD_PCOMPROPSHEETUI.)

PSUIPAGEINSERT_PFNPROPSHEETUI

CPSUI ruft die angegebene PFNPROPSHEETUI typisierter Funktion mit dem Grundwert PROPSHEETUI_REASON_INIT auf.

(Dies entspricht dem Aufrufen ComPropSheet- mit einem Funktionscode von CPSFUNC_ADD_PFNPROPSHEETUI.)

PSUIPAGEINSERT_PROPSHEETPAGE

CPSUI fügt die von der angegebenen PROPSHEETPAGE-Struktur beschriebene Seite ein.

(Dies entspricht dem Aufrufen ComPropSheet- mit einem Funktionscode von CPSFUNC_ADD_PROPSHEETPAGE.)

Mode

Vom Aufrufer bereitgestellter Wert, der angibt, wo CPSUI die neuen Seiten einfügen soll. Es muss sich um einen der folgenden Werte handeln:

INSPSUIPAGE_MODE_AFTER

CPSUI fügt Seiten nach der vom CPSUI-Seitenhandle identifizierten Seite ein, die vom lParam1 Parameter angegeben wird, um ComPropSheet-.

INSPSUIPAGE_MODE_BEFORE

CPSUI fügt Seiten vor der vom CPSUI-Seitenhandle identifizierten Seite ein, die vom lParam1 Parameter angegeben wird, um ComPropSheet-.

INSPSUIPAGE_MODE_FIRST_CHILD

CPSUI fügt Seiten als die ersten untergeordneten Elemente der übergeordneten Gruppe ein, die vom hComPropSheet Parameter identifiziert wird, um ComPropSheet-.

Der parameter lParam1ComPropSheet- wird ignoriert.

INSPUIPAGE_MODE_INDEX

CPSUI fügt Seiten als untergeordnete Elemente der übergeordneten Gruppe ein, die vom hComPropSheet Parameter identifiziert wird, um ComPropSheet-.

Der lParam1 Parameter zum ComPropSheet- gibt einen nullbasierten Index an, der angibt, wo innerhalb der Gruppe untergeordneter Elemente die angegebenen Seiten eingefügt werden sollen. Wenn lParam1 0 ist, werden die Seiten beginnend mit Seite 1 eingefügt; wenn lParam1 1 ist, werden die Seiten beginnend mit Seite 2 eingefügt; Und so weiter. Wenn der Index größer als die Anzahl vorhandener untergeordneter Elemente ist, werden die neuen Seiten als die letzten untergeordneten Elemente hinzugefügt. Der lParam1- Wert muss als HINSPSUIPAGE_INDEX(index) angegeben werden.

INSPSUIPAGE_MODE_LAST_CHILD

CPSUI fügt Seiten als die letzten untergeordneten Elemente der übergeordneten Gruppe ein, die vom hComPropSheet Parameter identifiziert wird, um ComPropSheet-.

Der parameter lParam1ComPropSheet- wird ignoriert.

dwData1

Weitere Informationen finden Sie im Abschnitt Anmerkungen weiter unten.

dwData2

Weitere Informationen finden Sie im Abschnitt Anmerkungen weiter unten.

dwData3

Weitere Informationen finden Sie im Abschnitt Anmerkungen weiter unten.

Bemerkungen

dwData1-, dwData2- und dwData3-Member enthalten vom Aufrufer bereitgestellte Werte, die von den Inhalten des Type-Members abhängen:

Typelement enthält PSUIPAGEINSERT_DLL

dwData1 – Vom Aufrufer bereitgestellter Zeiger auf eine MIT NULL beendete Zeichenfolge, die den NAMEN des DLL-Pfads darstellt.

dwData2 – Vom Aufrufer bereitgestellter Zeiger auf eine MIT NULL beendete Zeichenfolge, die den Namen einer PFNPROPSHEETUI- typisierter Funktion darstellt, die in der angegebenen DLL enthalten ist.

dwData3 – Vom Aufrufer bereitgestellter 32-Bit-Wert, der für den lParam--Parameter an die PFNPROPSHEETUI-Typfunktion übergeben wird.

Typelement enthält PSUIPAGEINSERT_GROUP_PARENT

dwData1 – Nicht verwendet, muss null sein.

dwData2 – Nicht verwendet, muss null sein.

dwData3 - Nicht verwendet, muss null sein.

Typelement enthält PSUIPAGEINSERT_HPROPSHEETPAGE

dwData1 – Vom Aufrufer bereitgestelltes Handle für ein Eigenschaftenblatt, das von CreatePropertySheetPagezurückgegeben wird.

dwData2 – Nicht verwendet, muss null sein.

dwData3 - Nicht verwendet, muss null sein.

Typelement enthält PSUIPAGEINSERT_PCOMPROPSHEETUI

dwData1 – Vom Aufrufer bereitgestellter Zeiger auf eine COMPROPSHEETUI-Struktur.

dwData2 – Bei Erfolg erhält die Anzahl der eingefügten Seiten. Bei Einem Fehler empfängt ein ERR_CPSUI-Präfix-Fehlercode.

dwData3 - Nicht verwendet, muss null sein.

Typelement enthält PSUIPAGEINSERT_PFNPROPSHEETUI

dwData1 – Vom Aufrufer bereitgestellter Zeiger auf eine PFNPROPSHEETUI-typierte Funktion.

dwData2 – Vom Aufrufer bereitgestellter 32-Bit-Wert, der für den lParam--Parameter an die PFNPROPSHEETUI-Typfunktion übergeben wird.

dwData3 - Nicht verwendet, muss null sein.

Typelement enthält PSUIPAGEINSERT_PROPSHEETPAGE

dwData1 – Vom Aufrufer bereitgestellter Zeiger auf eine PROPSHEETPAGE-Struktur.

dwData2 – Nicht verwendet, muss null sein.

dwData3 - Nicht verwendet, muss null sein.

Anforderungen

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