INSERTPSUIPAGE_INFO Struktur (compstui.h)

Artikel
02/26/2024

Die INSERTPSUIPAGE_INFO-Struktur wird als Eingabeparameter für die ComPropSheet-Funktion von CPSUI verwendet, wenn der Funktionscode CPSFUNC_INSERT_PSUIPAGE ist. Alle Memberwerte müssen vom ComPropSheet-Aufrufer 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;

Member

cbSize

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

Type

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

PSUIPAGEINSERT_DLL

CPSUI ruft die angegebene typisierte PFNPROPSHEETUI-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 von CreatePropertySheetPage erstellt wurde.

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

PSUIPAGEINSERT_PCOMPROPSHEETUI

CPSUI fügt Seiten ein, die von einer COMPROPSHEETUI-Struktur beschrieben werden.

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

PSUIPAGEINSERT_PFNPROPSHEETUI

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

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

PSUIPAGEINSERT_PROPSHEETPAGE

CPSUI fügt die Seite ein, die von der angegebenen PROPSHEETPAGE-Struktur beschrieben wird.

(Dies entspricht dem Aufrufen von 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 einer der folgenden Werte sein:

INSPSUIPAGE_MODE_AFTER

CPSUI fügt Seiten nach der Seite ein, die durch das CPSUI-Seitenhandle identifiziert wurde, das vom lParam1-Parameter für ComPropSheet angegeben wird.

INSPSUIPAGE_MODE_BEFORE

CPSUI fügt Seiten vor der Seite ein, die durch das CPSUI-Seitenhandle identifiziert wird, das vom lParam1-Parameter für ComPropSheet angegeben wird.

INSPSUIPAGE_MODE_FIRST_CHILD

CPSUI fügt Seiten als erste untergeordnete Elemente der übergeordneten Gruppe ein, die durch den hComPropSheet-Parameter in ComPropSheet identifiziert wird.

Der lParam1-Parameter für ComPropSheet wird ignoriert.

INSPUIPAGE_MODE_INDEX

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

Der lParam1-Parameter für ComPropSheet gibt einen nullbasierten Index an, der angibt, wo innerhalb der Gruppe der untergeordneten Elemente die angegebenen Seiten eingefügt werden sollen. Wenn lParam1 0 ist, werden die Seiten ab Seite 1 eingefügt; wenn lParam1 1 ist, werden die Seiten ab Seite 2 eingefügt; Und so weiter. Wenn der Index größer als die Anzahl vorhandener untergeordneter Elemente ist, werden die neuen Seiten als letzte untergeordnete 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 durch den hComPropSheet-Parameter in ComPropSheet identifiziert wird.

Der lParam1-Parameter für ComPropSheet wird ignoriert.

dwData1

Weitere Informationen finden Sie weiter unten im Abschnitt Hinweise .

dwData2

Weitere Informationen finden Sie weiter unten im Abschnitt Hinweise .

dwData3

Weitere Informationen finden Sie weiter unten im Abschnitt Hinweise .

Hinweise

dwData1-, dwData2- und dwData3-Member enthalten vom Aufrufer bereitgestellte Werte, die vom Inhalt des Type-Members abhängen, wie folgt:

Typmember enthält PSUIPAGEINSERT_DLL

dwData1: Vom Aufrufer bereitgestellter Zeiger auf eine NULL-Zeichenfolge, die den DLL-Pfadnamen darstellt.

dwData2: Vom Aufrufer bereitgestellter Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen einer pfnpropsheetUI-typisierten Funktion darstellt, die in der angegebenen DLL enthalten ist.

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