Função de retorno de chamada OEMCUIPCALLBACK (printoem.h)

O tipo de função OEMCUIPCALLBACK é usado para definir funções de retorno de chamada especificadas pelo método IPrintOemUI::CommonUIProp de um plug-in de interface do usuário. A estrutura é definida em printoem.h.

Sintaxe

OEMCUIPCALLBACK Oemcuipcallback;

LONG Oemcuipcallback(
  PCPSUICBPARAM unnamedParam1,
  POEMCUIPPARAM unnamedParam2
)
{...}

Parâmetros

unnamedParam1

Ponteiro para uma estrutura CPSUICBPARAM .

unnamedParam2

Ponteiro para uma estrutura OEMCUIPPARAM .

Retornar valor

Consulte a seção Comentários a seguir.

Comentários

Uma função de retorno de chamada especificada por um método IPrintOemUI::CommonUIProp é chamada quando um usuário modifica uma folha de propriedades da impressora. A finalidade da função de retorno de chamada é processar modificações do usuário em itens de opção personalizados.

Quando um item de folha de propriedades é modificado, o CPSUI chama a DLL da interface da impressora do driver de impressora. Essa DLL contém sua própria função de retorno de chamada, do tipo _CPSUICALLBACK, que processa valores de opção contidos em suas próprias estruturas OPTITEM. Em seguida, a função de retorno de chamada da DLL da interface da impressora chama a função de retorno de chamada do plug-in da interface do usuário. Se vários plug-ins de interface do usuário forem fornecidos, a função de retorno de chamada de cada plug-in será chamada, por sua vez, na ordem em que os plug-ins foram instalados.

A função de retorno de chamada recebe um ponteiro para uma estrutura CPSUICBPARAM . O membro Reason da estrutura identifica o evento que fez com que a função de retorno de chamada fosse chamada. A função também recebe um ponteiro para a mesma estrutura OEMCUIPPARAM que foi usada quando o método IPrintOemUI::CommonUIProp especificou o endereço da função de retorno de chamada.

Os membros pOptItem e pCurItem da estrutura CPSUICBPARAM identificam a opção modificada. A função de retorno de chamada pode usar esses ponteiros, juntamente com os membros pOEMOptItems e cOEMOptItem da estrutura OEMCUIPPARAM, para determinar se a opção modificada pertence ao plug-in da interface do usuário.

Quando uma função de retorno de chamada é chamada, ela deve determinar se alguma de suas estruturas OPTITEM personalizadas são afetadas pelo valor Reason especificado. Se estiverem, a função deverá processar as opções afetadas e retornar um dos valores retornados prefixados por CPSUI_ACTION descritos para o tipo de função _CPSUICALLBACK . Caso contrário, ele deverá retornar CPSUICB_ACTION_NONE.

As seguintes regras adicionais se aplicam aos valores retornados da função de retorno de chamada:

• Se Reason contiver CPSUICB_REASON_APPLYNOW, o retorno de chamada deverá retornar CPSUICB_ACTION_ITEMS_APPLIED ou CPSUICB_ACTION_NO_APPLY_EXIT. No último caso, a interface do driver da impressora retorna imediatamente ao CPSUI sem chamar nenhuma outra função de retorno de chamada do plug-in de interface do usuário.

• Se Reason contiver qualquer valor, exceto CPSUICB_REASON_APPLYNOW, o valor retornado deverá ser um dos seguintes:

  • CPSUICB_ACTION_REINIT_ITEMS

  • CPSUICB_ACTION_OPTIF_CHANGED

  • CPSUICB_ACTION_NONE

    Esses valores retornados são listados em ordem de prioridade decrescente. Se houver vários plug-ins de interface do usuário, a DLL da interface da impressora chamará a função de retorno de chamada de cada um deles e salvará o valor retornado de prioridade mais alta, passando-o de volta para CPSUI.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	printoem.h (inclua Printoem.h, Compstui.h)