structure INSERTPSUIPAGE_INFO (compstui.h)

Article
03/08/2023

La structure INSERTPSUIPAGE_INFO est utilisée comme paramètre d’entrée pour la fonction ComPropSheet de CPSUI, si le code de la fonction est CPSFUNC_INSERT_PSUIPAGE. Toutes les valeurs membres doivent être fournies par l’appelant ComPropSheet .

Syntaxe

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

Membres

cbSize

Taille fournie par l’appelant, en octets, de la structure INSERTPSUIPAGE_INFO.

Type

Valeur entière fournie par l’appelant indiquant le type d’insertion demandé. Le membre peut contenir l’une des constantes suivantes :

PSUIPAGEINSERT_DLL

CPSUI appelle la fonction de type PFNPROPSHEETUI spécifiée, avec une valeur de raison de PROPSHEETUI_REASON_INIT. La fonction est contenue dans une DLL distincte.

PSUIPAGEINSERT_GROUP_PARENT

CPSUI crée un nouveau parent de groupe.

PSUIPAGEINSERT_HPROPSHEETPAGE

CPSUI insère une page qui a été créée en appelant CreatePropertySheetPage.

(Cela équivaut à appeler ComPropSheet avec un code de fonction de CPSFUNC_ADD_HPROPSHEETPAGE.)

PSUIPAGEINSERT_PCOMPROPSHEETUI

CPSUI insère des pages décrites par une structure COMPROPSHEETUI .

(Cela équivaut à appeler ComPropSheet avec un code de fonction de CPSFUNC_ADD_PCOMPROPSHEETUI.)

PSUIPAGEINSERT_PFNPROPSHEETUI

CPSUI appelle la fonction de type PFNPROPSHEETUI spécifiée, avec une valeur de raison de PROPSHEETUI_REASON_INIT.

(Cela équivaut à appeler ComPropSheet avec un code de fonction de CPSFUNC_ADD_PFNPROPSHEETUI.)

PSUIPAGEINSERT_PROPSHEETPAGE

CPSUI insère la page décrite par la structure PROPSHEETPAGE spécifiée.

(Cela équivaut à appeler ComPropSheet avec un code de fonction de CPSFUNC_ADD_PROPSHEETPAGE.)

Mode

Valeur fournie par l’appelant indiquant où CPSUI doit insérer les nouvelles pages. Il doit s’agir de l’une des valeurs suivantes :

INSPSUIPAGE_MODE_AFTER

CPSUI insère des pages après la page identifiée par le handle de page CPSUI spécifié par le paramètre lParam1 dans ComPropSheet.

INSPSUIPAGE_MODE_BEFORE

CPSUI insère des pages avant la page identifiée par le handle de page CPSUI spécifié par le paramètre lParam1 dans ComPropSheet.

INSPSUIPAGE_MODE_FIRST_CHILD

CPSUI insère des pages en tant que premiers enfants du groupe parent identifié par le paramètre hComPropSheet dans ComPropSheet.

Le paramètre lParam1 de ComPropSheet est ignoré.

INSPUIPAGE_MODE_INDEX

CPSUI insère des pages en tant qu’enfants du groupe parent identifié par le paramètre hComPropSheet dans ComPropSheet.

Le paramètre lParam1 de ComPropSheet spécifie un index de base zéro identifiant où, dans le jeu d’enfants, les pages spécifiées doivent être insérées. Si lParam1 a la valeur 0, les pages sont insérées à partir de la page 1 ; si lParam1 a la valeur 1, les pages sont insérées à partir de la page 2 ; et ainsi de suite. Si l’index est supérieur au nombre d’enfants existants, les nouvelles pages sont ajoutées comme derniers enfants. La valeur lParam1 doit être spécifiée comme HINSPSUIPAGE_INDEX(index).

INSPSUIPAGE_MODE_LAST_CHILD

CPSUI insère des pages en tant que derniers enfants du groupe parent identifié par le paramètre hComPropSheet dans ComPropSheet.

Le paramètre lParam1 de ComPropSheet est ignoré.

dwData1

Consultez la section Remarques ci-dessous.

dwData2

Consultez la section Remarques ci-dessous.

dwData3

Consultez la section Remarques ci-dessous.

Remarques

Les membres dwData1, dwData2 et dwData3 contiennent des valeurs fournies par l’appelant qui dépendent du contenu du membre Type , comme suit :

Type member contient des PSUIPAGEINSERT_DLL

dwData1 : pointeur fourni par l’appelant vers une chaîne terminée par null représentant le nom du chemin d’accès DLL.

dwData2 : pointeur fourni par l’appelant vers une chaîne terminée par NULL représentant le nom d’une fonction typée PFNPROPSHEETUI , contenue dans la DLL spécifiée.

dwData3 : valeur 32 bits fournie par l’appelant, transmise à la fonction de type PFNPROPSHEETUI pour son paramètre lParam .