Confronto tra API Di testo Win32

Per gli sviluppatori che eseguono la migrazione del codice dell'applicazione Win32, la tabella seguente elenca le API Di testo Win32 e l'equivalente approssimativo in DirectWrite.

Chiamate di testo GDI	Descrizione	Equivalente DirectWrite
AddFontMemResourceEx	Aggiunge un tipo di carattere incorporato alla tabella dei tipi di carattere di sistema.	CreateCustomFontFileReference + CreateCustomFontCollection
AddFontResource	Aggiunge una risorsa carattere alla tabella dei tipi di carattere di sistema.	Non esiste alcun equivalente. addFontResource aggiunge alla raccolta di tipi di carattere di sistema come parte del passaggio di installazione del tipo di carattere GDI. DirectWrite popola la raccolta di tipi di carattere di sistema in anticipo e monitora automaticamente gli aggiornamenti, quindi non è mai necessaria alcuna installazione.
AddFontResourceEx	Aggiunge un tipo di carattere privato o non enumerabile alla tabella dei tipi di carattere di sistema.	Uguale a quanto sopra
CreateFont	Crea un tipo di carattere logico.	Anziché il tipo di carattere logico, le applicazioni possono specificare un set di proprietà del tipo di carattere (ad esempio nome della famiglia, peso, stile, estensione e dimensioni) per creare un IDWriteTextFormat. Solo le app che richiedono l'enumerazione del tipo di carattere accederanno a un IDWriteFont tramite l'IDWriteFontCollection.
CreateFontIndirect	Crea un tipo di carattere logico da una struttura.	Uguale a quanto sopra
CreateFontIndirectEx	Crea un tipo di carattere logico da una struttura.	Uguale a quanto sopra
DrawText	Disegna testo formattato in un rettangolo.	IDWriteTextLayout::D raw
DrawTextEx	Disegna testo formattato in un rettangolo.	IDWriteTextLayout::D raw
EnumFontFamExProc	Funzione di callback definita dall'applicazione usata con EnumFontFamiliesEx per elaborare i tipi di carattere.	interfaccia IDWriteFontCollection tramite IDWriteFactory::GetSystemFontCollection
EnumFontFamiliesEx	Enumera tutti i tipi di carattere nel sistema con determinate caratteristiche.	interfaccia IDWriteFontCollection tramite IDWriteFactory::GetSystemFontCollection
ExtTextOut	Disegna una stringa di caratteri.	IDWriteTextLayout::D raw o IDWriteRenderBitmapTarget::D rawGlyphRun
GetAspectRatioFilterEx	Ottiene l'impostazione per il filtro proporzioni.	N/D
GetCharABCWidths	Ottiene la larghezza dei caratteri consecutivi dal tipo di carattere TrueType.	IDWriteFontFace::GetDesignGlyphMetrics
GetCharABCWidthsFloat	Ottiene la larghezza dei caratteri consecutivi dal tipo di carattere corrente.	IDWriteFontFace::GetDesignGlyphMetrics
GetCharABCWidthsI	Ottiene la larghezza degli indici glifi consecutivi o una matrice di indici glifi dal tipo di carattere TrueType.	IDWriteFontFace::GetDesignGlyphMetrics
GetCharacterPlacement	Ottiene informazioni su una stringa di caratteri.	IDWriteTextAnalyzer
GetCharWidth32	Ottiene la larghezza dei caratteri consecutivi dal tipo di carattere corrente.	IDWriteFontFace::GetDesignGlyphMetrics o IDWriteTextLayout::GetMetrics
GetCharWidthFloat	Ottiene la larghezza frazionaria di caratteri consecutivi dal tipo di carattere corrente.	IDWriteFontFace::GetDesignGlyphMetrics o IDWriteTextLayout::GetMetrics
GetCharWidthI	Ottiene la larghezza degli indici glifi consecutivi o una matrice di indici glifi dal tipo di carattere corrente.	IDWriteFontFace::GetDesignGlyphMetrics o IDWriteTextLayout::GetMetrics
GetFontData	Ottiene i dati delle metriche per un tipo di carattere TrueType.	IDWriteFontFace::TryGetFontTable
GetFontLanguageInfo	Restituisce informazioni sul tipo di carattere selezionato per un contesto di visualizzazione.	N/D
GetFontUnicodeRanges	Indica quali caratteri Unicode sono supportati da un tipo di carattere.	ciclo di IDWriteFont::HasCharacter
GetGlyphIndices	Converte una stringa in una matrice di indici glifi.	IDWriteFontFace::GetGlyphIndices
GetGlyphOutline	Ottiene la struttura o la bitmap per un carattere nel tipo di carattere TrueType.	Metriche del glifo - IDWriteFontFace::GetDesignGlyphMetrics, informazioni di struttura effettive --IDwriteFontFace::GetGlyphRunOutline, se si vogliono bitmap del glifo, IDWriteRenderBitmapRenderTarget::D rawGlyphRun
GetKerningPairs	Ottiene le coppie di crenatura di caratteri per un tipo di carattere.	Crenatura consentita tramite proprietà tipografiche del layout (DirectWrite esegue la crenatura stessa, quindi non esiste alcun metodo per restituire queste informazioni).
GetOutlineTextMetrics	Ottiene le metriche di testo per i tipi di carattere TrueType.	IDWriteFontFace::GetMetrics
GetRasterizerCaps	Indica se i tipi di carattere TrueType sono installati.	I tipi di carattere TrueType vengono installati in Windows Vista e Windows 7 per impostazione predefinita.
GetTabbedTextExtent	Calcola la larghezza e l'altezza di una stringa di caratteri, incluse le schede.	IDWriteTextLayout::GetMetrics
GetTextAlign	Ottiene l'impostazione di allineamento del testo per un contesto di dispositivo.	IDWriteTextFormat::GetTextAlignment
GetTextCharacterExtra	Ottiene la spaziatura tra caratteri corrente per un contesto di dispositivo.	N/D
GetTextColor	Ottiene il colore del testo per un contesto di dispositivo.	N/D. DirectWrite è indipendente dal rendering e pertanto non conosce il colore. Le applicazioni devono tenerne traccia.
GetTextExtentExPoint	Ottiene il numero di caratteri in una stringa che verrà inserita all'interno di uno spazio.	IDWriteTextLayout::GetMetrics
GetTextExtentExPointI	Ottiene il numero di indici del glifo che verranno inseriti all'interno di uno spazio.	IDWriteTextLayout::GetMetrics
GetTextExtentPoint32	Calcola la larghezza e l'altezza di una stringa di testo.	IDWriteTextLayout::GetMetrics
GetTextExtentPointI	Calcola la larghezza e l'altezza di una matrice di indici glifi.	IDWriteTextLayout::GetMetrics
GetTextFace	Ottiene il nome del tipo di carattere selezionato in un contesto di dispositivo.	IDWriteFont::GetFaceNames (restituisce tutti i nomi)
GetTextMetrics	Riempie un buffer con le metriche per un tipo di carattere.	IDWriteFontFace::GetMetrics
PolyTextOut	Disegna diverse stringhe utilizzando i colori del tipo di carattere e del testo in un contesto di dispositivo.	N/D; creare diversi oggetti di layout
RemoveFontMemResourceEx	Rimuove un tipo di carattere la cui origine è stata incorporata in un documento dalla tabella dei tipi di carattere di sistema.	IUnknown::Release sull'oggetto associato
RemoveFontResource	Rimuove i tipi di carattere in un file dalla tabella dei tipi di carattere di sistema	N/D
RemoveFontResourceEx	Rimuove un tipo di carattere privato o non enumerabile dalla tabella dei tipi di carattere di sistema.	N/D
setMapperFlags	Modifica l'algoritmo utilizzato per eseguire il mapping dei tipi di carattere logici ai tipi di carattere fisici.	N/D
SetTextAlign	Imposta i flag di allineamento del testo per un contesto di dispositivo.	IDWriteTextFormat::SetTextAlignment
SetTextCharacterExtra	Imposta la spaziatura tra caratteri.	N/D
SetTextColor	Imposta il colore del testo per un contesto di dispositivo.	Un'applicazione deve occuparsi di specificare il colore in una delle chiamateDraw.
SetTextJustification	Specifica la quantità di spazio che il sistema deve aggiungere ai caratteri di interruzione in una stringa.	N/D. La giustificazione e la spaziatura dei caratteri non sono supportate in questa versione.
TabbedTextOut	Scrive una stringa di caratteri in una posizione, espandendo le schede in valori specificati.	IDWriteTextLayout::D raw
TextOut	Scrive una stringa di caratteri in una posizione	IDWriteTextLayout::D raw