Método IPrintOemUI::D evicePropertySheets (prcomoem.h)

Artículo
02/29/2024

El IPrintOemUI::DevicePropertySheets método permite que un complemento de interfaz de usuario anexe una nueva página a la hoja de propiedades de la impresora de un dispositivo de impresora.

Sintaxis

HRESULT DevicePropertySheets(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM            lParam
);

Parámetros

pPSUIInfo

Puntero proporcionado por el autor de la llamada a una estructura de PROPSHEETUI_INFO .

lParam

Valor proporcionado por el autor de la llamada que depende del valor de motivo en pPSUIInfo-->Reason. El valor de motivo puede ser una de las siguientes constantes, que se definen en compstui.h. Para obtener más información sobre estas constantes, vea la sección Comentarios y la descripción del parámetro lParam en el tipo de función PFNPROPSHEETUI .

PROPSHEETUI_REASON_DESTROY

PROPSHEETUI_REASON_GET_ICON

PROPSHEETUI_REASON_GET_INFO_HEADER

PROPSHEETUI_REASON_INIT

PROPSHEETUI_REASON_SET_RESULT

Valor devuelto

El valor devuelto depende del contenido del miembro Reason de PROPSHEETUI_INFO estructura. Para obtener más información, consulte la descripción de DrvDevicePropertySheets.

Comentarios

Un método del complemento de interfaz de IPrintOemUI::DevicePropertySheets usuario realiza los mismos tipos de operaciones que la función DrvDevicePropertySheets exportada por los archivos DLL de la interfaz de impresora en modo usuario. Ambas funciones tienen los mismos parámetros de entrada.

Si proporciona un complemento de interfaz de usuario, se llama al IPrintOemUI::DevicePropertySheets método después de llamar a la función DrvDevicePropertySheets del controlador.

Cuando IPrintOemUI::DevicePropertySheets se llama a , el miembro lParamInit de la estructura PROPSHEETUI_INFO contiene la dirección de una estructura OEMUIPSPARAM .

Si implementa este método, normalmente también proporciona una función de devolución de llamada con tipo _CPSUICALLBACK para controlar las modificaciones del usuario. Esta función de devolución de llamada debe llamar a IPrintOemDriverUI::D rvUpdateUISetting para informar al controlador cuando se ha modificado el valor asociado a una configuración de interfaz de usuario, si el valor se almacena en la estructura DEVMODEW del controlador (en lugar de los miembros PRIVADOS DEVMODEW del complemento) o en las claves del Registro.

Si IPrintOemUI::DevicePropertySheets varios complementos de interfaz de usuario exportan métodos, se llama a los métodos en el orden en que se especifican los complementos para la instalación.

Si un complemento de interfaz de usuario admite varios modelos de impresora y solo desea que se muestre la nueva página para algunos de esos modelos, el IPrintOemUI::DevicePropertySheets método solo debe proporcionar un valor devuelto correcto, sin agregar realmente la página, para los modelos que no requieran la página.

Para obtener más información sobre cómo crear e instalar complementos de interfaz de usuario, vea Personalización de los controladores de impresora de Microsoft.