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 |