Metodo IPrintCoreHelperUni::SetFontSubstitution (prcomoem.h)

  • Articolo

Il IPrintCoreHelperUni::SetFontSubstitution metodo specifica il tipo di carattere del dispositivo da stampare al posto di un tipo di carattere TrueType specificato.

Sintassi

HRESULT SetFontSubstitution(
  [in] IN PCWSTR pszTrueTypeFontName,
  [in] IN PCWSTR pszDevFontName
);

Parametri

[in] pszTrueTypeFontName

Puntatore a una stringa Unicode con terminazione Null contenente un nome di carattere TrueType valido. Questo parametro non deve essere NULL.

[in] pszDevFontName

Puntatore a una stringa Unicode con terminazione Null contenente il nome del tipo di carattere del dispositivo.

Valore restituito

IPrintCoreHelperUni::SetFontSubstitution 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 qui
 Il driver principale sembra essere in uno stato non valido. Il chiamante deve restituire un codice di errore.

Commenti

L'impostazione di un tipo di carattere del dispositivo da utilizzare al posto di un tipo di carattere TrueType specificato può verificarsi solo durante la sessione delle finestre delle proprietà del dispositivo e solo se è abilitata la sostituzione completa dell'interfaccia utente. Il tipo di carattere rappresentato dal parametro pszTrueTypeFontName deve essere un tipo di carattere TrueType valido e deve essere installato nella stampante. Il tipo di carattere del dispositivo rappresentato dal parametro pszDevFontName deve essere un tipo di carattere valido per la stampante.

Se esiste già un mapping di sostituzione per il tipo di carattere TrueType specificato in questa coda, il SetFontSubstitution metodo sostituirà automaticamente il mapping. Per rimuovere un mapping di sostituzione, chiamare questo metodo con il nome del tipo di carattere TrueType specificato in pszTrueTypeFontName e con NULL specificato in pszDevFontName.

Per ottenere un elenco di tipi di carattere del dispositivo validi, creare un contesto informativo per la stampante corrente e chiamare SetGraphicsMode(hIC, GM_ADVANCED). Enumerare quindi i tipi di carattere del dispositivo chiamando EnumFontFamilies. Il parametro di callback (vedere EnumFontFamProc nella documentazione di Microsoft Windows SDK) di EnumFontFamilies deve filtrare per 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. Le funzioni SetGraphicsMode, EnumFontFamilies e EnumFontFamProc sono descritte nella documentazione di Windows SDK.

Requisiti

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

Vedi anche

IPrintCoreHelperUni

IPrintCoreHelperUni::GetFontSubstitution