Metodo IDWriteFactory6::CreateTextFormat (dwrite_3.h)

Articolo
11/20/2024

Crea un oggetto formato testo utilizzato per il layout di testo.

Sintassi

HRESULT CreateTextFormat(
  WCHAR const                  *fontFamilyName,
  IDWriteFontCollection        *fontCollection,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  FLOAT                        fontSize,
  WCHAR const                  *localeName,
  IDWriteTextFormat3           **textFormat
);

Parametri

fontFamilyName

Tipo: WCHAR const *

Nome della famiglia di caratteri della raccolta.

fontCollection

Tipo: IDWriteFontCollection*

Raccolta di tipi di carattere. Utilizzare nullptr per indicare la raccolta di tipi di carattere di sistema.

fontAxisValues

Tipo: DWRITE_FONT_AXIS_VALUE const *

Puntatore a una matrice contenente un elenco di valori dell'asse dei caratteri. La matrice deve essere la dimensione (il numero di elementi) indicato dall'argomento fontAxisValueCount .

fontAxisValueCount

Tipo: UINT32

Numero di valori dell'asse dei caratteri contenuti nella matrice fontAxisValues.

fontSize

Tipo: FLOAT

Dimensioni logiche del tipo di carattere in unità DIP.

localeName

Tipo: WCHAR const *

Nome delle impostazioni locali (ad esempio, "ja-JP", "en-US", "ar-EG").

textFormat

Tipo: IDWriteTextFormat3**

Indirizzo di un puntatore a un'interfaccia IDWriteTextFormat3. Al termine, la funzione imposta il puntatore su un oggetto formato testo appena creato. In caso contrario, imposta il puntatore su nullptr.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di erroreHRESULT .

Osservazioni

Se fontCollection è nullptr, viene utilizzata la raccolta di tipi di carattere di sistema, raggruppati in base al nome della famiglia tipografica (DWRITE_FONT_FAMILY_MODEL_TYPOGRAPHIC) senza tipi di carattere scaricabili.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10 Build 16299
server minimo supportato	Windows 10 Build 16299
piattaforma di destinazione	Finestre
intestazione	dwrite_3.h
libreria	Dwrite.lib

Condividi tramite