Fungsi GetGlyphIndicesA (wingdi.h)

Artikel
08/27/2023

Fungsi GetGlyphIndices menerjemahkan string ke dalam array indeks glyph. Fungsi ini dapat digunakan untuk menentukan apakah glyph ada dalam font.

Sintaks

DWORD GetGlyphIndicesA(
  [in]  HDC    hdc,
  [in]  LPCSTR lpstr,
  [in]  int    c,
  [out] LPWORD pgi,
  [in]  DWORD  fl
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] lpstr

Penunjuk ke string yang akan dikonversi.

[in] c

Panjang panjang string yang diacu oleh lpstr dan ukuran (dalam WORD) buffer yang diacu oleh pgi.

[out] pgi

Buffer ini harus dari dimensi c. Saat pengembalian berhasil, berisi array indeks glyph yang sesuai dengan karakter dalam string.

[in] fl

Menentukan bagaimana glyph harus ditangani jika tidak didukung. Parameter ini bisa menjadi nilai berikut.

Nilai	Makna
GGI_MARK_NONEXISTING_GLYPHS	Menandai glyph yang tidak didukung dengan nilai heksadesimal 0xffff.

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan jumlah byte (untuk fungsi ANSI) atau WORD (untuk fungsi Unicode) yang dikonversi.

Jika fungsi gagal, nilai yang dikembalikan adalah GDI_ERROR.

Keterangan

Fungsi ini mencoba mengidentifikasi representasi glyph tunggal untuk setiap karakter dalam string yang ditunjukkan oleh lpstr. Meskipun ini berguna untuk tujuan tingkat rendah tertentu (seperti memanipulasi file font), aplikasi tingkat lebih tinggi yang ingin memetakan string ke glyph biasanya akan ingin menggunakan fungsi Uniscribe .

Catatan

Header wingdi.h mendefinisikan GetGlyphIndices sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor 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


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

Lihat juga

Fungsi Font dan Teks

Font dan Gambaran Umum Teks

GetFontUnicodeRanges