Compartilhar via


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

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

pUFObj

Ponteiro fornecido pelo chamador para uma estrutura UNIFONTOBJ .

dwType

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

Valor Definição
TYPE_GLYPHHANDLE Os elementos da matriz pGlyph são alças de glifo do tipo HGLYPH.
TYPE_GLYPHID Os elementos da matriz 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.

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::OutputCharStr método é usado para dar suporte a impressoras que não reconhecem os comandos de saída de caracteres formatados por 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 IPrintOemUni::OutputCharStr método , Unidrv chamará o método sempre que uma cadeia de caracteres estiver pronta para ser spool.

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 suave (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:

  1. Aloque uma estrutura de GETINFO_GLYPHSTRING com dwTypeIn definido como TYPE_GLYPHHANDLE e dwTypeOut definidos como TYPE_TRANSDATA.
  2. Chame a função UNIFONTOBJ_GetInfo , passando a estrutura GETINFO_GLYPHSTRING como entrada, para obter traduções de glifo como conteúdo de estrutura TRANSDATA .
  3. 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 para enviar comandos para o spooler de impressão que fará com que os glifos baixados anteriormente especificados sejam impressos.

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

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

Requisitos

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