METODE IDWriteFactory6::CreateTextFormat (dwrite_3.h)

Membuat objek format teks yang digunakan untuk tata letak teks.

Sintaksis

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

Parameter

fontFamilyName

Jenis: WCHAR const *

Nama keluarga font dari koleksi.

fontCollection

Jenis: IDWriteFontCollection

Koleksi font. Gunakan nullptr untuk menunjukkan kumpulan font sistem.

fontAxisValues

Jenis: DWRITE_FONT_AXIS_VALUE const *

Penunjuk ke array yang berisi daftar nilai sumbu font. Array harus berukuran (jumlah elemen) yang ditunjukkan oleh argumen fontAxisValueCount.

fontAxisValueCount

Jenis: UINT32

Jumlah nilai sumbu font yang terkandung dalam fontAxisValues array.

fontSize

Jenis: FLOAT

Ukuran logis font dalam unit DIP.

localeName

Jenis: WCHAR const *

Nama lokal (misalnya, "ja-JP", "en-US", "ar-EG").

textFormat

Jenis: IDWriteTextFormat3

Alamat penunjuk ke antarmuka IDWriteTextFormat3 . Setelah berhasil diselesaikan, fungsi mengatur penunjuk ke objek format teks yang baru dibuat, jika tidak, fungsi mengatur penunjuk ke nullptr.

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahanHRESULT .

Komentar

Jika fontCollectionnullptr, maka koleksi font sistem digunakan, dikelompokkan menurut nama keluarga tipografis (DWRITE_FONT_FAMILY_MODEL_TYPOGRAPHIC) tanpa font yang dapat diunduh.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 10 Build 16299
server minimum yang didukung	Windows 10 Build 16299
Platform Target	Windows
Header	dwrite_3.h
Pustaka	Dwrite.lib