Fungsi GetTextFaceA (wingdi.h)

Artikel
08/27/2023

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

Sintaks

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 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.

Mengembalikan nilai

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


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