Bagikan melalui

Gambaran Umum Kotak Teks

  • Artikel

Kelas TextBox memungkinkan Anda menampilkan atau mengedit teks yang tidak diformat. Penggunaan umum TextBox adalah mengedit teks yang tidak diformat dalam formulir. Misalnya, formulir yang meminta nama pengguna, nomor telepon, dll akan menggunakan kontrol TextBox untuk input teks. Topik ini memperkenalkan kelas TextBox dan memberikan contoh cara menggunakannya dalam Extensible Application Markup Language (XAML) dan C#.

Kotak Teks atau RichTextBox?

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

Kendali Pemeriksaan Ejaan Waktu Nyata Menu Konteks Perintah pemformatan seperti ToggleBold (Ctr+B) FlowDocument konten seperti gambar, paragraf, tabel, dll.
TextBox Ya Ya Tidak Tidak.
RichTextBox Ya Ya 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. Lihat EditingCommands untuk informasi selengkapnya.

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

Pemeriksaan Ejaan secara langsung

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

Kotak Teks dengan pemeriksaan ejaan

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

Menu Konteks

Secara default, baik TextBox maupun 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).

Kotak Teks dengan menu konteks

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", "Nomor Telepon", 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 kontrol TextBox 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>

Mengatur atribut TextWrapping ke Wrap menyebabkan teks terbawa ke baris baru saat tepi kontrol TextBox tercapai, dengan secara otomatis memperluas kontrol TextBox untuk menyertakan ruang untuk baris baru, jika diperlukan.

Mengatur atribut AcceptsReturn ke 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 melebihi ukuran bingkai atau jendela yang menyertakannya.

Untuk informasi selengkapnya tentang tugas-tugas berbeda terkait penggunaan TextBox, lihat Topik Cara Penggunaan.

Deteksi Kapan Konten Berubah

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

Lihat juga