INSERTPSUIPAGE_INFO struttura (compstui.h)

Articolo
02/26/2024

La struttura INSERTPSUIPAGE_INFO viene usata come parametro di input per la funzione ComPropSheet di CPSUI , se il codice della funzione è CPSFUNC_INSERT_PSUIPAGE. Tutti i valori membro devono essere forniti dal chiamante ComPropSheet .

Sintassi

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

Members

cbSize

Dimensioni fornite dal chiamante, in byte, della struttura INSERTPSUIPAGE_INFO.

Type

Valore integer fornito dal chiamante che indica il tipo di inserimento richiesto. Il membro può contenere una delle costanti seguenti:

PSUIPAGEINSERT_DLL

CPSUI chiama la funzione tipizzata PFNPROPSHEETUI specificata, con un valore motivo di PROPSHEETUI_REASON_INIT. La funzione è contenuta in una DLL separata.

PSUIPAGEINSERT_GROUP_PARENT

CPSUI crea un nuovo elemento padre del gruppo.

PSUIPAGEINSERT_HPROPSHEETPAGE

CPSUI inserisce una pagina creata chiamando CreatePropertySheetPage.

Questo equivale a chiamare ComPropSheet con un codice di funzione di CPSFUNC_ADD_HPROPSHEETPAGE.

PSUIPAGEINSERT_PCOMPROPSHEETUI

CPSUI inserisce pagine descritte da una struttura COMPROPSHEETUI .

Questo equivale a chiamare ComPropSheet con un codice di funzione di CPSFUNC_ADD_PCOMPROPSHEETUI.

PSUIPAGEINSERT_PFNPROPSHEETUI

CPSUI chiama la funzione tipizzata PFNPROPSHEETUI specificata, con un valore motivo di PROPSHEETUI_REASON_INIT.

Questo equivale a chiamare ComPropSheet con un codice di funzione di CPSFUNC_ADD_PFNPROPSHEETUI.

PSUIPAGEINSERT_PROPSHEETPAGE

CPSUI inserisce la pagina descritta dalla struttura PROPSHEETPAGE specificata.

Questo equivale a chiamare ComPropSheet con un codice di funzione di CPSFUNC_ADD_PROPSHEETPAGE.

Mode

Valore fornito dal chiamante che indica dove CPSUI deve inserire le nuove pagine. Deve essere uno dei valori seguenti:

INSPSUIPAGE_MODE_AFTER

CPSUI inserisce pagine dopo la pagina identificata dall'handle di pagina CPSUI specificato dal parametro lParam1 in ComPropSheet.

INSPSUIPAGE_MODE_BEFORE

CPSUI inserisce pagine prima della pagina identificata dall'handle di pagina CPSUI specificato dal parametro lParam1 in ComPropSheet.

INSPSUIPAGE_MODE_FIRST_CHILD

CPSUI inserisce pagine come primi elementi figlio del gruppo padre identificato dal parametro hComPropSheet in ComPropSheet.

Il parametro lParam1 in ComPropSheet viene ignorato.

INSPUIPAGE_MODE_INDEX

CPSUI inserisce pagine come elementi figlio del gruppo padre identificato dal parametro hComPropSheet in ComPropSheet.

Il parametro lParam1 in ComPropSheet specifica un indice in base zero che identifica dove, all'interno del set di elementi figlio, le pagine specificate devono essere inserite. Se lParam1 è 0, le pagine vengono inserite a partire dalla pagina 1; se lParam1 è 1, le pagine vengono inserite a partire dalla pagina 2; E così via. Se l'indice è maggiore del numero di elementi figlio esistenti, le nuove pagine vengono aggiunte come ultimi elementi figlio. Il valore lParam1 deve essere specificato come HINSPSUIPAGE_INDEX(index).

INSPSUIPAGE_MODE_LAST_CHILD

CPSUI inserisce pagine come ultimi elementi figlio del gruppo padre identificato dal parametro hComPropSheet in ComPropSheet.

Il parametro lParam1 in ComPropSheet viene ignorato.

dwData1

Vedere la sezione Osservazioni di seguito.

dwData2

Vedere la sezione Osservazioni di seguito.

dwData3

Vedere la sezione Osservazioni di seguito.

Commenti

I membri dwData1, dwData2 e dwData3 contengono valori forniti dal chiamante che dipendono dal contenuto del membro Type , come indicato di seguito:

Il membro del tipo contiene PSUIPAGEINSERT_DLL

dwData1: puntatore fornito dal chiamante a una stringa con terminazione NULL che rappresenta il nome del percorso DLL.

dwData2: puntatore fornito dal chiamante a una stringa con terminazione NULL che rappresenta il nome di una funzione tipizzata PFNPROPSHEETUI , contenuta nella DLL specificata.

dwData3 - Valore fornito dal chiamante a 32 bit, passato alla funzione PFNPROPSHEETUI-typed per il relativo parametro lParam .