Compartir a través de

Función de devolución de llamada LPFNPSPCALLBACKA (prsht.h)

  • Artículo

Especifica una función de devolución de llamada definida por la aplicación que una hoja de propiedades llama cuando se crea una página y cuando está a punto de destruirse. Una aplicación puede usar esta función para realizar operaciones de inicialización y limpieza para la página.

Sintaxis

LPFNPSPCALLBACKA Lpfnpspcallbacka;

UINT Lpfnpspcallbacka(
            HWND hwnd,
  [in]      UINT uMsg,
  [in, out] _PROPSHEETPAGEA *ppsp
)
{...}

Parámetros

hwnd

Tipo: HWND

Reservados; debe ser NULL.

[in] uMsg

Tipo: UINT

Marca de acción. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
PSPCB_ADDREF

Versión 5.80 o posterior. Se está creando una página. En esta función, no se usa el valor devuelto.
PSPCB_CREATE
 Se está creando un cuadro de diálogo para una página. Devuelve un valor distinto de cero para permitir que se cree o cero para evitarlo.
PSPCB_RELEASE
 Se está destruyendo una página. Se omite el valor devuelto.

[in, out] ppsp

Tipo: LPPROPSHEETPAGE

Puntero a una estructura PROPSHEETPAGE que define la página que se va a crear o destruir. Consulte la sección Comentarios para obtener más información.

Valor devuelto

Tipo: UINT

El valor devuelto depende del valor del parámetro uMsg .

Comentarios

Una aplicación debe especificar la dirección de esta función de devolución de llamada en el miembro pfnCallback de una estructura PROPSHEETPAGE antes de pasar la estructura a la función CreatePropertySheetPage .

Nota La hoja de propiedades está en proceso de manipular la lista de páginas cuando se llama a esta función. No intente agregar, quitar ni insertar páginas mientras controla esta notificación. Si lo hace, tendrá resultados imprevisibles.
 
A excepción del miembro lParam , la aplicación no debe modificar la estructura PROPSHEETPAGE . Si lo hace, tendrá resultados imprevisibles. El miembro lParam contiene datos definidos por la aplicación y se puede modificar según sea necesario.

Nota

El encabezado prsht.h define LPFNPSPCALLBACK como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado prsht.h