Metode IDWriteFontFallback::MapCharacters (dwrite_2.h)

Artikel
02/26/2024

Menentukan font yang sesuai untuk digunakan untuk merender rentang awal teks.

Sintaks

HRESULT MapCharacters(
                 IDWriteTextAnalysisSource *analysisSource,
                 UINT32                    textPosition,
                 UINT32                    textLength,
  [in, optional] IDWriteFontCollection     *baseFontCollection,
  [in, optional] wchar_t const             *baseFamilyName,
                 DWRITE_FONT_WEIGHT        baseWeight,
                 DWRITE_FONT_STYLE         baseStyle,
                 DWRITE_FONT_STRETCH       baseStretch,
  [out]          UINT32                    *mappedLength,
  [out]          IDWriteFont               **mappedFont,
  [out]          FLOAT                     *scale
);

Parameter

analysisSource

Jenis: IDWriteTextAnalysisSource*

Implementasi sumber teks menyimpan teks dan lokal.

textPosition

Jenis: UINT32

Posisi awal untuk dianalisis.

textLength

Jenis: UINT32

Panjang teks yang akan dianalisis.

[in, optional] baseFontCollection

Jenis: IDWriteFontCollection*

Koleksi font default untuk digunakan.

[in, optional] baseFamilyName

Jenis: const wchar_t*

Nama keluarga font dasar. Jika Anda melewati null, tidak ada pencocokan yang akan dilakukan terhadap keluarga.

baseWeight

Jenis: DWRITE_FONT_WEIGHT

Berat yang diinginkan.

baseStyle

Jenis: DWRITE_FONT_STYLE

Gaya yang diinginkan.

baseStretch

Jenis: DWRITE_FONT_STRETCH

Peregangan yang diinginkan.

[out] mappedLength

Jenis: UINT32*

Panjang teks yang dipetakan ke font yang dipetakan. Ini akan selalu kurang dari atau sama dengan panjang teks dan lebih besar dari nol (jika panjang teks bukan nol) sehingga pemanggil maju setidaknya satu karakter.

[out] mappedFont

Jenis: IDWriteFont**

Font yang harus digunakan untuk merender karakter teks mappedLength pertama. Jika mengembalikan NULL, itu berarti tidak ada font yang dapat merender teks, dan mappedLength adalah jumlah karakter yang akan dilewati (dirender dengan glyph yang hilang).

[out] scale

Jenis: FLOAT*

Faktor skala untuk mengalikan ukuran em font yang dikembalikan.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	dwrite_2.h
Pustaka	Dwrite.lib
DLL	Dwrite.dll

Lihat juga

IDWriteFontFallback

Bagikan melalui