Gambaran Umum Kotak Teks

Kelas memungkinkan TextBox 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, dll akan menggunakan TextBox kontrol untuk input teks. Topik ini memperkenalkan TextBox kelas dan memberikan contoh cara menggunakannya dalam Extensible Application Markup Language (XAML) dan C#.

Kotak Teks atau RichTextBox?

Baik TextBox dan RichTextBox izinkan pengguna untuk memasukkan teks tetapi kedua kontrol digunakan untuk skenario yang berbeda. Membutuhkan TextBox lebih sedikit sumber daya sistem sehingga RichTextBox sangat 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, dll paling baik dicapai menggunakan RichTextBox. Tabel di bawah ini meringkas fitur TextBox utama dan RichTextBox.

Kontrol	Pemeriksaan Ejaan real-time	Menu Konteks	Perintah pemformatan seperti ToggleBold (Ctr+B)	FlowDocument konten seperti gambar, paragraf, tabel, dll.
TextBox	Ya	Ya	Tidak	Nomor.
RichTextBox	Ya	Ya	Ya (lihat Gambaran Umum RichTextBox)	Ya (lihat Gambaran Umum RichTextBox)

Catatan

Meskipun TextBox tidak mendukung perintah pengeditan terkait pemformatan seperti ToggleBold (Ctr+B), banyak perintah dasar yang didukung oleh kedua kontrol seperti MoveToLineEnd. Lihat EditingCommands untuk informasi lebih lanjut.

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

Pemeriksaan Ejaan real-time

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 di bawah).

Lihat Mengaktifkan Pemeriksaan Ejaan dalam Kontrol Pengeditan Teks untuk mempelajari cara mengaktifkan pemeriksaan ejaan.

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 menempel (lihat gambar di bawah).

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

Membuat Kotak Teks

TextBox Dapat berupa satu baris dalam tinggi atau terdiri dari beberapa baris. Satu baris TextBox paling baik untuk memasukkan teks biasa dalam jumlah kecil (yaitu "Nama", "Telepon Angka", dll. dalam bentuk). 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 Mengatur atribut untuk Wrap menyebabkan teks dibungkus ke baris baru saat tepi TextBox kontrol tercapai, secara otomatis memperluas TextBox kontrol untuk menyertakan ruang untuk baris baru, jika perlu.

AcceptsReturn Mengatur atribut untuk true menyebabkan baris baru dimasukkan saat tombol RETURN ditekan, sekali lagi secara otomatis memperluas TextBox untuk menyertakan ruang untuk baris baru, jika perlu.

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.

Deteksi Kapan Konten Berubah

TextChanged Biasanya peristiwa harus digunakan untuk mendeteksi setiap kali teks dalam atau RichTextBox berubah, lebih tepatnya KeyDown seperti yang TextBox Anda harapkan. Lihat Mendeteksi Kapan Teks di Kotak Teks Telah Berubah misalnya.

Baca juga

• Topik Cara Penggunaan
• Gambaran Umum RichTextBox