Fungsi DrawStatusTextA (commctrl.h)

2024-11-18

Fungsi DrawStatusText menggambar teks yang ditentukan dalam gaya jendela status dengan batas.

Sintaksis

void DrawStatusTextA(
  HDC     hDC,
  LPCRECT lprc,
  LPCSTR  pszText,
  UINT    uFlags
);

Parameter

hDC

Jenis: HDC

Tangani ke konteks tampilan untuk jendela.

lprc

Jenis: LPCRECT

Penunjuk ke struktur RECT yang berisi posisi, dalam koordinat klien, dari persegi panjang tempat teks digambar. Fungsi ini menggambar batas tepat di dalam tepi persegi panjang yang ditentukan.

pszText

Jenis: LPCTSTR

Penunjuk ke string null-terminated yang menentukan teks yang akan ditampilkan. Karakter tab dalam string menentukan apakah string rata kiri, rata kanan, atau di tengah.

uFlags

Jenis: UINT

Bendera gambar teks. Parameter ini bisa menjadi kombinasi dari nilai-nilai ini:

Nilai	Arti
SBT_NOBORDERS	Mencegah batas digambar di sekitar teks yang ditentukan.
SBT_POPOUT	Gambar batas yang disorot yang membuat teks menonjol.
SBT_RTLREADING	Menunjukkan bahwa string yang ditunjukkan oleh pszText akan ditampilkan ke arah yang berlawanan dengan teks di jendela induk.

Mengembalikan nilai

Tidak

Komentar

Jendela normal menampilkan teks kiri-ke-kanan (LTR). Windows dapat dicerminkan untuk menampilkan bahasa seperti Ibrani atau Arab yang membaca kanan-ke-kiri (RTL). Biasanya, string pszText akan ditampilkan ke arah yang sama dengan teks di jendela induknya. Jika SBT_RTLREADING diatur, string pszText akan dibaca ke arah yang berlawanan dari teks di jendela induk.

Nota

Header commctrl.h mendefinisikan DrawStatusText 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 Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	commctrl.h
Pustaka	Comctl32.lib
DLL	Comctl32.dll

Bagikan melalui