Partilhar via


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

O método IPrintOemUni::TTDownloadMethod permite que um plug-in de renderização indique o formato que o Unidrv deve usar para uma fonte reversível TrueType especificada.

Sintaxe

HRESULT TTDownloadMethod(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
  [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.

[out] pdwResult

Recebe um dos seguintes valores constantes fornecidos pelo método:

Valor Definição
TTDOWNLOAD_BITMAP O Unidrv deve baixar a fonte especificada como bitmaps.
TTDOWNLOAD_DONTCARE O Unidrv pode selecionar o formato de fonte.
TTDOWNLOAD_GRAPHICS O Unidrv deve imprimir fontes TrueType como gráficos, em vez de baixar a fonte.
TTDOWNLOAD_TTOUTLINE O Unidrv deve baixar a fonte especificada como estruturas de tópicos. Para obter mais informações, consulte a seção Comentários a seguir.

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

A finalidade do método IPrintOemUni::TTDownloadMethod é permitir que um plug-in de renderização especifique o formato preferencial de uma impressora para uma fonte flexível TrueType especificada.

Se um plug-in de renderização implementar o método IPrintOemUni::TTDownloadMethod, Unidrv chamará o método sempre que estiver pronto para enviar uma fonte TrueType para o spooler de impressão. O Unidrv especifica o tipo de fonte e o método IPrintOemUni::TTDownloadMethod deve especificar o formato preferencial da impressora no local apontado por pdwResult.

O método não deve retornar TTDOWNLOAD_TTOUTLINE a menos que a impressora possa rasterizar fontes TrueType. O plug-in de renderização é responsável por ler e analisar arquivos de fonte TrueType. Ponteiros para arquivos de fonte TrueType podem ser obtidos chamando FONTOBJ_pvTrueTypeFontFile.

O método IPrintOemUni::TTDownloadMethod é 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 "TTDownLoadMethod" 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)

Consulte também

DEVOBJ

FONTOBJ_pvTrueTypeFontFile

IPrintOemUni

IPrintOemUni::GetImplementedMethod

UNIFONTOBJ