structure INSERTPSUIPAGE_INFO (compstui.h)
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 de membre doivent être fournies par l’appelant ComPropSheet.
typedef struct _INSERTPSUIPAGE_INFO {
WORD cbSize;
BYTE Type;
BYTE Mode;
ULONG_PTR dwData1;
ULONG_PTR dwData2;
ULONG_PTR dwData3;
} INSERTPSUIPAGE_INFO, *PINSERTPSUIPAGE_INFO;
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 :
CPSUI appelle la fonction PFNPROPSHEETUI spécifiée fonction typée, avec une valeur de raison de PROPSHEETUI_REASON_INIT. La fonction est contenue dans une DLL distincte.
CPSUI crée un parent de groupe.
CPSUI insère une page créée en appelant CreatePropertySheetPage.
(Cela équivaut à appeler ComPropSheet avec un code de fonction de CPSFUNC_ADD_HPROPSHEETPAGE.)
CPSUI insère des pages décrites par une structure COMPROPSHEETUI.
(Cela équivaut à appeler ComPropSheet avec un code de fonction de CPSFUNC_ADD_PCOMPROPSHEETUI.)
CPSUI appelle la fonction PFNPROPSHEETUI spécifiée fonction typée, avec une valeur de raison de PROPSHEETUI_REASON_INIT.
(Cela équivaut à appeler ComPropSheet avec un code de fonction de CPSFUNC_ADD_PFNPROPSHEETUI.)
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 :
CPSUI insère des pages après la page identifiée par le handle de page CPSUI spécifié par le paramètre lParam1 pour ComPropSheet.
CPSUI insère des pages avant la page identifiée par le handle de page CPSUI spécifié par le paramètre lParam1 à ComPropSheet.
CPSUI insère des pages en tant que premiers enfants du groupe parent identifié par le paramètre hComPropSheet pour ComPropSheet.
Le paramètre lParam1 sur ComPropSheet est ignoré.
CPSUI insère des pages en tant qu’enfants du groupe parent identifié par le paramètre hComPropSheet pour ComPropSheet.
Le paramètre lParam1 à ComPropSheet spécifie un index de base zéro identifiant où, dans l’ensemble d’enfants, les pages spécifiées doivent être insérées. Si lParam1 est 0, les pages sont insérées à partir de la page 1 ; si lParam1 est 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 en tant que derniers enfants. La valeur lParam1 doit être spécifiée en tant que HINSPSUIPAGE_INDEX(index).
CPSUI insère des pages en tant que derniers enfants du groupe parent identifié par le paramètre hComPropSheet pour ComPropSheet.
Le paramètre lParam1 sur ComPropSheet est ignoré.
dwData1
Consultez la section Remarques ci-dessous.
dwData2
Consultez la section Remarques ci-dessous.
dwData3
Consultez la section Remarques ci-dessous.
les membres dwData1, dwData2 et dwData3 contiennent des valeurs fournies par l’appelant qui dépendent du contenu du membre Type, comme suit :
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’un PFNPROPSHEETUI fonction typée, contenue dans la DLL spécifiée.
dwData3 - Valeur 32 bits fournie par l’appelant, transmise à la fonction typée PFNPROPSHEETUI pour son paramètre lParam.
dwData1 - Non utilisé, doit être égal à zéro.
dwData2 - Non utilisé, doit être égal à zéro.
dwData3 - Non utilisé, doit être égal à zéro.
dwData1 - Handle fourni par l’appelant dans une feuille de propriétés, retourné par CreatePropertySheetPage.
dwData2 - Non utilisé, doit être égal à zéro.
dwData3 - Non utilisé, doit être égal à zéro.
dwData1 - Pointeur fourni par l’appelant vers une structure COMPROPSHEETUI.
dwData2 - En cas de réussite, reçoit le nombre de pages insérées. En cas d’échec, reçoit un code d’erreur ERR_CPSUI préfixé.
dwData3 - Non utilisé, doit être égal à zéro.
dwData1 - Pointeur fourni par l’appelant vers une fonction typée PFNPROPSHEETUI.
dwData2 - Valeur 32 bits fournie par l’appelant, transmise à la fonction typée PFNPROPSHEETUI pour son paramètre lParam.
dwData3 - Non utilisé, doit être égal à zéro.
dwData1 - Pointeur fourni par l’appelant vers une structure PROPSHEETPAGE.
dwData2 - Non utilisé, doit être égal à zéro.
dwData3 - Non utilisé, doit être égal à zéro.
Exigence | Valeur |
---|---|
d’en-tête | compstui.h (include Compstui.h) |