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 |