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

Artículo
08/07/2023

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

Sintaxis

HRESULT DocumentPropertySheets(
  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 la estructura PROPSHEETUI_INFO. Para obtener más información, consulte la descripción de DrvDocumentPropertySheets.

Comentarios

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

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

Cuando IPrintOemUI::DocumentPropertySheets 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::DocumentPropertySheets 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::DocumentPropertySheets 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.