Antarmuka IDWriteTextFormat (dwrite.h)

Artikel
08/23/2023

Antarmuka IDWriteTextFormat menjelaskan properti font dan paragraf yang digunakan untuk memformat teks, dan menjelaskan informasi lokal.

Warisan

Antarmuka IDWriteTextFormat mewarisi dari antarmuka IUnknown . IDWriteTextFormat juga memiliki jenis anggota berikut:

Metode

Antarmuka IDWriteTextFormat memiliki metode ini.


IDWriteTextFormat::GetFlowDirection Mendapatkan arah alur baris teks.
IDWriteTextFormat::GetFontCollection Mendapatkan koleksi font saat ini.
IDWriteTextFormat::GetFontFamilyName Mendapatkan salinan nama keluarga font.
IDWriteTextFormat::GetFontFamilyNameLength Mendapatkan panjang nama keluarga font.
IDWriteTextFormat::GetFontSize Mendapatkan ukuran font dalam satuan DIP.
IDWriteTextFormat::GetFontStretch Mendapatkan peregangan font teks.
IDWriteTextFormat::GetFontStyle Mendapatkan gaya font teks.
IDWriteTextFormat::GetFontWeight Mendapatkan bobot font teks.
IDWriteTextFormat::GetIncrementalTabStop Mendapatkan posisi pemberhentian tab inkremental.
IDWriteTextFormat::GetLineSpacing Mendapatkan set penyesuaian penspasian baris untuk paragraf teks multibaris. (IDWriteTextFormat.GetLineSpacing)
IDWriteTextFormat::GetLocaleName Mendapatkan salinan nama lokal.
IDWriteTextFormat::GetLocaleNameLength Mendapatkan panjang nama lokal.
IDWriteTextFormat::GetParagraphAlignment Mendapatkan opsi perataan paragraf yang relatif terhadap tepi atas dan bawah kotak tata letak.
IDWriteTextFormat::GetReadingDirection Mendapatkan arah bacaan saat ini untuk teks dalam paragraf.
IDWriteTextFormat::GetTextAlignment Mendapatkan opsi perataan teks relatif terhadap tepi awal dan akhir kotak tata letak.
IDWriteTextFormat::GetTrimming Mendapatkan opsi pemangkasan untuk teks yang melebihi kotak tata letak.
IDWriteTextFormat::GetWordWrapping Mendapatkan opsi pembungkusan kata.
IDWriteTextFormat::SetFlowDirection Mengatur arah alur paragraf.
IDWriteTextFormat::SetIncrementalTabStop Mengatur jarak tetap antara dua pemberhentian tab yang berdekatan.
IDWriteTextFormat::SetLineSpacing Mengatur penspasian baris.
IDWriteTextFormat::SetParagraphAlignment Mengatur opsi perataan paragraf yang relatif terhadap tepi atas dan bawah kotak tata letak.
IDWriteTextFormat::SetReadingDirection Mengatur arah pembacaan paragraf.
IDWriteTextFormat::SetTextAlignment Mengatur perataan teks dalam paragraf, relatif terhadap tepi awal dan akhir kotak tata letak untuk antarmuka IDWriteTextFormat.
IDWriteTextFormat::SetTrimming Mengatur opsi pemangkasan untuk teks yang meluapkan lebar tata letak.
IDWriteTextFormat::SetWordWrapping Mengatur opsi pembungkusan kata.

Keterangan

Untuk mendapatkan referensi ke antarmuka IDWriteTextFormat , aplikasi harus memanggil metode IDWriteFactory::CreateTextFormat seperti yang ditunjukkan dalam kode berikut.


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_
        );
}

Saat membuat objek IDWriteTextFormat menggunakan fungsi CreateTextFormat , aplikasi menentukan keluarga font, koleksi font, bobot font, ukuran font, dan nama lokal untuk format teks.

Properti ini tidak dapat diubah setelah objek IDWriteTextFormat dibuat. Untuk mengubah properti ini, objek IDWriteTextFormat baru harus dibuat dengan properti yang diinginkan.

Antarmuka IDWriteTextFormat digunakan untuk menggambar teks dengan format tunggal

Untuk menggambar teks dengan beberapa format, atau untuk menggunakan perender teks kustom, gunakan antarmuka IDWriteTextLayout . IDWriteTextLayout memungkinkan aplikasi mengubah format untuk rentang teks dalam string. IDWriteFactory::CreateTextLayout mengambil objek IDWriteTextFormat sebagai parameter dan awalnya menerapkan informasi format ke seluruh string.

Objek ini mungkin tidak aman untuk utas, dan mungkin membawa status perubahan format teks.

DirectWrite dan Direct2D

Untuk menggambar teks sederhana dengan satu format, Direct2D menyediakan metode ID2D1RenderTarget::D rawText , yang menggambar string menggunakan informasi format yang disediakan oleh objek IDWriteTextFormat .

Persyaratan


Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	dwrite.h

Bagikan melalui