Interfaccia IDWriteTextFormat (dwrite.h)

L'interfaccia IDWriteTextFormat descrive le proprietà del carattere e del paragrafo usate per formattare il testo e descrive le informazioni sulle impostazioni locali.

Ereditarietà

L'interfaccia IDWriteTextFormat eredita dall'interfaccia IUnknown . IDWriteTextFormat include anche questi tipi di membri:

Metodi

L'interfaccia IDWriteTextFormat include questi metodi.

IDWriteTextFormat::GetFlowDirection Ottiene la direzione di flusso delle righe di testo.
IDWriteTextFormat::GetFontCollection Ottiene la raccolta di caratteri corrente.
IDWriteTextFormat::GetFontFamilyName Ottiene una copia del nome della famiglia di caratteri.
IDWriteTextFormat::GetFontFamilyNameLength Ottiene la lunghezza del nome della famiglia di caratteri.
IDWriteTextFormat::GetFontSize Ottiene le dimensioni del tipo di carattere nelle unite DIP.
IDWriteTextFormat::GetFontStretch Ottiene l'estensione del carattere del testo.
IDWriteTextFormat::GetFontStyle Ottiene lo stile del tipo di carattere del testo.
IDWriteTextFormat::GetFontWeight Ottiene il peso del carattere del testo.
IDWriteTextFormat::GetIncrementalTabStop Ottiene la posizione di arresto della scheda incrementale.
IDWriteTextFormat::GetLineSpacing Ottiene il set di regolazione della spaziatura della riga per un paragrafo di testo multilinea. (IDWriteTextFormat.GetLineSpacing)
IDWriteTextFormat::GetLocaleName Ottiene una copia del nome delle impostazioni locali.
IDWriteTextFormat::GetLocaleNameLength Ottiene la lunghezza del nome delle impostazioni locali.
IDWriteTextFormat::GetParagraphAlignment Ottiene l'opzione di allineamento di un paragrafo relativo ai bordi superiore e inferiore di una casella di layout.
IDWriteTextFormat::GetReadingDirection Ottiene la direzione di lettura corrente per il testo in un paragrafo.
IDWriteTextFormat::GetTextAlignment Ottiene l'opzione di allineamento del testo rispetto al bordo iniziale e finale della casella di layout.
IDWriteTextFormat::GetTrimming Ottiene le opzioni di ritaglio per il testo che esegue il overflow della casella di layout.
IDWriteTextFormat::GetWordWrapping Ottiene l'opzione di wrapping della parola.
IDWriteTextFormat::SetFlowDirection Imposta la direzione del flusso di paragrafo.
IDWriteTextFormat::SetIncrementalTabStop Imposta una distanza fissa tra due tabulazioni adiacenti.
IDWriteTextFormat::SetLineSpacing Imposta la spaziatura della riga.
IDWriteTextFormat::SetParagraphAlignment Imposta l'opzione di allineamento di un paragrafo rispetto al bordo superiore e inferiore della casella di layout.
IDWriteTextFormat::SetReadingDirection Imposta la direzione di lettura del paragrafo.
IDWriteTextFormat::SetTextAlignment Imposta l'allineamento del testo in un paragrafo, rispetto al bordo iniziale e finale di una casella di layout per un'interfaccia IDWriteTextFormat.
IDWriteTextFormat::SetTrimming Imposta le opzioni di ritaglio per l'overflow del testo della larghezza del layout.
IDWriteTextFormat::SetWordWrapping Imposta l'opzione di wrapping delle parole.

Commenti

Per ottenere un riferimento all'interfaccia IDWriteTextFormat , l'applicazione deve chiamare il metodo IDWriteFactory::CreateTextFormat , come illustrato nel codice seguente.

if (SUCCEEDED(hr))
{
    hr = pDWriteFactory_->CreateTextFormat(
        L"Gabriola",
        NULL,
        DWRITE_FONT_WEIGHT_REGULAR,
        DWRITE_FONT_STYLE_NORMAL,
        DWRITE_FONT_STRETCH_NORMAL,
        72.0f,
        L"en-us",
        &pTextFormat_
        );
}

Quando si crea un oggetto IDWriteTextFormat usando la funzione CreateTextFormat , l'applicazione specifica la famiglia di caratteri, la raccolta di caratteri, il peso del carattere, le dimensioni del carattere e il nome delle impostazioni locali per il formato di testo.

Queste proprietà non possono essere modificate dopo la creazione dell'oggetto IDWriteTextFormat . Per modificare queste proprietà, è necessario creare un nuovo oggetto IDWriteTextFormat con le proprietà desiderate.

L'interfaccia IDWriteTextFormat viene usata per disegnare testo con un singolo formato

Per disegnare testo con più formati o per usare un renderer di testo personalizzato, usare l'interfaccia IDWriteTextLayout . IDWriteTextLayout consente all'applicazione di modificare il formato per intervalli di testo all'interno della stringa. IDWriteFactory::CreateTextLayout accetta un oggetto IDWriteTextFormat come parametro e inizialmente applica le informazioni di formato all'intera stringa.

Questo oggetto potrebbe non essere thread-safe e può portare lo stato della modifica del formato di testo.

DirectWrite e Direct2D

Per disegnare testo semplice con un singolo formato, Direct2D fornisce il metodo ID2D1RenderTarget::D rawText, che disegna una stringa usando le informazioni di formato fornite da un oggetto IDWriteTextFormat.

Requisiti

Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	dwrite.h