METODE IDWriteTextLayout::SetFontWeight (dwrite.h)
Mengatur bobot font untuk teks dalam rentang teks yang ditentukan oleh struktur DWRITE_TEXT_RANGE .
Sintaks
HRESULT SetFontWeight(
DWRITE_FONT_WEIGHT fontWeight,
DWRITE_TEXT_RANGE textRange
);
Parameter
fontWeight
Jenis: DWRITE_FONT_WEIGHT
Bobot font yang akan diatur untuk teks dalam rentang yang ditentukan oleh textRange.
textRange
Jenis: DWRITE_TEXT_RANGE
Rentang teks tempat perubahan ini berlaku.
Mengembalikan nilai
Jenis: HRESULT
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Bobot font dapat diatur ke salah satu nilai bobot font yang telah ditentukan sebelumnya yang disediakan dalam enumerasi DWRITE_FONT_WEIGHT atau bilangan bulat dari 1 hingga 999. Nilai di luar rentang ini akan menyebabkan metode gagal dengan nilai pengembalian E_INVALIDARG .
Ilustrasi berikut menunjukkan contoh bobot Normal dan UltraBold untuk typeface Palatino Linotype.
Contoh
Kode berikut menggambarkan cara mengatur bobot font menjadi tebal.
// Set the font weight to bold for the entire string.
DWRITE_TEXT_RANGE textRange = {0, cTextLength_};
if (SUCCEEDED(hr))
{
hr = pTextLayout_->SetFontWeight(DWRITE_FONT_WEIGHT_BOLD, textRange);
}
Persyaratan
Persyaratan | Nilai |
---|---|
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 |
Pustaka | Dwrite.lib |
DLL | Dwrite.dll |