Metodo IPrintOemUni::TTDownloadMethod (prcomoem.h)

Articolo
03/05/2024

Il IPrintOemUni::TTDownloadMethod metodo consente a un plug-in di rendering di indicare il formato che Unidrv deve usare per un tipo di carattere soft TrueType specificato.

Sintassi

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

Parametri

pdevobj

Puntatore fornito dal chiamante a una struttura DEVOBJ .

pUFObj

Puntatore fornito dal chiamante a una struttura UNIFONTOBJ .

[out] pdwResult

Riceve uno dei valori costanti forniti dal metodo seguenti:

valore	Definizione
TTDOWNLOAD_BITMAP	Unidrv deve scaricare il tipo di carattere specificato come bitmap.
TTDOWNLOAD_DONTCARE	Unidrv può selezionare il formato del carattere.
TTDOWNLOAD_GRAPHICS	Unidrv deve stampare i tipi di carattere TrueType come grafica, anziché scaricare il tipo di carattere.
TTDOWNLOAD_TTOUTLINE	Unidrv deve scaricare il tipo di carattere specificato come contorni. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Valore restituito

Il metodo deve restituire uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_FAIL	Operazione non riuscita.
E_NOTIMPL	Il metodo non è implementato.

Commenti

Lo IPrintOemUni::TTDownloadMethod scopo del metodo è consentire a un plug-in di rendering di specificare il formato preferito di una stampante per un tipo di carattere soft TrueType specificato.

Se un plug-in per il rendering implementa il IPrintOemUni::TTDownloadMethod metodo , Unidrv chiama il metodo ogni volta che è pronto per inviare un tipo di carattere TrueType allo spooler di stampa. Unidrv specifica il tipo di carattere e il IPrintOemUni::TTDownloadMethod metodo deve specificare il formato preferito della stampante nella posizione a cui punta pdwResult.

Il metodo non deve restituire TTDOWNLOAD_TTOUTLINE a meno che la stampante non possa rasterizzare i tipi di carattere TrueType. Il plug-in di rendering è responsabile della lettura e dell'analisi dei file di carattere TrueType. I puntatori ai file di carattere TrueType possono essere ottenuti chiamando FONTOBJ_pvTrueTypeFontFile.

Il IPrintOemUni::TTDownloadMethod metodo è facoltativo. Se un plug-in per il rendering implementa questo metodo, il metodo IPrintOemUni::GetImplementedMethod del plug-in deve restituire S_OK quando riceve "TTDownLoadMethod" come input.

Per altre informazioni, vedere Personalizzazione della gestione dei tipi di carattere.