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 dari Tabel Kontrol.

Anda dapat menggunakan Kontrol MaskedEdit untuk membuat templat untuk entri informasi pengguna seperti nomor telepon atau kode ID Produk. Misalnya, Properti PIDKEY dapat dimasukkan oleh pengguna melalui Kontrol MaskedEdit yang ditentukan dengan mengatur Properti PIDTemplate ke string seperti berikut ini:

12345<### -%%%%%%>@@@@@

String menentukan templat masking untuk entri Properti PIDKEY oleh pengguna. Segmen string yang terlihat diapit oleh sepasang karakter tanda kurung (<>).

Tabel berikut mengidentifikasi sintaks masker.

karakter	Makna
<	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 harus dihentikan dengan pencocokan >.
#	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 cantumkan 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 dari 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 dari Tabel Kontrol.
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 Properti DefaultUIFont 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.
Dapat dilihat	0x00000000 0x00000001	Kontrol tersembunyi. Kontrol yang terlihat. Sertakan bit ini dalam kata bit kolom Atribut dalam Tabel Kontrol untuk membuat kontrol terlihat atau tersembunyi saat dibuat. Anda juga dapat menyembunyikan atau memperlihatkan 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 Tabel ControlCondition.
Cekung	0x00000000 0x00000004	Menampilkan gaya visual default. Menampilkan kontrol dengan tampilan tenggelam, 3-D. Sertakan bit ini dalam kata bit di kolom Atribut dari Tabel Kontrol.
Langsung	0x00000000 0x00000008	Kontrol menampilkan atau mengubah nilai properti di kolom Properti dari Tabel Kontrol. Kontrol menampilkan atau mengubah nilai properti yang memiliki pengidentifikasi yang tercantum di kolom Properti dari Tabel Kontrol. Menentukan apakah properti yang terkait dengan kontrol ini dirujuk secara tidak langsung.

 

Keterangan

Kontrol MaskedEdit membuat satu jendela induk kelas BUTTON dengan gaya BS_OWNERDRAW dan WS_EX_CONTROLPARENT . Ini membuat beberapa jendela anak ke jendela ini.

• Untuk bagian teks konstan, 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 .

Digit alternatif, %, dan karakter alfanumerik alternatif, bidang ^, ?, dan ' memungkinkan tindakan kustom membedakan antara bidang dengan cara yang dapat dikontrol oleh masker, misalnya, ^ dapat digunakan untuk bidang yang harus huruf besar.