Estructura CPSUICBPARAM (compstui.h)

La estructura CPSUICBPARAM se usa como parámetro de entrada para _CPSUICALLBACK funciones 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 Acerca de la página y la aplicación estableció previamente la marca CPSUIF_ABOUT_CALLBACK en una estructura COMPROPSHEETUI . CPSUI establece pCurItem en el valor contenido en pOptItem y establece pOldSel para que apunte a la estructura COMPROPSHEETUI .

CPSUICB_REASON_APPLYNOW

El usuario ha realizado clic en el botón Aplicar o Aceptar de la página 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 ahora se deben aplicar 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 (TVOT_PUSHBUTTON tipo de opción) y el usuario ha clic en el botón.

El campo Estilo OPTPARAM de la opción de botón de inserción se establece 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 clic en el botón.

CPSUICB_REASON_ITEMS_REVERTED

El usuario ha realizado clic en el botón Deshacer de la página y CPSUI ha revertido todas las selecciones a sus valores originales.

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 pCurItem en el valor contenido en pOptItem y establece pOldSel para que apunte a la estructura COMPROPSHEETUI .

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 (TVOT_PUSHBUTTON tipo de opción) y el usuario ha clic en el botón.

El campoEstilo OPTPARAM del elemento de botón de inserción se establece 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 pCurItem en el valor contenido en pOptItem y establece pOldSel para que apunte a la estructura COMPROPSHEETUI .

hDlg

Identificador proporcionado por CPSUI en el cuadro de diálogo activo actualmente.

pOptItem

Puntero proporcionado por CPSUI a una matriz de estructuras OPTITEM . Este es el mismo puntero que la aplicación proporcionó anteriormente en una estructura COMPROPSHEETUI .

cOptItem

CPSUI proporciona el número de estructuras OPTITEM de la matriz a la que apunta pOptItem. Este es el mismo número que la aplicación proporcionó 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 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 para la que se llamó a la función de devolución de llamada.

DUMMYUNIONNAME

Define la unión DUMMYUNIONNAME .

DUMMYUNIONNAME.OldSel

Si el miembro Reason contiene CPSUICB_REASON_SEL_CHANGED, CPSUI establece esta unión en el contenido anterior del miembro OldSel/pOldSel de la estructura OPTITEM a la que apunta pCurItem.

Para todos los demás valores Reason , se debe omitir el contenido de esta unión.

DUMMYUNIONNAME.pOldSel

Si el miembro Reason contiene CPSUICB_REASON_SEL_CHANGED, CPSUI establece esta unión en el contenido anterior del miembro OldSel/pOldSel de la estructura OPTITEM a la que apunta pCurItem.

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 proporcionó 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 contenido del miembro Reason 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
Header	compstui.h (incluir Compstui.h)