Función de devolución de llamada PFNPROPSHEETUI (compstui.h)

Las aplicaciones CPSUI usan el tipo de función PFNPROPSHEETUI (incluidos los archivos DLL de interfaz de impresora) para definir devoluciones de llamada de creación de páginas, que especifican páginas de hoja de propiedades para su creación.

Sintaxis

PFNPROPSHEETUI Pfnpropsheetui;

LONG Pfnpropsheetui(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM lParam
)
{...}

Parámetros

pPSUIInfo

Puntero proporcionado por CPSUI a una estructura PROPSHEETUI_INFO .

lParam

Valor entero proporcionado por CPSUI que depende del contenido del miembro Reason de la estructura PROPSHEETUI_INFO . Los valores válidos son los siguientes:

PROPSHEETUI_REASON_BEFORE_INIT

Este valor es nuevo en Windows 8 y solo se proporciona al parámetro PFNPROPSHEETUI original pasado a CommonPropertySheetUI.

PROPSHEETUI_REASON_DESTROY

El valor lParam es distinto de cero si el usuario ha seleccionado el botón Aceptar o Cancelar de la hoja de propiedades. De lo contrario, el valor es cero.

PROPSHEETUI_REASON_GET_ICON

El valor lParam es un puntero a una estructura PROPSHEETUI_GETICON_INFO .

PROPSHEETUI_REASON_GET_INFO_HEADER

El valor lParam es un puntero a una estructura PROPSHEETUI_INFO_HEADER .

PROPSHEETUI_REASON_INIT

Si el parámetro pfnPropSheetUI especifica la función de devolución de llamada en CommonPropertySheetUI, lParam es el valor lParam pasado a CommonPropertySheetUI.

Si se especifica la función de devolución de llamada mediante el código de función CPSFUNC_ADD_PFNPROPSHEETUI con la función ComPropSheet de CPSUI, lParam es el valor lParam2 pasado a ComPropSheet.

CPSUI copia el valor lParam en el miembro lParamInit de la estructura PROPSHEETUI_INFO de la función.

El valor lParam no debe residir en la pila de la aplicación.

PROPSHEETUI_REASON_SET_RESULT

El valor lParam es un puntero a una estructura SETRESULT_INFO .

Valor devuelto

Si la operación se realiza correctamente, la función debe devolver un valor de uno (o superior). De lo contrario, debe devolver un valor menor que uno.

Código devuelto	Descripción
Uno o mayor.	Se llamará a la función PFNPROPSHEETUI asociada al elemento primario de la página actual.
Menor que 1.	No se llamará a la función PFNPROPSHEETUI asociada al elemento primario de la página actual.

Comentarios

Las funciones de devolución de llamada especificadas mediante el tipo de función PFNPROPSHEETUI se proporcionan mediante aplicaciones que usan CPSUI para administrar páginas de hojas de propiedades personalizadas. Se debe especificar una de estas funciones de devolución de llamada cuando una aplicación llama a la función CommonPropertySheetUI . Por ejemplo, cuando el administrador de impresión del sistema operativo basado en NT llama a la función CommonPropertySheetUI de CPSUI para admitir sus funciones DocumentProperties o PrinterProperties , el administrador de trabajos especifica una función de devolución de llamada con tipo PFNPROPSHEETUI interna.

Las aplicaciones pueden especificar funciones de devolución de llamada de tipo PFNPROPSHEETUI adicionales mediante una llamada a la función ComPropSheet de CPSUI con un código de función de CPSFUNC_ADD_PFNPROPSHEETUI. Por ejemplo, el administrador de trabajos de impresión del sistema operativo basado en NT hace esto para notificar a CPSUI la existencia de las funciones DrvDocumentPropertySheets y DrvDevicePropertySheets de una interfaz de impresora. Del mismo modo, los controladores Unidrv y Pscript de Microsoft usan esta técnica para notificar a CPSUI la existencia de IPrintOemUI::D ocumentPropertySheets e IPrintOemUI::D evicePropertySheets métodos en complementos de interfaz de usuario.

CPSUI llama varias veces a cada función de devolución de llamada con tipo PFNPROPSHEETUI. El miembro Reason de la estructura de PROPSHEETUI_INFO estipula la operación que debe realizar la función, como se indica a continuación:

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	compstui.h (incluir Compstui.h)