Kotak Teks

Kelas TextBox memungkinkan Anda menampilkan atau mengedit teks yang tidak diformat. Penggunaan umum dari adalah TextBox mengedit teks yang tidak diformat dalam formulir. Misalnya, formulir yang meminta nama pengguna, nomor telepon, dan informasi lainnya akan menggunakan TextBox kontrol untuk input teks.

Cuplikan layar empat kontrol TextBox yang menunjukkan status yang berbeda.

Tabel berikut ini mencantumkan tugas umum untuk bekerja dengan kontrol TextBox:

Judul Description
Membuat Kontrol Kotak Teks Multibaris Pelajari cara membuat TextBox yang menerima beberapa baris teks.
Deteksi Saat Teks di Kotak Teks Telah Berubah Pelajari cara merespons saat teks berubah di Kotak Teks.
Aktifkan Karakter Tab dalam Kontrol Kotak Teks Pelajari cara memperbolehkan karakter tab di Kotak Teks.
Mendapatkan Kumpulan Baris dari Kotak Teks Pelajari cara mengambil baris teks dari TextBox.
Membuat Kontrol Kotak Teks Hanya-Baca Pelajari cara mencegah pengeditan di Kotak Teks.
Posisikan Kursor di Awal atau Akhir Teks dalam Kontrol Kotak Teks Pelajari cara mengatur posisi kursor di Kotak Teks.
Mengambil Pilihan Teks Pelajari cara mendapatkan teks yang dipilih dari Kotak Teks.
Mengatur Fokus dalam Kontrol Kotak Teks Pelajari cara memberikan fokus ke Kotak Teks.
Mengatur Konten Teks pada Kontrol TextBox Pelajari cara mengatur teks awal di Kotak Teks.
Mengaktifkan Pemeriksaan Ejaan dalam Kontrol Pengeditan Teks Pelajari cara mengaktifkan pemeriksaan ejaan di Kotak Teks.
Menggunakan Menu Konteks Kustom dengan Kotak Teks Pelajari cara membuat menu konteks kustom untuk TextBox.
Menggunakan Pemeriksaan Ejaan dengan Menu Konteks Pelajari cara mengintegrasikan pemeriksaan ejaan dengan menu konteks.
Menambahkan Tanda Air ke Kotak Teks Pelajari cara menampilkan teks sementara di Kotak Teks.

Kotak Teks atau RichTextBox?

Keduanya TextBox dan RichTextBox memungkinkan pengguna untuk memasukkan teks, tetapi kedua kontrol digunakan untuk skenario yang berbeda. TextBox Membutuhkan lebih sedikit sumber daya sistem daripada RichTextBox, sehingga ideal ketika hanya teks biasa yang perlu diedit (yaitu, penggunaan dalam formulir). RichTextBox adalah pilihan yang lebih baik ketika pengguna perlu mengedit teks, gambar, tabel, atau konten lain yang didukung yang diformat. Misalnya, mengedit dokumen, artikel, atau blog yang memerlukan pemformatan, gambar, dan konten lainnya paling baik dicapai menggunakan RichTextBox. Tabel berikut ini meringkas fitur TextBox utama dan RichTextBox.

Pengendalian Pemeriksaan Ejaan Waktu Nyata Menu Konteks Perintah pemformatan seperti ToggleBold (Ctr+B) FlowDocument konten seperti gambar, paragraf, tabel, dan lainnya
TextBox Yes Yes Tidak. Tidak.
RichTextBox Yes Yes Ya (lihat Gambaran Umum RichTextBox) Ya (lihat Gambaran Umum RichTextBox)

Nota

Meskipun TextBox tidak mendukung perintah pengeditan terkait pemformatan seperti ToggleBold (Ctr+B), banyak perintah dasar yang didukung oleh kedua kontrol seperti MoveToLineEnd. Untuk informasi selengkapnya, lihat EditingCommands .

Fitur yang didukung oleh TextBox tercakup dalam bagian di bawah ini. Untuk informasi selengkapnya tentang RichTextBox, lihat Gambaran Umum RichTextBox.

Pemeriksaan ejaan waktu nyata

Anda dapat mengaktifkan pemeriksaan ejaan real-time di TextBox atau RichTextBox. Saat pemeriksaan ejaan diaktifkan, garis merah muncul di bawah kata yang salah eja (lihat gambar berikut).

Cuplikan layar kontrol TextBox dengan pemeriksaan ejaan diaktifkan, memperlihatkan garis bawah merah di bawah kata yang salah eja.

Untuk mempelajari cara mengaktifkan pemeriksaan ejaan, lihat Mengaktifkan Pemeriksaan Ejaan dalam Kontrol Pengeditan Teks.

Menu konteks

Secara default, keduanya TextBox dan RichTextBox memiliki menu konteks yang muncul saat pengguna mengklik kanan di dalam kontrol. Menu konteks memungkinkan pengguna untuk memotong, menyalin, atau menempelkan (lihat gambar berikut).

Cuplikan layar kontrol TextBox yang menampilkan menu konteks dengan opsi potong, salin, dan tempel.

Anda dapat membuat menu konteks kustom Anda sendiri untuk mengambil alih perilaku default. Untuk informasi selengkapnya, lihat Menggunakan Menu Konteks Kustom dengan Kotak Teks.

Membuat Kotak Teks

TextBox Dapat berupa satu baris dalam tinggi atau terdiri dari beberapa baris. Satu baris TextBox paling baik untuk memasukkan sejumlah kecil teks biasa (misalnya, "Nama", "Nomor Telepon", dan informasi lain dalam formulir). Contoh berikut menunjukkan cara membuat satu baris TextBox.

<Page  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <StackPanel>
    <TextBox Width="200" MaxLength="100" />
  </StackPanel>
</Page>

Anda juga dapat membuat TextBox yang memungkinkan pengguna memasukkan beberapa baris teks. Misalnya, jika formulir Anda meminta sketsa biografis pengguna, Anda ingin menggunakan TextBox yang mendukung beberapa baris teks. Contoh berikut menunjukkan cara menggunakan Extensible Application Markup Language (XAML) untuk menentukan TextBox kontrol yang secara otomatis diperluas untuk mengakomodasi beberapa baris teks.

<TextBox
  Name="tbMultiLine"
  TextWrapping="Wrap"
  AcceptsReturn="True"
  VerticalScrollBarVisibility="Visible"
>
  This TextBox will allow the user to enter multiple lines of text.  When the RETURN key is pressed, 
  or when typed text reaches the edge of the text box, a new line is automatically inserted.
</TextBox>

TextWrapping Menetapkan atribut Wrap menyebabkan teks dibungkus ke baris baru ketika tepi TextBox kontrol tercapai, secara otomatis memperluas TextBox kontrol untuk menyertakan ruang untuk baris baru, jika perlu.

Mengatur atribut AcceptsReturn ke true menyebabkan baris baru dimasukkan saat tombol RETURN ditekan, dan sekali lagi akan secara otomatis memperluas TextBox untuk menyediakan ruang bagi baris baru, jika diperlukan.

Atribut VerticalScrollBarVisibility menambahkan bilah gulir ke TextBox, sehingga konten TextBox dapat digulir jika TextBox meluas di luar ukuran bingkai atau jendela yang menyertakannya.

Untuk informasi selengkapnya tentang berbagai tugas yang terkait dengan penggunaan TextBox, lihat topik cara penggunaan yang tercantum di bagian atas artikel ini.

Mendeteksi kapan konten berubah

Biasanya, peristiwa TextChanged harus digunakan untuk mendeteksi setiap kali teks dalam TextBox atau RichTextBox berubah, bukan KeyDown seperti yang mungkin Anda kira. Misalnya, lihat Mendeteksi Saat Teks di Kotak Teks Telah Berubah.

Gaya dan templat

Anda dapat memodifikasi default ControlTemplate untuk memberi TextBox kontrol tampilan yang unik. Untuk informasi selengkapnya, lihat Apa itu gaya dan templat? dan Cara membuat templat untuk kontrol.

Properti konten

TextBox Kontrol menggunakan Text properti untuk menampilkan konten teks.

Bagian

Tabel berikut mencantumkan bagian-bagian yang diberi nama dari kontrol TextBox.

Bagian Tipe Description
PART_ContentHost FrameworkElement Elemen kerangka kerja yang menghosting konten teks.

Keadaan visual

Tabel berikut mencantumkan status visual untuk TextBox kontrol.

Nama VisualState Nama VisualStateGroup Description
Disabled CommonStates Kontrol dinonaktifkan.
Terfokus FocusStates Kontrol memiliki fokus keyboard.
FokusTidakValid StatusValidasi Kontrol memiliki kesalahan validasi dan memiliki fokus keyboard.
Tidak valid dan Tidak Difokuskan StatusValidasi Kontrol memiliki kesalahan validasi tetapi tidak memiliki fokus keyboard.
MouseOver CommonStates Mouse berada di atas kontrol.
Biasa CommonStates Kontrol berada dalam keadaan normal.
ReadOnly CommonStates Kontrol berada dalam mode baca-saja.
Tidak fokus FocusStates Kontrol tidak memiliki fokus keyboard.
Sah StatusValidasi Kontrol valid dan tidak memiliki kesalahan validasi.

Lihat juga

  • Last updated on