TextBox'a Genel Bakış

sınıfı, TextBox biçimlendirilmemiş metinleri görüntülemenizi veya düzenlemenizi sağlar. Bir TextBox öğesinin yaygın kullanımlarından biri, bir formda biçimlendirilmemiş bir metni düzenlemektir. Örneğin, kullanıcının adını, telefon numarasını vb. soran bir form metin girişi için denetimleri kullanır TextBox . Bu konu, TextBox sınıfını tanıtır ve hem Genişletilebilir Uygulama Biçimlendirme Dili (XAML) hem de C# dilinde nasıl kullanılacağına ilişkin örnekler sağlar.

TextBox mı yoksa RichTextBox mı?

TextBox Hem hem de RichTextBox kullanıcıların metin girişine izin verir, ancak iki denetim farklı senaryolar için kullanılır. A TextBox , bir'den RichTextBox daha az sistem kaynağı gerektirdiğinden, yalnızca düz metnin düzenlenmesi gerektiğinde (örneğin, bir formda kullanım) idealdir. Bir RichTextBox, kullanıcının biçimlendirilmiş metinleri, resimleri, tabloları veya desteklenen diğer içeriği düzenlemesi gerektiğinde daha iyi bir seçimdir. Örneğin, biçimlendirme, resim vb. gerektiren bir belgeyi, makaleyi veya blogu düzenlemek en iyi RichTextBoxkullanılarak gerçekleştirilir. Aşağıdaki tabloda TextBox ve RichTextBox'in birincil özellikleri özetlenmiştir.

Yönetim	Gerçek Zamanlı Yazım Denetimi	Bağlam Menüsü	ToggleBold (Ctr+B) gibi biçimlendirme komutları	FlowDocument gibi içerikler; resimler, paragraflar, tablolar vb.
TextBox	Evet	Evet	Hayı	Hayır.
RichTextBox	Evet	Evet	Evet (bkz . RichTextBox'a Genel Bakış)	Evet (bkz . RichTextBox'a Genel Bakış)

Uyarı

Biçimlendirmeyle ilgili düzenleme komutlarını (Ctr+B) gibi TextBox desteklemese de, ToggleBold ve MoveToLineEnd gibi her iki denetimde birçok temel komut desteklenir. Daha fazla bilgi için bkz. EditingCommands.

tarafından TextBox desteklenen özellikler aşağıdaki bölümlerde ele alınmıştır. hakkında RichTextBoxdaha fazla bilgi için bkz. RichTextBox'a Genel Bakış.

Gerçek Zamanlı Yazım Denetimi

TextBox veya RichTextBox içinde gerçek zamanlı yazım denetimini etkinleştirebilirsiniz. Yazım denetimi açıkken, yanlış yazılmış sözcüklerin altında kırmızı bir çizgi görünür (aşağıdaki resme bakın).

Yazım denetimini etkinleştirmeyi öğrenmek için bkz. Metin Düzenleme Denetiminde Yazım Denetimini Etkinleştirme .

Bağlam Menüsü

Varsayılan olarak, hem TextBox hem de RichTextBox, kullanıcı denetimin içine sağ tıkladığında görüntülenen bir bağlam menüsüne sahiptir. Bağlam menüsü kullanıcının kesmesine, kopyalamasına veya yapıştırmasına olanak tanır (aşağıdaki resme bakın).

Varsayılan davranışı geçersiz kılmak için kendi özel bağlam menünüzü oluşturabilirsiniz. Daha fazla bilgi için bkz. TextBox ile Özel Bağlam Menüsü Kullanma .

Metin Kutuları Oluşturma

bir TextBox , yüksekliğinde tek bir çizgi olabilir veya birden çok çizgiden oluşabilir. Tek bir satır TextBox , az miktarda düz metin (örneğin, "Ad", "Telefon Numarası" vb.) bir formda giriş için en iyisidir. Aşağıdaki örnekte tek bir satırın TextBoxnasıl oluşturulacağı gösterilmektedir.

<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>

Kullanıcının birden çok metin satırı girmesini sağlayan bir TextBox de oluşturabilirsiniz. Örneğin, formunuz kullanıcının biyografik bir taslağını istediyse, birden çok metin satırı destekleyen bir TextBox kullanmak isteyebilirsiniz. Aşağıdaki örnekte, birden çok metin satırına sığacak şekilde otomatik olarak genişleyen bir TextBox denetim tanımlamak için Genişletilebilir Uygulama biçimlendirme dilinin (XAML) nasıl kullanılacağı gösterilmektedir.

<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 özniteliğini Wrap olarak ayarlamak, denetimin TextBox kenarına ulaşıldığında metnin yeni bir satıra kaydırılmasına neden olur ve gerekirse, denetim TextBox otomatik olarak genişletilerek yeni satır için yer açılır.

AcceptsReturn özniteliğini true olarak ayarlamak, RETURN tuşuna basıldığında yeni bir satırın eklenmesine neden olur ve gerekirse, TextBox öğesini yeniden otomatik olarak yeni bir satır eklenebilecek şekilde genişletir.

VerticalScrollBarVisibility özniteliği, TextBox'e bir kaydırma çubuğu ekler, böylece TextBox, onu çevreleyen çerçevenin veya pencerenin boyutunu aşarsa, TextBox'nin içeriği kaydırılabilir.

TextBox kullanımıyla ilişkili farklı görevler hakkında daha fazla bilgi için lütfen Nasıl Yapılır Konuları'na bakın.

İçeriğin Ne Zaman Değiştiğini Algılama

Genellikle olayTextChanged, bir veya TextBox içindeki metin her değiştiğindeRichTextBox, beklediğiniz gibi algılamak için KeyDown kullanılmalıdır. Bir örnek için bkz. TextBox'taki Metnin Ne Zaman Değiştiğini Algılama.

Ayrıca bakınız

• Nasıl Yapılır Konuları
• RichTextBox'a Genel Bakış