Kontrol MaskedEdit
Kontrol MaskedEdit adalah kontrol bidang edit yang berisi masker di bidang teks kontrol. Anda dapat mengaitkan kontrol dengan properti nilai string dengan memasukkan nama properti ke dalam kolom Properti Tabel Kontrol.
Anda dapat menggunakan Kontrol MaskedEdit untuk membuat templat untuk entri informasi pengguna seperti nomor telepon atau kode ID Produk. Misalnya, PropertiPIDKEYdapat dimasukkan oleh pengguna melalui Kontrol MaskedEdit yang ditentukan dengan mengatur PropertiPIDTemplateke string seperti berikut:
12345<### -%%%%%%%>@@@@@
String mendefinisikan templat masking untuk entri PIDKEY Properti oleh pengguna. Segmen string yang terlihat diapit oleh sepasang karakter braket (<>).
Tabel berikut mengidentifikasi sintaks masker.
| Watak | Arti |
|---|---|
| < | Ujung kiri segmen templat yang terlihat. Karakter ini dan segala sesuatu di sebelah kirinya tersembunyi di antarmuka pengguna. Seharusnya tidak ada lebih dari satu instans karakter ini dalam templat. |
| > | Ujung kanan segmen templat yang terlihat. Karakter ini dan semuanya di sebelah kanannya disembunyikan di antarmuka pengguna. Karakter ini digantikan oleh tanda hubung selama validasi. Jika ada segmen yang terlihat dimulai dengan <, maka segmen tersebut harus dihentikan dengan >yang cocok. |
| # | Karakter ini bisa berupa digit (angka.) |
| % | Karakter ini bisa menjadi digit alternatif (angka) yang memungkinkan masker mengontrol cara tindakan kustom membedakan bidang. |
| @ | Karakter ini bisa berupa digit acak (angka.) Karakter ini tidak boleh muncul di bagian templat yang terlihat. |
| & | Karakter ini bisa menjadi karakter apa pun. |
| ^ | Karakter ini bisa menjadi karakter alternatif yang memungkinkan masker mengontrol cara tindakan kustom membedakan bidang. |
| ? | Karakter ini bisa menjadi karakter alternatif yang memungkinkan masker mengontrol cara tindakan kustom membedakan bidang. |
| ` | Tanda aksen grave ' (nilai ASCII 96) dapat mewakili karakter alternatif yang memungkinkan masker mengontrol cara tindakan kustom membedakan bidang. |
| _ | Karakter ini adalah karakter garis bawah harfiah. |
| = | Karakter ini adalah terminator bidang. Ini harus mengikuti #, %, ^, atau '. Ini membuat satu posisi input lagi dengan jenis yang sama dengan posisi sebelumnya dan mengakhiri bidang dengan pemisah '-'. |
Karakter lain diperlakukan sebagai konstanta harfiah.
Untuk karakter yang dapat diedit, kontrol membuat jendela edit terpisah dengan satu jendela untuk setiap blok karakter yang berdekatan dengan jenis yang sama.
Atribut Kontrol
Untuk mengubah nilai atribut yang menggunakan peristiwa, berlangganan kontrol ke peristiwa Kontrol di tabel EventMapping dan mencantumkan pengidentifikasi atribut di kolom Atribut. Masukkan pengidentifikasi peristiwa Kontrol di kolom Peristiwa. Anda dapat menggunakan atribut berikut dengan Kontrol MaskedEdit.
| Atribut | Bit Heksadesimal | Deskripsi |
|---|---|---|
| IndirectPropertyName | Ini adalah nama properti tidak langsung yang terkait dengan kontrol. Jika bit atribut tidak langsung diatur, kontrol akan menampilkan atau mengubah nilai properti yang memiliki nama ini. Jika bit atribut tidak langsung diatur, nama ini juga merupakan nilai properti yang tercantum di kolom Properti Tabel Kontrol. | |
| Posisi | Posisi kontrol dalam kotak dialog. Masukkan lebar kontrol, tinggi, dan koordinat sudut kiri kontrol ke kolom Lebar, Tinggi, X, dan Y Tabel Kontrol. Gunakan Unit Alat Penginstal untuk panjang dan jarak. |
|
| PropertyName | Ini adalah nama properti yang terkait dengan kontrol ini. Jika bit atribut tidak langsung tidak diatur, kontrol akan menampilkan atau mengubah nilai properti yang memiliki nama ini. Atribut ini ditentukan dalam kolom Properti Control Table. | |
| PropertyValue | Nilai properti saat ini yang ditampilkan atau diubah oleh kontrol ini. Jika bit atribut tidak langsung tidak diatur, ini adalah nilai PropertyName. Jika bit atribut tidak langsung diatur, ini adalah nilai IndirectPropertyName. Jika atribut berubah, kontrol mencerminkan nilai baru. | |
| Teks | Untuk mengatur font dan gaya font string teks, awali string karakter yang ditampilkan dengan {\style} atau {&style}. Di mana gaya adalah pengidentifikasi yang tercantum di kolom Gaya tabel TextStyle. Jika tidak ada, tetapi propertiDefaultUIFont didefinisikan sebagai gaya teks yang valid, font tersebut digunakan. String yang menentukan templat masking mengikuti awalan ini dan menggunakan sintaks yang dijelaskan sebelumnya dalam topik ini. | |
| Terlihat | 0x00000000 0x00000001 |
Kontrol tersembunyi. Kontrol yang terlihat. Sertakan bit ini dalam kata bit kolom Atribut di Tabel Kontrol untuk membuat kontrol terlihat atau tersembunyi saat dibuat. Anda juga dapat menyembunyikan atau menampilkan kontrol dengan menggunakan Tabel ControlCondition. |
| diaktifkan | 0x00000000 0x00000002 |
Kontrol dalam status dinonaktifkan. Kontrol dalam status diaktifkan. Sertakan bit ini dalam kata bit di kolom Atribut Tabel Kontrol untuk mengaktifkan kontrol pada pembuatan. Anda juga dapat mengaktifkan atau menonaktifkan kontrol dengan menggunakan ControlCondition Table. |
| Sunken | 0x00000000 0x00000004 |
Menampilkan gaya visual default. Menampilkan kontrol dengan tampilan tenggelam, 3-D. Sertakan bit ini dalam kata bit di kolom Atribut Tabel Kontrol. |
| tidak langsung | 0x00000000 0x00000008 |
Kontrol menampilkan atau mengubah nilai properti di kolom Properti Tabel Kontrol. Kontrol menampilkan atau mengubah nilai properti yang memiliki pengidentifikasi yang tercantum di kolom Properti Tabel Kontrol. Menentukan apakah properti yang terkait dengan kontrol ini dirujuk secara tidak langsung. |
Komentar
Kontrol MaskedEdit membuat satu jendela induk dari kelas TOMBOL dengan gaya BS_OWNERDRAW dan WS_EX_CONTROLPARENT. Ini membuat beberapa jendela anak ke jendela ini.
- Untuk bagian teks konstanta, ini membuat jendela STATIK dengan gaya SS_LEFT dan WS_CHILD.
- Untuk bidang yang dapat diedit, ini membuat jendela EDIT dengan gaya WS_CHILD, WS_BORDER, dan WS_TABSTOP.
- Untuk bidang numerik, jendela juga memiliki gaya ES_NUMBER.
Bidang alfanumerik digit alternatif, %, dan alfanumerik alternatif, ^, ?, dan ' memungkinkan tindakan kustom membedakan antara bidang dengan cara yang dapat dikontrol oleh masker, misalnya, ^ dapat digunakan untuk bidang yang harus huruf besar.