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

Artigo
02/07/2025

O método IPrintOemUni::OutputCharStr permite que um plug-in de renderização controle a impressão de glifos de fonte.

Sintaxe

HRESULT OutputCharStr(
  PDEVOBJ     pdevobj,
  PUNIFONTOBJ pUFObj,
  DWORD       dwType,
  DWORD       dwCount,
  PVOID       pGlyph
);

Parâmetros

pdevobj

Ponteiro fornecido pelo chamador para uma estrutura de DEVOBJ.

pUFObj

Ponteiro fornecido pelo chamador para uma estrutura de UNIFONTOBJ.

dwType

Valor fornecido pelo chamador que indica o tipo de matriz do especificador de glifo apontado por pGlyph. Os valores válidos são os seguintes:

Valor	Definição
TYPE_GLYPHHANDLE	Os elementos de matriz pGlyph são alças de glifo do tipo HGLYPH.
TYPE_GLYPHID	Os elementos da matriz de pGlyph são identificadores de glifo do tipo DWORD.

dwCount

Valor fornecido pelo chamador que representa o número de especificadores de glifo na matriz apontada por pGlyph.

pGlyph

Ponteiro fornecido pelo chamador para uma matriz de especificadores de glifo, em que o tipo de elemento de matriz é indicado por dwType.

Valor de retorno

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

Código de retorno	Descrição
S_OK	A operação foi bem-sucedida.
E_FAIL	Falha na operação.
E_NOTIMPL	O método não é implementado.

Observações

O método IPrintOemUni::OutputCharStr é usado para dar suporte a impressoras que não reconhecem os comandos de saída de caracteres formatados PCL, CAPSL ou PPDS compatíveis com Unidrv. Sua finalidade é permitir que um plug-in de renderização controle a impressão dos glifos de uma fonte e forneça substituições de glifo, se necessário.

Se um plug-in de renderização implementar o método IPrintOemUni::OutputCharStr, o Unidrv chamará o método sempre que uma cadeia de caracteres estiver pronta para ser religada.

O método recebe uma matriz de especificadores de glifo. O valor recebido para dwType indica o tipo de identificador.

Se a fonte especificada for uma fonte de dispositivo, a matriz conterá identificadores de glifo. Os identificadores precisam ser convertidos em códigos de caractere ou comandos e, em seguida, enviados para o spooler de impressão para fazer com que os glifos do dispositivo sejam impressos.

Se a fonte especificada for uma fonte flexível (TrueType), a matriz conterá identificadores de glifo. Os identificadores representam glifos baixados anteriormente que precisam ser impressos.

Se a fonte especificada for uma fonte de dispositivo, o método deverá fazer o seguinte:

Aloque uma estrutura de GETINFO_GLYPHSTRING com dwTypeIn definido como TYPE_GLYPHHANDLE e dwTypeOut definido como TYPE_TRANSDATA.
Chame a função UNIFONTOBJ_GetInfo, passando a estrutura GETINFO_GLYPHSTRING como entrada, para obter traduções de glifo como conteúdo da estrutura TRANSDATA.
Chame IPrintOemDriverUni::D rvWriteSpoolBuf para enviar conteúdo da estrutura TRANSDATA para o spooler de impressão, a fim de imprimir os glifos.

Se a fonte especificada for uma fonte flexível, o método poderá chamar IPrintOemDriverUni::D rvWriteSpoolBuf enviar comandos para o spooler de impressão que fará com que os glifos baixados anteriormente especificados sejam impressos.

O método IPrintOemUni::OutputCharStr é 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 "OutputCharStr" como entrada.

Para obter informações adicionais, consulte de Gerenciamento de Fontes Personalizado.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	prcomoem.h (inclua Prcomoem.h)

Compartilhar via