Método IPrintOemUI::D ocumentPropertySheets (prcomoem.h)
El método IPrintOemUI::DocumentPropertySheets 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 de 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 lParam descripción del parámetro en el tipo de función PFNPROPSHEETUI 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 de PROPSHEETUI_INFO Reason de la estructura. Para obtener más información, consulte la descripción de DrvDocumentPropertySheets.
Observaciones
El método IPrintOemUI::DocumentPropertySheets de un complemento de interfaz de usuario realiza los mismos tipos de operaciones que los DrvDocumentPropertySheets función 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 método IPrintOemUI::DocumentPropertySheets después de llamar a la función drvDocumentPropertySheets del controlador.
Cuando se llama a IPrintOemUI::DocumentPropertySheets, el miembro lParamInit de la estructura PROPSHEETUI_INFO contiene la dirección de una estructura de OEMUIPSPARAM.
Si implementa este método, normalmente también proporciona una función de devolución de llamada con tipo _CPSUICALLBACKpara 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 de DEVMODEW del complemento) o en las claves del Registro.
Si varios complementos de interfaz de usuario exportan IPrintOemUI::DocumentPropertySheets 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 método IPrintOemUI::DocumentPropertySheets solo debe proporcionar un valor devuelto correcto, sin agregar realmente la página, para los modelos que no requieren 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.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | prcomoem.h (include Prcomoem.h, Compstui.h) |