Método IPrintOemUni::SendFontCmd (prcomoem.h)

Artigo
02/29/2024

O IPrintOemUni::SendFontCmd método permite que um plug-in de renderização modifique o comando de seleção de fonte de uma impressora e, em seguida, envie-o para a impressora.

Sintaxe

HRESULT SendFontCmd(
  PDEVOBJ      pdevobj,
  PUNIFONTOBJ  pUFObj,
  PFINVOCATION pFInv
);

Parâmetros

pdevobj

Ponteiro fornecido pelo chamador para uma estrutura DEVOBJ .

pUFObj

Ponteiro fornecido pelo chamador para uma estrutura UNIFONTOBJ .

pFInv

Ponteiro fornecido pelo chamador para uma estrutura FINVOCATION .

Retornar valor

O método deve retornar um dos valores a seguir.

Código de retorno	Descrição
S_OK	A operação foi realizada com êxito.
E_FAIL	Falha na operação.
E_NOTIMPL	O método não está implementado.

Comentários

O IPrintOemUni::SendFontCmd método é usado para selecionar fontes de dispositivo em impressoras que não reconhecem os comandos de fonte formatados por PCL, CAPSL ou PPDS compatíveis com Unidrv. Sua finalidade é permitir que um plug-in de renderização modifique o comando de seleção de fonte especificado no arquivo .ufm (Métricas de Fonte Unidrv) da fonte. (Para ver como o comando é armazenado, consulte a descrição da estrutura UNIDRVINFO do arquivo .ufm.) Se o comando precisar ser modificado antes de ser enviado para a impressora, você deverá implementar o IPrintOemUni::SendFontCmd método .

O método recebe a cadeia de caracteres de comando na estrutura FINVOCATION apontada por pFInv. Normalmente, a cadeia de caracteres contém variáveis para as quais os valores devem ser fornecidos. Por exemplo, o seguinte comando de seleção de fonte requer que #FontHeight e #FontWidth sejam substituídos por valores numéricos:

\x1B(9U\x1B(s4148t0b0s#FontHeight1P\x1B)6J\x1B)s4148t0b0s#FontWidth1P

Os valores atuais para a altura e largura da fonte podem ser obtidos chamando UNIFONTOBJ_GetInfo para ler as variáveis padrão da Unidrv.

Sempre que o IPrintOemUni::SendFontCmd método for chamado, ele deverá enviar a cadeia de caracteres de comando para a impressora chamando IPrintOemDriverUni::D rvWriteSpoolBuf.

O IPrintOemUni::SendFontCmd método é opcional. Se um plug-in de renderização implementar esse método, o método IPrintOemUni::GetImplementedMethod do plug-in deverá retornar S_OK quando receber "SendFontCmd" como entrada.

Para obter informações adicionais, consulte Gerenciamento personalizado de fontes.