Gaya Kontrol Statis
Untuk membuat kontrol statis menggunakan fungsi CreateWindow atau CreateWindowEx, tentukan kelas STATIC, konstanta gaya jendela yang sesuai, dan kombinasi gaya kontrol statis berikut.
| Terus-menerus | Deskripsi |
|---|---|
|
Bitmap akan ditampilkan dalam kontrol statis. Teks adalah nama bitmap (bukan nama file) yang ditentukan di tempat lain dalam file sumber daya. Gaya mengabaikan parameter nWidth dan nHeight ; kontrol secara otomatis mengukur dirinya sendiri untuk mengakomodasi bitmap. |
|
Kotak dengan bingkai yang digambar dalam warna yang sama dengan bingkai jendela. Warna ini hitam dalam skema warna default. |
|
Persegi panjang yang diisi dengan warna bingkai jendela saat ini. Warna ini hitam dalam skema warna default. |
|
Persegi panjang sederhana dan tengahkan teks dalam persegi panjang. Teks diformat sebelum ditampilkan. Kata-kata yang melewati akhir baris secara otomatis dibungkus ke awal baris berpusat berikutnya. Kata-kata yang lebih panjang dari lebar kontrol dipotong. |
|
Bitmap berpusat di kontrol statis yang berisinya. Kontrol tidak diubah ukurannya, sehingga bitmap terlalu besar untuk kontrol akan dipotong. Jika kontrol statis berisi satu baris teks, teks dipusatkan secara vertikal di area klien kontrol. |
|
Kontrol statis menduplikasi karakteristik tampilan teks dari kontrol edit multibaris. Secara khusus, lebar karakter rata-rata dihitung dengan cara yang sama seperti dengan kontrol edit, dan fungsi tidak menampilkan baris terakhir yang terlihat sebagian. |
|
Jika akhir string tidak pas di persegi panjang, string dipotong dan elipsis ditambahkan. Jika kata yang tidak berada di akhir string melampaui batas persegi panjang, kata tersebut dipotong tanpa elipsis. Menggunakan gaya ini akan memaksa teks kontrol berada di satu baris tanpa pembungkus kata. Bandingkan dengan SS_PATHELLIPSIS dan SS_WORDELLIPSIS. |
|
Metafile yang ditingkatkan akan ditampilkan dalam kontrol statis. Teks adalah nama metafile. Kontrol statis metafile yang ditingkatkan memiliki ukuran tetap; metafile diskalakan agar sesuai dengan area klien kontrol statis. |
|
Menggambar bingkai kontrol statis menggunakan gaya tepi EDGE_ETCHED . Untuk informasi selengkapnya, lihat fungsi DrawEdge. |
|
Menggambar tepi atas dan bawah kontrol statis menggunakan gaya tepi EDGE_ETCHED . Untuk informasi selengkapnya, lihat fungsi DrawEdge. |
|
Menggambar tepi kiri dan kanan kontrol statis menggunakan gaya tepi EDGE_ETCHED . Untuk informasi selengkapnya, lihat fungsi DrawEdge. |
|
Kotak dengan bingkai yang digambar dengan warna yang sama dengan latar belakang layar (desktop). Warna ini berwarna abu-abu dalam skema warna default. |
|
Persegi panjang yang diisi dengan warna latar belakang layar saat ini. Warna ini berwarna abu-abu dalam skema warna default. |
|
Ikon yang akan ditampilkan dalam kotak dialog. Jika kontrol dibuat sebagai bagian dari kotak dialog, teks adalah nama ikon (bukan nama file) yang ditentukan di tempat lain dalam file sumber daya. Jika kontrol dibuat melalui CreateWindow atau fungsi terkait, teks adalah nama ikon (bukan nama file) yang ditentukan dalam file sumber daya yang terkait dengan modul yang ditentukan oleh parameter hInstance ke CreateWindow. Ikon dapat berupa kursor animasi. Gaya mengabaikan parameter CreateWindow nWidth dan nHeight; kontrol secara otomatis mengukur dirinya sendiri untuk mengakomodasi ikon. Karena menggunakan fungsi LoadIcon, gaya SS_ICON hanya dapat memuat ikon dimensi SM_CXICON dan SM_CYICON. Pembatasan ini dapat dilewati dengan menggunakan gaya SS_REALSIZEIMAGE selain SS_ICON. Jika ikon tidak dapat dimuat melalui LoadIcon, upaya dilakukan untuk memuat sumber daya yang ditentukan sebagai kursor menggunakan LoadCursor. Jika itu juga gagal, upaya dilakukan untuk memuat dari driver perangkat menggunakan LoadImage. |
|
Persegi panjang sederhana dan rata kiri teks dalam persegi panjang. Teks diformat sebelum ditampilkan. Kata-kata yang melewati akhir baris secara otomatis dibungkus ke awal baris rata kiri berikutnya. Kata-kata yang lebih panjang dari lebar kontrol dipotong. |
|
Persegi panjang sederhana dan rata kiri teks dalam persegi panjang. Tab diperluas, tetapi kata-kata tidak dibungkus. Teks yang meluas melewati akhir baris diklip. |
|
Mencegah interpretasi karakter ampersand (&) apa pun dalam teks kontrol sebagai karakter awalan akselerator. Ini ditampilkan dengan ampersand dihapus dan karakter berikutnya dalam string yang digaris bawahi. Gaya kontrol statis ini dapat disertakan dengan salah satu kontrol statis yang ditentukan. Anda dapat menggabungkan SS_NOPREFIX dengan gaya lain. Ini dapat berguna ketika nama file atau string lain yang mungkin berisi ampersand (&) harus ditampilkan dalam kontrol statis dalam kotak dialog. |
|
Mengirim kode pemberitahuan STN_CLICKED, STN_DBLCLK, STN_DISABLE, dan STN_ENABLE jendela induk saat pengguna mengklik atau mengklik dua kali kontrol. |
|
Pemilik kontrol statis bertanggung jawab untuk menggambar kontrol. Jendela pemilik menerima pesan WM_DRAWITEM setiap kali kontrol perlu digambar. |
|
Mengganti karakter di tengah string dengan elipsis sehingga hasilnya pas dalam persegi panjang yang ditentukan. Jika string berisi karakter garis miring terbalik (\), SS_PATHELLIPSIS mempertahankan sebanyak mungkin teks setelah garis miring terbalik terakhir. Menggunakan gaya ini akan memaksa teks kontrol berada di satu baris tanpa pembungkus kata. Bandingkan dengan SS_ENDELLIPSIS dan SS_WORDELLIPSIS. |
|
Menyesuaikan bitmap agar sesuai dengan ukuran kontrol statis. Misalnya, mengubah lokal dapat mengubah font sistem, dan dengan demikian kontrol mungkin diubah ukurannya. Jika kontrol statis memiliki bitmap, bitmap tidak akan lagi sesuai dengan kontrol. Gaya ini sedikit menentukan redimensioning otomatis bitmap agar sesuai dengan kontrol mereka. Jika SS_CENTERIMAGE ditentukan, bitmap atau ikon dipusatkan (dan diklip jika diperlukan). Jika SS_CENTERIMAGE tidak ditentukan, bitmap atau ikon direntangkan atau menyusut. Perhatikan bahwa redimensioning dalam dua sumbu bersifat independen, dan hasilnya mungkin memiliki rasio aspek yang berubah. Bandingkan dengan SS_REALSIZEIMAGE. |
|
Menentukan bahwa lebar sumber daya aktual digunakan dan ikon dimuat menggunakan LoadImage. SS_REALSIZEIMAGE selalu digunakan bersama dengan SS_ICON. SS_REALSIZEIMAGE menggunakan LoadImage, mengambil alih proses yang biasanya diikuti di bawah SS_ICON. Ini tidak memuat kursor; jika LoadImage gagal, tidak ada upaya lebih lanjut untuk memuat yang dilakukan. Ini menggunakan lebar sumber daya aktual. Kontrol statis diubah ukurannya sesuai, tetapi ikon tetap selaras dengan tepi kiri dan atas kontrol yang awalnya ditentukan. Perhatikan bahwa jika SS_CENTERIMAGE juga ditentukan, ikon berpusat di dalam ruang kontrol, yang ditentukan menggunakan parameter CreateWindow nWidth dan nHeight. Bandingkan dengan SS_REALSIZECONTROL. |
|
Persegi panjang sederhana dan rata kanan teks dalam persegi panjang. Teks diformat sebelum ditampilkan. Kata-kata yang melewati akhir baris secara otomatis dibungkus ke awal baris rata kanan berikutnya. Kata-kata yang lebih panjang dari lebar kontrol dipotong. |
|
Sudut kanan bawah kontrol statis dengan gaya SS_BITMAP atau SS_ICON adalah tetap diperbaiki saat kontrol diubah ukurannya. Hanya sisi atas dan kiri yang disesuaikan untuk mengakomodasi bitmap atau ikon baru. |
|
Persegi panjang sederhana dan menampilkan satu baris teks rata kiri dalam persegi panjang. Baris teks tidak dapat disingkat atau diubah dengan cara apa pun. Selain itu, jika kontrol dinonaktifkan, kontrol tidak berwarna abu-abu pada teksnya. |
|
Menggambar batas setengah tenggelam di sekitar kontrol statis. |
|
Bit gaya komposit yang dihasilkan dari penggunaan operator OR pada bit gaya SS_*. Dapat digunakan untuk menutupi bit SS_* yang valid dari bitmask tertentu. Perhatikan bahwa ini sudah kedaluarsa dan tidak menyertakan semua gaya yang valid dengan benar. Dengan demikian, Anda tidak boleh menggunakan gaya ini. |
|
Kotak dengan bingkai yang digambar dengan warna yang sama dengan latar belakang jendela. Warna ini berwarna putih dalam skema warna default. |
|
Persegi panjang yang diisi dengan warna latar belakang jendela saat ini. Warna ini berwarna putih dalam skema warna default. |
|
Memotong kata apa pun yang tidak pas di persegi panjang dan menambahkan elipsis. Menggunakan gaya ini akan memaksa teks kontrol berada di satu baris tanpa pembungkus kata. Bandingkan dengan SS_ENDELLIPSIS dan SS_PATHELLIPSIS. |
Keterangan
Untuk menggunakan gaya yang memotong kata atau string dengan elipsis untuk teks multibaris, DrawThemeText atau DrawText dapat digunakan pada kontrol gambar pemilik dengan bendera pemformatan DT_WORDBREAK dan set DT_ENDELLIPSIS.
Persyaratan
| Persyaratan | Value |
|---|---|
| Klien minimum yang didukung |
Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows Server 2003 [hanya aplikasi desktop] |
| Header |
|
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk