Estructura CPSUICBPARAM (compstui.h)
La estructura CPSUICBPARAM se usa como parámetro de entrada para _CPSUICALLBACKfunciones de devolución de llamada con tipo.
Sintaxis
typedef struct _CPSUICBPARAM {
WORD cbSize;
WORD Reason;
HWND hDlg;
POPTITEM pOptItem;
WORD cOptItem;
WORD Flags;
POPTITEM pCurItem;
union {
LONG OldSel;
LPTSTR pOldSel;
} DUMMYUNIONNAME;
ULONG_PTR UserData;
ULONG_PTR Result;
} CPSUICBPARAM, *PCPSUICBPARAM;
Miembros
cbSize
Tamaño proporcionado por CPSUI, en bytes, de la estructura CPSUICBPARAM.
Reason
Valor proporcionado por CPSUI que indica el motivo por el que llama a la función de devolución de llamada. Puede ser uno de los siguientes valores:
CPSUICB_REASON_ABOUT
El usuario ha realizado clic en el botón
CPSUICB_REASON_APPLYNOW
El usuario ha realizado clic en la de la página Aplicar o botón Aceptar y CPSUI ha recibido un mensaje de notificación PSN_APPLY. CPSUI establece pCurItem para que apunte a la opción a la que apunta pOptItem. También establece oldSel en menos uno para indicar que se deben aplicar ahora todos los valores de opción modificados válidos.
CPSUICB_REASON_DLGPROC
La opción identificada por pCurItem es un botón de inserción (tipo de opciónTVOT_PUSHBUTTON) y el usuario ha realizado clic en el botón.
El campo OPTPARAM Style de la opción de botón de inserción está establecido en PUSHBUTTON_TYPE_DLGPROC.
CPSUICB_REASON_ECB_CHANGED
La opción identificada por pCurItem es una casilla extendida y el usuario ha cambiado el estado de la casilla.
CPSUICB_REASON_EXTPUSH
La opción identificada por pCurItem es un botón de inserción extendido y el usuario ha realizado clic en el botón.
CPSUICB_REASON_ITEMS_REVERTED
El usuario ha realizado clic en el botón Deshacer de la página
CPSUICB_REASON_KILLACTIVE
La página de la hoja de propiedades está a punto de perder la activación y CPSUI ha recibido un mensaje de notificación PSN_KILLACTIVE. CPSUI establece
CPSUICB_REASON_OPTITEM_SETFOCUS
La opción identificada por pCurItem ha recibido el foco de entrada.
CPSUICB_REASON_PUSHBUTTON
La opción identificada por pCurItem es un botón de inserción (tipo de opciónTVOT_PUSHBUTTON) y el usuario ha realizado clic en el botón.
El campo OPTPARAMStyle del elemento de botón de inserción está establecido en PUSHBUTTON_TYPE_CALLBACK.
CPSUICB_REASON_SEL_CHANGED
El usuario ha cambiado el valor seleccionado de la opción a la que apunta pCurItem.
CPSUICB_REASON_SETACTIVE
La página de la hoja de propiedades está a punto de activarse y CPSUI ha recibido un mensaje de notificación PSN_SETACTIVE. CPSUI establece
hDlg
Identificador proporcionado por CPSUI al cuadro de diálogo activo actualmente.
pOptItem
Puntero proporcionado por CPSUI a una matriz de estructuras de OPTITEM. Este es el mismo puntero que la aplicación proporcionada anteriormente en una estructura COMPROPSHEETUI.
cOptItem
CPSUI proporciona el número de estructuras OPTITEM de la matriz a las que apunta pOptItem. Este es el mismo número que la aplicación proporcionada anteriormente en una estructura COMPROPSHEETUI.
Flags
Marcas proporcionadas por CPSUI. Este es el mismo conjunto de marcas que la aplicación proporcionó anteriormente en una estructura de COMPROPSHEETUI.
pCurItem
Puntero proporcionado por CPSUI a un miembro de la matriz OPTITEM a la que apunta pOptItem. Este miembro de matriz representa la opción "actual", que es la que se llamó a la función de devolución de llamada.
DUMMYUNIONNAME
Define la unión
DUMMYUNIONNAME.OldSel
Si el miembro
Para todos los demás valores Reason, se debe omitir el contenido de esta unión.
DUMMYUNIONNAME.pOldSel
Si el miembro
Para todos los demás valores Reason, se debe omitir el contenido de esta unión.
UserData
Datos de usuario proporcionados por CPSUI. Este es el mismo valor que la aplicación proporcionada anteriormente en una estructura COMPROPSHEETUI.
Result
Valor de resultado proporcionado por la función de devolución de llamada con tipo _CPSUICALLBACK. De forma predeterminada, CPSUI establece este valor en CPSUI_OK. Una vez que se devuelve la función de devolución de llamada, CPSUI llama a su función ComPropSheet con un código de función de CPSFUNC_SET_RESULT, proporcionando el Reason contenido del miembro como valor de resultado.
Este miembro solo se usa si el miembro Reason es CPSUICB_REASON_APPLYNOW y la función de devolución de llamada no devuelve CPSUI_ACTION_NO_APPLY_EXIT.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de |
compstui.h (include Compstui.h) |