Fungsi GetTextFaceA (wingdi.h)

Artikel
11/20/2024

Fungsi GetTextFace mengambil nama typeface font yang dipilih ke dalam konteks perangkat yang ditentukan.

Sintaksis

int GetTextFaceA(
  [in]  HDC   hdc,
  [in]  int   c,
  [out] LPSTR lpName
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] c

Panjang buffer yang diacu oleh lpFaceName. Untuk fungsi ANSI, ini adalah hitungan BYTE dan untuk fungsi Unicode, ini 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 sementara 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.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian adalah jumlah karakter yang disalin ke buffer.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Komentar

Nama typeface disalin sebagai string karakter null-terminated.

Jika nama lebih panjang dari jumlah karakter yang ditentukan oleh parameter nCount, nama akan dipotong.

Nota

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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	wingdi.h (termasuk Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll