IDWriteFontSetBuilder2::AddFont method (dwrite_3.h)

Menambahkan font ke set yang sedang dibangun, dengan pemanggil menyediakan informasi yang cukup untuk mencari dan menentukan rentang sumbu, menghindari kebutuhan untuk membuka font yang berpotensi non-lokal.

Sintaksis

HRESULT AddFont(
  IDWriteFontFile              *fontFile,
  UINT32                       fontFaceIndex,
  DWRITE_FONT_SIMULATIONS      fontSimulations,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_AXIS_RANGE const *fontAxisRanges,
  UINT32                       fontAxisRangeCount,
  DWRITE_FONT_PROPERTY const   *properties,
  UINT32                       propertyCount
);

Parameter

fontFile

Jenis: * IDWriteFontFile

Objek referensi file font untuk ditambahkan ke set.

fontFaceIndex

Jenis: UINT32

Indeks berbasis nol dari wajah font dalam koleksi.

fontSimulations

Jenis: DWRITE_FONT_SIMULATIONS

Bendera simulasi wajah font untuk emboldening algoritma dan miring.

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.

fontAxisRanges

Jenis: DWRITE_FONT_AXIS_RANGE const *

Daftar rentang sumbu.

fontAxisRangeCount

Jenis: UINT32

Jumlah rentang sumbu.

properties

Jenis: DWRITE_FONT_PROPERTY const *

Daftar properti yang akan dikaitkan dengan referensi.

propertyCount

Jenis: UINT32

Jumlah properti yang ditentukan.

Mengembalikan nilai

Jenis: HRESULT

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

Komentar

Properti font harus mencakup setidaknya keluarga (tipografi atau berat/gaya/stretch). Jika tidak, font akan dapat diakses di IDWriteFontSet hanya berdasarkan indeks, bukan nama.

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