Fungsi GetFontData (wingdi.h)

Fungsi GetFontData mengambil data metrik font untuk font TrueType.

Sintaks

DWORD GetFontData(
  [in]  HDC   hdc,
  [in]  DWORD dwTable,
  [in]  DWORD dwOffset,
  [out] PVOID pvBuffer,
  [in]  DWORD cjBuffer
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] dwTable

Nama tabel metrik font tempat data font akan diambil. Parameter ini dapat mengidentifikasi salah satu tabel metrik yang didokumentasikan dalam spesifikasi File Font TrueType yang diterbitkan oleh Microsoft Corporation. Jika parameter ini nol, informasi diambil mulai dari awal file untuk file font TrueType atau dari awal data untuk font yang saat ini dipilih untuk file TrueType Collection. Untuk mengambil data dari awal file untuk file TrueType Collection, tentukan 'ttcf' (0x66637474).

[in] dwOffset

Offset dari awal tabel metrik font ke lokasi di mana fungsi harus mulai mengambil informasi. Jika parameter ini nol, informasi diambil mulai dari awal tabel yang ditentukan oleh parameter dwTable . Jika nilai ini lebih besar dari atau sama dengan ukuran tabel, kesalahan terjadi.

[out] pvBuffer

Penunjuk ke buffer yang menerima informasi font. Jika parameter ini NULL, fungsi mengembalikan ukuran buffer yang diperlukan untuk data font.

[in] cjBuffer

Panjang, dalam byte, dari informasi yang akan diambil. Jika parameter ini nol, GetFontData mengembalikan ukuran data yang ditentukan dalam parameter dwTable .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah jumlah byte yang dikembalikan.

Jika fungsi gagal, nilai yang dikembalikan adalah GDI_ERROR.

Keterangan

Fungsi ini dimaksudkan untuk digunakan untuk mengambil informasi font TrueType langsung dari file font oleh aplikasi manipulasi font. Untuk informasi tentang menyematkan font, lihat Referensi Penyematan Font.

Aplikasi terkadang dapat menggunakan fungsi GetFontData untuk menyimpan font TrueType dengan dokumen. Untuk melakukan ini, aplikasi menentukan apakah font dapat disematkan dengan memeriksa anggota otmfsType dari struktur OUTLINETEXTMETRIC . Jika bit 1 dari otmfsType diatur, penyematan tidak diizinkan untuk font. Jika bit 1 jelas, font dapat disematkan. Jika bit 2 diatur, penyematan bersifat baca-saja. Jika penyematan diizinkan, aplikasi dapat mengambil seluruh file font, menentukan nol untuk parameter dwTable, dwOffset, dan cbData .

Jika aplikasi mencoba menggunakan fungsi ini untuk mengambil informasi untuk font non-TrueType, kesalahan terjadi.

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

Lihat juga

Fungsi Font dan Teks

Font dan Gambaran Umum Teks

GetTextMetrics

KERANGKATEXTMETRIC