Metode ITextRange::SetFont (tom.h)

Artikel
03/13/2024

Mengatur atribut karakter rentang ini ke atribut dari objek ITextFont yang ditentukan.

Sintaks

HRESULT SetFont(
  [in] ITextFont *pFont
);

Parameter

[in] pFont

Jenis: ITextFont*

Objek font dengan format karakter yang diinginkan.

Mengembalikan nilai

Jenis: HRESULT

Metode mengembalikan nilai HRESULT . Jika metode berhasil, metode akan mengembalikan S_OK. Jika metode gagal, metode mengembalikan salah satu kode kesalahan berikut. Untuk informasi selengkapnya tentang kode kesalahan COM, lihat Penanganan Kesalahan di COM.

Menampilkan kode	Deskripsi
Nilai	Makna
E_ACCESSDENIED	Teks dilindungi.
E_INVALIDARG	pFont null.
E_OUTOFMEMORY	Kehabisan memori.

Keterangan

Untuk perubahan format sesekali, gunakan metode ITextRange::SetFont . Namun, untuk membuat sejumlah perubahan pemformatan karakter, lebih efisien untuk menggunakan duplikat font. Ini karena setiap kali Anda menjalankan pernyataan seperti range.font.bold = tomTrue, objek font dialokasikan dan dibebaskan. Namun, duplikat font dapat dialokasikan sekali dan digunakan berkali-kali. Selain itu, Anda dapat menyimpan duplikat font, mengatur ulang ke status default atau tidak terdefinisi dengan metode Reset , dan memberinya nilai sesuai kebutuhan untuk pemrosesan teks kaya Anda. Untuk kode sampel yang memperlihatkan cara menggunakan duplikat font, lihat Menggunakan Duplikat Font.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	tom.h
DLL	Msftedit.dll