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

Artigo
02/29/2024

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

Sintaxe

HRESULT TTDownloadMethod(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
  [out] OUT DWORD   *pdwResult
);

Parâmetros

pdevobj

Ponteiro fornecido pelo chamador para uma estrutura DEVOBJ .

pUFObj

Ponteiro fornecido pelo chamador para uma estrutura 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	Unidrv pode selecionar o formato de fonte.
TTDOWNLOAD_GRAPHICS	Unidrv deve imprimir fontes TrueType como gráficos, em vez de baixar a fonte.
TTDOWNLOAD_TTOUTLINE	Unidrv deve baixar a fonte especificada como estruturas de tópicos. Para obter mais informações, consulte a seção Comentários a seguir.

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

A IPrintOemUni::TTDownloadMethod finalidade do método é 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 IPrintOemUni::TTDownloadMethod método , Unidrv chamará o método sempre que estiver pronto para enviar uma fonte TrueType para o spooler de impressão. Unidrv especifica o tipo de fonte e o IPrintOemUni::TTDownloadMethod método 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. Os ponteiros para arquivos de fonte TrueType podem ser obtidos chamando FONTOBJ_pvTrueTypeFontFile.

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

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