Metodo IPrintCoreHelperPS::GetFontSubstitution (prcomoem.h)

  • Articolo

Il metodo IPrintCoreHelperPS::GetFontSubstitution indica quale tipo di carattere del dispositivo, se presente, viene usato come carattere di sostituzione per un carattere TrueType specificato.

Sintassi

HRESULT GetFontSubstitution(
  [in]  IN PCWSTR  pszTrueTypeFontName,
  [out] OUT PCWSTR *ppszDevFontName
);

Parametri

[in] pszTrueTypeFontName

Puntatore a una stringa Unicode con terminazione null contenente il nome di un carattere TrueType.

[out] ppszDevFontName

Puntatore a una variabile che riceve l'indirizzo di una stringa Unicode con terminazione null. Questa stringa contiene il nome del tipo di carattere del dispositivo che verrà usato al posto del carattere TrueType specificato nel parametro pszFontName . Se non esiste un tipo di carattere del dispositivo che può fungere da sostituzione per il tipo di carattere TrueType specificato, questo parametro verrà impostato su NULL.

Valore restituito

IPrintCoreHelperPS::GetFontSubstitution deve restituire uno dei valori seguenti:

Codice restituito Descrizione
S_OK Il metodo legge l'opzione per la funzionalità specificata.
E_FAIL Il tipo di carattere richiesto non esiste o non è un carattere TrueType.
E_INVALIDARG Uno o più argomenti non sono validi.
E_OUTOFMEMORY Il driver di base non è stato in grado di eseguire il servizio della richiesta perché era presente memoria insufficiente.
E_UNEXPECTED o altri codici restituiti non elencati qui Il driver di base sembra essere in uno stato non valido. Il chiamante deve restituire un codice di errore.

Commenti

Se un'applicazione tenta di stampare testo che usa il tipo di carattere TrueType specificato nel parametro pszTrueTypeFontName , tale testo verrà invece stampato nel tipo di carattere del dispositivo specificato nel parametro ppszDevFontName . Il nome del tipo di carattere del dispositivo deve essere quello di un carattere valido e installato.

Un tipo di carattere viene identificato dal nome del viso del carattere, che viene visualizzato nel membro lfFaceName della struttura LOGFONT .

Per ottenere un elenco di tipi di carattere disponibili, creare un contesto informativo per la stampante corrente e chiamare SetGraphicsMode(hIC, GM_ADVANCED). Enumerare quindi i tipi di carattere del dispositivo tramite una chiamata a EnumFontFamilies. Il parametro di callback (vedere EnumFontFamProc) di EnumFontFamilies deve filtrare i tipi di carattere del dispositivo incrementando un contatore per ogni tipo di carattere per cui il risultato AND bit per bit (FontType & TRUETYPE_FONTTYPE) è diverso da zero.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione prcomoem.h (include Prcomoem.h)

Vedi anche

IPrintCoreHelperPS

IPrintCoreHelperPS::SetFontSubstitution