Fungsi GetTextFaceW (wingdi.h)
Fungsi GetTextFace mengambil nama typeface font yang dipilih ke dalam konteks perangkat yang ditentukan.
Sintaks
int GetTextFaceW(
[in] HDC hdc,
[in] int c,
[out] LPWSTR lpName
);
Parameter
[in] hdc
Handel ke konteks perangkat.
[in] c
Panjang buffer yang diacu oleh lpFaceName. Untuk fungsi ANSI itu adalah jumlah BYTE dan untuk fungsi Unicode itu adalah hitungan WORD. Perhatikan bahwa untuk fungsi ANSI, karakter di halaman kode SBCS masing-masing mengambil satu byte, sementara sebagian besar karakter di halaman kode DBCS mengambil dua byte; untuk fungsi Unicode, karakter Unicode yang saat ini ditentukan (yang ada di Basic Multilingual Plane (BMP)) adalah satu WORD sedangkan pengganti Unicode adalah dua WORD.
[out] lpName
Penunjuk ke buffer yang menerima nama typeface. Jika parameter ini NULL, fungsi mengembalikan jumlah karakter dalam nama, termasuk karakter null yang mengakhiri.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah jumlah karakter yang disalin ke buffer.
Jika fungsi gagal, nilai yang dikembalikan adalah nol.
Keterangan
Nama typeface disalin sebagai string karakter yang dihentikan null.
Jika nama lebih panjang dari jumlah karakter yang ditentukan oleh parameter nCount , nama akan dipotong.
Catatan
Header wingdi.h mendefinisikan GetTextFace 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 |