Metodo IPrintCoreHelper::GetFontSubstitution (prcomoem.h)

Il metodo IPrintCoreHelper::GetFontSubstitution indica il tipo di carattere del dispositivo, se presente, viene usato come tipo di carattere di sostituzione per un tipo di 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 tipo di 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à utilizzato al posto del tipo di carattere TrueType specificato nel parametro pszFontName . Se non è presente alcun tipo di carattere del dispositivo che può fungere da sostituto del tipo di carattere TrueType specificato, questo parametro viene impostato su NULL.

Valore restituito

IPrintCoreHelper::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 tipo di carattere TrueType.
E_INVALIDARG	Uno o più argomenti non sono validi.
E_OUTOFMEMORY	Il driver principale non è riuscito a gestire la richiesta perché la memoria non è sufficiente.
E_UNEXPECTED o altri codici restituiti non elencati altrove in questa tabella	Il driver principale sembra essere in uno stato non valido. Il chiamante deve restituire un codice di errore.

Commenti

Se un'applicazione tenta di stampare testo che utilizza 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 tipo di carattere valido installato.

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

Per ottenere un elenco dei 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 il quale 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

IPrintCoreHelper

IPrintCoreHelper::SetFontSubstitution