Antarmuka IFont (ocidl.h)

Menyediakan pembungkus di sekitar objek font Windows. Objek font COM mendukung sejumlah properti baca/tulis serta serangkaian metode melalui antarmuka IFont-nya . Ini mendukung set properti yang sama (tetapi bukan metodenya) melalui antarmuka pengiriman IFontDisp, yang berasal dari IDispatch untuk menyediakan akses ke properti font melalui Automation. Sistem ini menyediakan implementasi standar objek font dengan kedua antarmuka.

Objek font juga mendukung antarmuka keluar IPropertyNotifySink sehingga klien dapat menentukan kapan properti font berubah. Karena objek font mendukung setidaknya satu antarmuka keluar, objek tersebut juga mengimplementasikan IConnectionPointContainer dan antarmuka terkait untuk tujuan ini.

Objek font menyediakan properti hFont, yang merupakan handel font Windows yang sesuai dengan atribut lain yang ditentukan untuk font. Objek font menunda mewujudkan objek hFont ini jika memungkinkan, sehingga secara berturut-turut mengatur dua properti pada font tidak akan menyebabkan font perantara direalisasikan. Selain itu, sebagai pengoptimalan, objek font yang diterapkan sistem mempertahankan cache handel font. Dua objek font dalam proses yang sama yang memiliki properti identik akan mengembalikan handel font yang sama. Objek font dapat menghapus handel font dari cache ini sesering mungkin, yang memperkenalkan pertimbangan khusus untuk klien yang menggunakan properti hFont.

Objek font juga mendukung IPersistStream sehingga dapat menyimpan dan memuat dirinya sendiri dari instans IStream. Objek yang menggunakan objek font secara internal biasanya akan menyimpan dan memuat font sebagai bagian dari penanganan persistensi objek sendiri.

Selain itu, objek font mendukung IDataObject, yang dapat merender kumpulan properti yang berisi atribut font, memungkinkan klien untuk menyimpan properti ini sebagai teks.

Warisan

Antarmuka IFont mewarisi dari antarmuka IUnknown . IFont juga memiliki jenis anggota ini:

Metode

Antarmuka IFont memiliki metode ini.

IFont::AddRefHfont Memberi tahu objek font bahwa font yang direalisasikan sebelumnya yang diidentifikasi dengan hFont harus tetap valid sampai ReleaseHfont dipanggil atau objek font itu sendiri dirilis sepenuhnya.
IFont::Clone Membuat objek font duplikat.
IFont::get_Bold Mendapatkan properti Tebal font saat ini.
IFont::get_Charset Mengambil set karakter yang digunakan dalam font.
IFont::get_hFont Mengambil handel ke fonta yang dijelaskan oleh objek font ini.
IFont::get_Italic Mendapatkan properti Miring font saat ini.
IFont::get_Name Mengambil nama keluarga font.
IFont::get_Size Mengambil ukuran titik font.
IFont::get_Strikethrough Mendapatkan properti Coretan font saat ini.
IFont::get_Underline Mendapatkan properti Garis Bawah font saat ini.
IFont::get_Weight Mendapatkan properti Bobot font saat ini.
IFont::IsEqual Membandingkan objek font ini dengan objek lain untuk kesetaraan.
IFont::p ut_Bold Mengatur properti Tebal font.
IFont::p ut_Charset Mengatur set karakter font.
IFont::p ut_Italic Mengatur properti Miring font.
IFont::p ut_Name Menentukan nama baru untuk keluarga font.
IFont::p ut_Size Mengatur ukuran titik font.
IFont::p ut_Strikethrough Mengatur properti Coretan font.
IFont::p ut_Underline Mengatur properti Garis Bawah font.
IFont::p ut_Weight Mengatur properti Bobot font.
IFont::QueryTextMetrics Mengisi struktur yang dialokasikan penelepon dengan informasi tentang font.
IFont::ReleaseHfont Memberi tahu objek font bahwa pemanggil yang sebelumnya mengunci font ini dalam cache dengan IFont::AddRefHfont tidak lagi memerlukan kunci.
IFont::SetHdc Menyediakan konteks perangkat ke font yang menjelaskan mode pemetaan logis.
IFont::SetRatio Mengonversi faktor penskalaan untuk font ini antara unit logis dan unit HIMETRIC.

Keterangan

Setiap properti dalam antarmuka IFont menyertakan metode get_PropertyName jika properti mendukung akses baca dan metode put_PropertyName jika properti mendukung akses tulis. Sebagian besar properti ini mendukung akses baca dan tulis.

Properti	Jenis	Membaca Metode Akses	Menulis Metode Akses	Deskripsi
Nama	BSTR	get_Name	put_Name	Nama wajah font, misalnya Arial.
Ukuran	CY	get_Size	put_Size	Ukuran titik font, yang dinyatakan dalam jenis CY untuk memungkinkan ukuran titik pecahan.
Tebal	BOOL	get_Bold	put_Bold	Menunjukkan apakah font di-boldfaced.
Miring	BOOL	get_Italic	put_Italic	Menunjukkan apakah font miring.
Menggarisbawahi	BOOL	get_Underline	put_Underline	Menunjukkan apakah font digarisbawaahkan.
Coretan	BOOL	get_Strikethrough	put_Strikethrough	Menunjukkan apakah font adalah coretan.
Bobot	pendek	get_Weight	put_Weight	Keberanian font.
Charset	pendek	get_Charset	put_Charset	Set karakter yang digunakan dalam font, seperti ANSI_CHARSET, DEFAULT_CHARSET, atau SYMBOL_CHARSET.
hFont	HFONT	get_hFont		Handel font Windows yang dapat dipilih ke dalam konteks perangkat untuk penyajian.

 

Implementasi OLE

Sistem ini menyediakan implementasi standar objek font dengan antarmuka IFont di atas dukungan font sistem yang mendasar. Objek font dibuat melalui fungsi OleCreateFontIndirect. Objek font mendukung sejumlah properti baca/tulis serta serangkaian metode melalui antarmuka IFont-nya dan mendukung set properti yang sama (tetapi bukan metodenya) melalui antarmuka pengiriman IFontDisp yang berasal dari IDispatch untuk menyediakan akses ke properti font melalui Automation. Implementasi sistem objek font memasok kedua antarmuka.

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	ocidl.h

Lihat juga

IFontDisp