ComboBox.IsEditable Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur nilai yang mengaktifkan atau menonaktifkan pengeditan teks dalam kotak teks dari ComboBox.
public:
property bool IsEditable { bool get(); void set(bool value); };
public bool IsEditable { get; set; }
member this.IsEditable : bool with get, set
Public Property IsEditable As Boolean
Nilai Properti
true
ComboBox jika dapat diedit; jika tidakfalse. Defaultnya adalah false.
Contoh
Contoh berikut membuat ComboBox kontrol yang berisi gambar sebagai item, bukan teks.
IsEditable Jika properti diatur ke true, TextBox menampilkan nilai yang dikembalikan oleh metode gambarToString. Untuk menghindari TextBox dengan teks yang tidak terduga, gunakan TextSearch.Text properti dan TextSearch.TextPath untuk menetapkan teks yang akan ditampilkan.
<ComboBox IsEditable="true" TextSearch.TextPath="Name">
<Image Name="Cat" Source="data\cat.png"/>
<Image Name="Dog" Source="data\dog.png"/>
<Image Name="Fish" Source="data\fish.png"/>
</ComboBox>
<ComboBox IsEditable="true">
<Image TextSearch.Text="Cat" Source="data\cat.png"/>
<Image TextSearch.Text="Dog" Source="data\dog.png"/>
<Image TextSearch.Text="Fish" Source="data\fish.png"/>
</ComboBox>
Solusi lain adalah menggunakan DisplayMemberPath properti . Kontrol ComboBox drop-down tidak akan menampilkan gambar tetapi akan menampilkan teks yang Anda tetapkan.
Contoh berikut menunjukkan cara menggunakan DisplayMemberPath.
<ComboBox IsEditable="true" DisplayMemberPath="Name">
<Image Name="CAT" Source="data\cat.png"/>
<Image Name="DOG" Source="data\dog.png"/>
<Image Name="FISH" Source="data\fish.png"/>
</ComboBox>
Keterangan
Properti IsEditable dan IsReadOnly menentukan bagaimana ComboBox perilaku saat pengguna melakukan salah satu hal berikut:
- Memasukkan string untuk memilih item di ComboBox.
- Memasukkan string yang tidak sesuai dengan item di ComboBox.
- Memilih bagian dari string yang ada di kotak teks.
- Menyalin atau menempelkan nilai ke dalam kotak teks.
Tabel berikut ini menjelaskan tindakan yang dapat dan tidak dapat diambil pengguna, tergantung pada nilai IsEditable dan IsReadOnly.
| IsEditable nilai |
IsReadOnly adalah true |
IsReadOnly adalah false |
|---|---|---|
true |
- Tidak dapat memilih item dalam ComboBox dengan memasukkan string. - Tidak dapat memasukkan string yang tidak sesuai dengan item di ComboBox. - Dapat memilih bagian dari string dalam kotak ComboBox teks. - Dapat menyalin string di kotak ComboBox teks, tetapi tidak dapat menempelkan string ke dalam kotak ComboBox teks. |
- Dapat memilih item di ComboBox dengan memasukkan string. - Dapat memasukkan string yang tidak sesuai dengan item di ComboBox. - Dapat memilih bagian dari string dalam kotak ComboBox teks. - Dapat menyalin atau menempelkan string di kotak ComboBox teks. |
false |
- Dapat memilih item di ComboBox dengan memasukkan string. - Tidak dapat memasukkan string yang tidak sesuai dengan item di ComboBox. - Tidak dapat memilih bagian dari string di ComboBox. - Tidak dapat menyalin atau menempelkan string di ComboBox. |
- Dapat memilih item di ComboBox dengan memasukkan string. - Tidak dapat memasukkan string yang tidak sesuai dengan item di ComboBox. - Tidak dapat memilih bagian dari string di ComboBox. - Tidak dapat menyalin atau menempelkan string di ComboBox. |
Ketika IsEditable sama dengan false, ComboBox menggunakan ContentPresenter untuk menampilkan item yang saat ini dipilih; ketika IsEditable sama dengan true, digunakan TextBox untuk tujuan ini sebagai gantinya. Perhatikan bahwa hanya TextBox menampilkan teks biasa, dan mungkin ComboBoxItem menyertakan konten teks non-biasa, seperti gambar.
Informasi Properti Dependensi
| Item | Nilai |
|---|---|
| Bidang pengidentifikasi | IsEditableProperty |
Properti metadata diatur ke true |
Tidak |