Fungsi CreateFontIndirectA (wingdi.h)

Artikel
03/08/2023

Fungsi CreateFontIndirect membuat font logis yang memiliki karakteristik yang ditentukan. Font kemudian dapat dipilih sebagai font saat ini untuk konteks perangkat apa pun.

Sintaks

HFONT CreateFontIndirectA(
  [in] const LOGFONTA *lplf
);

Parameter

[in] lplf

Penunjuk ke struktur LOGFONT yang menentukan karakteristik font logis.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke font logis.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Keterangan

Fungsi CreateFontIndirect membuat font logis dengan karakteristik yang ditentukan dalam struktur LOGFONT . Ketika font ini dipilih dengan menggunakan fungsi SelectObject , pemeta font GDI mencoba mencocokkan font logis dengan font fisik yang ada. Jika gagal menemukan kecocokan yang tepat, ia memberikan alternatif yang karakteristiknya cocok dengan karakteristik sebanyak mungkin yang diminta.

Untuk mendapatkan font yang sesuai pada versi bahasa OS yang berbeda, panggil EnumFontFamiliesEx dengan karakteristik font yang diinginkan dalam struktur LOGFONT , ambil nama typeface yang sesuai, dan buat font menggunakan CreateFont atau CreateFontIndirect.

Saat Anda tidak lagi memerlukan font, panggil fungsi DeleteObject untuk menghapusnya.

Font untuk banyak bahasa Asia Timur memiliki dua nama typeface: nama bahasa Inggris dan nama yang dilokalkan. CreateFont dan CreateFontIndirect mengambil nama typeface yang dilokalkan hanya pada lokal sistem yang cocok dengan bahasa, sementara mereka mengambil nama typeface bahasa Inggris pada semua lokal sistem lainnya. Metode terbaik adalah mencoba satu nama dan, pada kegagalan, coba yang lain. Perhatikan bahwa EnumFonts, EnumFontFamilies, dan EnumFontFamiliesEx mengembalikan nama typeface bahasa Inggris jika lokal sistem tidak cocok dengan bahasa font.

Pemeta font untuk CreateFont, CreateFontIndirect, dan CreateFontIndirectEx mengenali bahasa Inggris dan nama typeface yang dilokalkan, terlepas dari lokalnya.

Contoh

Misalnya, lihat Membuat Font Logis.

Catatan

Header wingdi.h mendefinisikan CreateFontIndirect sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll