Método IPrintOemUni::D ownloadCharGlyph (prcomoem.h)

Artigo
02/07/2025

O método IPrintOemUni::DownloadCharGlyph permite que um plug-in de renderização para Unidrv envie um glifo de caractere para uma fonte flexível especificada para a impressora.

Sintaxe

HRESULT DownloadCharGlyph(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
        HGLYPH      hGlyph,
        PDWORD      pdwWidth,
  [out] OUT DWORD   *pdwResult
);

Parâmetros

pdevobj

Ponteiro fornecido pelo chamador para uma estrutura de DEVOBJ.

pUFObj

Ponteiro fornecido pelo chamador para uma estrutura de UNIFONTOBJ.

hGlyph

Identificador de glifo fornecido pelo chamador.

pdwWidth

Ponteiro fornecido pelo chamador para receber a largura fornecida pelo método do caractere.

[out] pdwResult

Recebe um valor fornecido pelo método que representa a quantidade de memória da impressora, em bytes, necessária para armazenar o glifo de caractere. Se a operação falhar, o valor retornado deverá ser zero.

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::DownloadCharGlyph é usado para dar suporte a fontes suaves em impressoras que não aceitam comandos PCL. Sua finalidade é habilitar um plug-in de renderização para enviar um glifo de caractere para a impressora.

Se um plug-in de renderização implementar o método IPrintOemUni::DownloadCharGlyph, Unidrv chamará o método imediatamente após o envio da cadeia de caracteres de comando especificada pela entrada de comando CmdSetCharCode, que está contida no arquivo de GPD da impressora. (Arquivos GPD são descritos em Microsoft Universal Printer Driver.) O método deve fazer o seguinte:

Chame a função UNIFONTOBJ_GetInfo para obter a imagem de glifo especificada por hGlyph.
Chame IPrintOemDriverUni::D rvWriteSpoolBuf para enviar o glifo para a impressora.
Chame a função UNIFONTOBJ_GetInfo novamente para obter a largura do glifo e armazene a largura no endereço apontado por pdwWidth.
Retorne a quantidade de memória da impressora necessária para armazenar o glifo colocando-o no local especificado por pdwResult.

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

Se você implementar o método IPrintOemUni::DownloadCharGlyph, também deverá implementar o método IPrintOemUni::D ownloadFontHeader.

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