Função DrvDevicePropertySheets (winddiui.h)

  • Artigo

A função DrvDevicePropertySheets de uma interface de impressora é responsável por criar páginas de folha de propriedades que descrevem as propriedades de uma impressora.

Sintaxe

LONG DrvDevicePropertySheets(
  [in, optional] PPROPSHEETUI_INFO pPSUIInfo,
                 LPARAM            lParam
);

Parâmetros

[in, optional] pPSUIInfo

Ponteiro fornecido pelo chamador para uma estrutura de PROPSHEETUI_INFO .

lParam

Valor inteiro fornecido pelo chamador que depende do conteúdo do membro Reason da estrutura PROPSHEETUI_INFO, conforme listado na tabela a seguir.

Valor do motivo Definição de lParam
PROPSHEETUI_REASON_INIT Ponteiro para uma estrutura DEVICEPROPERTYHEADER .
Todos os outros valores de motivo Consulte a descrição do parâmetro lParam para o tipo de função PFNPROPSHEETUI . (O endereço da estrutura DEVICEPROPERTYHEADER está contido no membro lParamInit da estrutura PROPSHEETUI_INFO .)

Retornar valor

Consulte a seção ReturnValue na descrição do tipo de função PFNPROPSHEETUI .

Comentários

Todas as DLLs da interface da impressora devem fornecer uma função DrvDevicePropertySheets , que é definida usando o tipo de função PFNPROPSHEETUI . A finalidade da função é chamar a função ComPropSheet , fornecida pelo CPSUI, para especificar uma página de folha de propriedades contendo propriedades modificáveis pelo usuário para a impressora.

A função deve executar operações conforme descrito para o tipo de função PFNPROPSHEETUI . A função deve criar a página da folha de propriedades DeviceSettings da impressora (consulte o membro pDlgPage da estrutura COMPROPSHEETUI ).

As configurações do dispositivo da impressora devem ser armazenadas no registro. Se um usuário com privilégio de administrador modificar opções na página DeviceSettings, a função DrvDevicePropertySheets deverá gravar os valores atualizados no registro chamando SetPrinterData (descrito na documentação do SDK do Microsoft Windows).

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho winddiui.h (inclua Winddiui.h)

Confira também

DrvDocumentPropertySheets

IPrintOemUI::D evicePropertySheets