Compartilhar via


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

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

pUFObj

Ponteiro fornecido pelo chamador para uma estrutura 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.

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::DownloadCharGlyph método é 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 IPrintOemUni::DownloadCharGlyph método , 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 GPD da impressora. (Os arquivos GPD são descritos no 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 IPrintOemUni::DownloadCharGlyph 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 "DownloadCharGlyph" como entrada.

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

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)