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

Lihat juga

IDWriteTextLayout