estructura INSERTPSUIPAGE_INFO (compstui.h)

Artículo
02/25/2024

La estructura INSERTPSUIPAGE_INFO se usa como parámetro de entrada para la función ComPropSheet de CPSUI, si el código de la función es CPSFUNC_INSERT_PSUIPAGE. El llamador comPropSheet debe proporcionar todos los valores de miembro.

Sintaxis

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

Miembros

cbSize

Tamaño proporcionado por el autor de la llamada, en bytes, de la estructura INSERTPSUIPAGE_INFO.

Type

Valor entero proporcionado por el autor de la llamada que indica el tipo de inserción que se solicita. El miembro puede contener una de las siguientes constantes:

PSUIPAGEINSERT_DLL

CPSUI llama a la función con tipo PFNPROPSHEETUI especificada, con un valor de motivo de PROPSHEETUI_REASON_INIT. La función se encuentra en un archivo DLL independiente.

PSUIPAGEINSERT_GROUP_PARENT

CPSUI crea un nuevo grupo primario.

PSUIPAGEINSERT_HPROPSHEETPAGE

CPSUI inserta una página que se ha creado llamando a CreatePropertySheetPage.

(Esto equivale a llamar a ComPropSheet con un código de función de CPSFUNC_ADD_HPROPSHEETPAGE).

PSUIPAGEINSERT_PCOMPROPSHEETUI

CPSUI inserta páginas descritas por una estructura COMPROPSHEETUI .

(Esto equivale a llamar a ComPropSheet con un código de función de CPSFUNC_ADD_PCOMPROPSHEETUI).

PSUIPAGEINSERT_PFNPROPSHEETUI

CPSUI llama a la función con tipo PFNPROPSHEETUI especificada, con un valor de motivo de PROPSHEETUI_REASON_INIT.

(Esto equivale a llamar a ComPropSheet con un código de función de CPSFUNC_ADD_PFNPROPSHEETUI).

PSUIPAGEINSERT_PROPSHEETPAGE

CPSUI inserta la página descrita por la estructura PROPSHEETPAGE especificada.

(Esto equivale a llamar a ComPropSheet con un código de función de CPSFUNC_ADD_PROPSHEETPAGE).

Mode

Valor proporcionado por el autor de la llamada que indica dónde CPSUI debe insertar las nuevas páginas. Debe tener uno de los siguientes valores:

INSPSUIPAGE_MODE_AFTER

CPSUI inserta páginas después de la página identificada por el identificador de página CPSUI especificado por el parámetro lParam1 en ComPropSheet.

INSPSUIPAGE_MODE_BEFORE

CPSUI inserta páginas antes de la página identificada por el identificador de página CPSUI especificado por el parámetro lParam1 en ComPropSheet.

INSPSUIPAGE_MODE_FIRST_CHILD

CPSUI inserta páginas como los primeros elementos secundarios del grupo primario identificados por el parámetro hComPropSheet en ComPropSheet.

Se omite el parámetro lParam1 en ComPropSheet .

INSPUIPAGE_MODE_INDEX

CPSUI inserta páginas como elementos secundarios del grupo primario identificado por el parámetro hComPropSheet en ComPropSheet.

El parámetro lParam1 de ComPropSheet especifica un índice de base cero que identifica dónde, dentro del conjunto de elementos secundarios, se deben insertar las páginas especificadas. Si lParam1 es 0, las páginas se insertan a partir de la página 1; si lParam1 es 1 , las páginas se insertan a partir de la página 2; y así sucesivamente. Si el índice es mayor que el número de elementos secundarios existentes, las páginas nuevas se agregan como los últimos elementos secundarios. El valor lParam1 debe especificarse como HINSPSUIPAGE_INDEX(index).

INSPSUIPAGE_MODE_LAST_CHILD

CPSUI inserta páginas como los últimos elementos secundarios del grupo primario identificados por el parámetro hComPropSheet en ComPropSheet.

Se omite el parámetro lParam1 en ComPropSheet .

dwData1

Consulte la sección Comentarios a continuación.

dwData2

Consulte la sección Comentarios a continuación.

dwData3

Consulte la sección Comentarios a continuación.

Comentarios

Los miembros dwData1, dwData2 y dwData3 contienen valores proporcionados por el autor de la llamada que dependen del contenido del miembro Type , como se indica a continuación:

El miembro de tipo contiene PSUIPAGEINSERT_DLL

dwData1: puntero proporcionado por el llamador a una cadena terminada en NULL que representa el nombre de la ruta de acceso dll.

dwData2: puntero proporcionado por el llamador a una cadena terminada en NULL que representa el nombre de una función con tipo PFNPROPSHEETUI , incluida en el archivo DLL especificado.

dwData3: valor de 32 bits proporcionado por el llamador, pasado a la función con tipo PFNPROPSHEETUI para su parámetro lParam .