C# Windows Form’da Temel Kontroller

C# ve .NET Framework kullanarak masaüstü uygulamaları geliştirmeye karar verdiyseniz, Windows Forms (WinForms) sizin için en ideal başlangıç noktalarından biridir. Siyah beyaz ve sadece metinden oluşan konsol ekranlarını geride bırakıp, kullanıcıların fareyle tıklayabildiği, veri girebildiği ve etkileşime geçebildiği görsel arayüzler tasarlamak oldukça heyecan vericidir.

Windows Forms uygulamalarında kullanıcı arayüzünü (UI) oluşturan görsel yapı taşlarına Kontrol (Control) adı verilir. Form üzerine yerleştirdiğiniz bir düğme, bir yazı alanı veya bir açılır liste; hepsi birer kontroldür. Bu rehberde, Visual Studio’daki Toolbox (Araç Kutusu) panelinden sürükleyip bırakarak formunuza ekleyebileceğiniz “Temel Kontrolleri” ve bunların projelerinizde nasıl kullanılacağını detaylı örneklerle öğreneceksiniz.

Temel Windows Form Kontrolleri Nelerdir?

Yüzlerce farklı kontrol çeşidi olsa da bir uygulamanın temelini oluşturan ve en sık kullanılan nesneler şunlardır:

1. Label (Etiket)

Kullanıcıya bilgi vermek, yönlendirme yapmak veya diğer kontrollerin ne işe yaradığını açıklamak için kullanılan metin nesneleridir. Kullanıcılar program çalışırken Label üzerindeki yazıyı doğrudan değiştiremezler.

• Kullanım Örneği: Bir metin kutusunun yanına “Lütfen Adınızı Giriniz:” yazmak için kullanılır.

2. TextBox (Metin Kutusu)

Kullanıcıdan metinsel veya sayısal veri girişi almak için kullanılan en önemli alanlardır.

• Temel Özellikleri:
  • Text: Metin kutusunun içindeki yazıyı temsil eder.
  • MaxLength: Kullanıcının girebileceği maksimum karakter sayısını sınırlar.
  • Multiline: Bu özellik true (doğru) yapıldığında, TextBox tek satırlık bir kutu olmaktan çıkıp, Enter tuşuna basıldığında alt satıra geçilebilen büyük bir metin veya paragraf alanına dönüşür.
  • PasswordChar: Şifre ekranlarında girilen karakterlerin ekranda * veya • şeklinde gizlenmesini sağlar.
  • ReadOnly: Kullanıcının kutudaki yazıyı sadece okumasını, ancak değiştirememesini sağlar.

3. Button (Düğme)

Kullanıcının uygulamada bir eylemi başlatması veya onaylaması için tıklayabileceği komut düğmeleridir. Uygulama içindeki bir kodu tetiklemek için en çok Button kontrolünün “Click” (Tıklama) olayı (event) kullanılır.

• Kullanım Örneği: Formun altındaki “Kaydet”, “Giriş Yap” veya “İptal” butonları.

4. CheckBox (Onay Kutusu)

Kullanıcıya sunulan seçeneklerden birden fazlasını aynı anda seçebilme veya bir durumu “Açık/Kapalı” (True/False) olarak belirleme imkânı sunar.

• Kullanım Örneği: Bir kayıt formunda “Bildiğiniz Yabancı Diller” sorusu için İngilizce, Almanca ve İspanyolca seçeneklerinin hepsinin aynı anda seçilebilmesi. Veya “Kullanıcı Sözleşmesini Okudum ve Kabul Ediyorum” onayı için kullanılır.

5. RadioButton (Seçenek Düğmesi)

CheckBox nesnesinden farklı olarak, birbiriyle ilişkili birçok seçenek içinden sadece birinin seçilmesine imkân sağlayan kontroldür. Aynı grup (container) içinde bulunan RadioButton’lardan birini seçtiğinizde diğerlerinin seçimi otomatik olarak iptal olur.

• Kullanım Örneği: “Cinsiyetiniz” sorusuna yanıt olarak sunulan “Kadın” ve “Erkek” seçeneklerinden yalnızca birinin seçilebilmesi.

6. ComboBox (Açılır Liste)

Kullanıcıya bir seçenek listesi sunan ve tıklandığında aşağı doğru açılan araçtır. İhtiyaca göre kullanıcının listeye dışarıdan veri yazmasına izin verilebilir veya sadece listeden seçim yapması zorunlu kılınabilir.

• Kullanım Örneği: Kullanıcının yaşadığı “Şehir” bilgisini listeden (Örn: Ankara, İstanbul, İzmir) seçmesi.

7. ListBox (Liste Kutusu)

Seçeneklerin açılır-kapanır bir yapı yerine, form üzerinde daima açık ve dikey bir liste (eğer liste uzunsa kaydırma çubuğu ile) hâlinde gösterildiği nesnedir. Birden fazla elemanın alt alta sergilenmesi için idealdir.

• Kullanım Örneği: Alışveriş sepetine eklenen ürünlerin alt alta listelenmesi.

8. PictureBox (Resim Kutusu)

Form üzerinde logo, fotoğraf veya grafik göstermek için kullanılır. Arka plan rengi ayarlayabildiğiniz gibi, resmi kutuya sığdırmak için SizeMode özelliğinden faydalanabilirsiniz.

Önemli İpucu: Name ve Text Özelliklerini Karıştırmayın!

Yeni başlayanların en çok düştüğü tuzaklardan biri, nesnenin Name (İsim) özelliği ile Text (Metin) özelliğini birbirine karıştırmaktır.

• Name: Kontrolün arka plandaki yazılım tarafındaki (C# kodlarındaki) kimliğidir. Programcı bu nesneye kodlarla hükmederken bu ismi kullanır. Boşluk ve Türkçe karakter içermemeli, örneğin txtAdSoyad veya btnKaydet gibi isimlendirilmelidir.
• Text: Nesnenin form üzerinde dışarıdan görünen yazısıdır. Örneğin bir düğmenin kod tarafındaki adı btnGiris iken, kullanıcının düğmenin üzerinde gördüğü Text özelliği “Sisteme Giriş Yap” olabilir.

Tüm Kontrolleri Birleştiren Pratik Bir Örnek: Kullanıcı Kayıt Formu

Öğrendiğimiz bu temel kontrolleri tek bir senaryoda toplayalım ve nasıl çalıştıklarını C# kodlarıyla pekiştirelim. Senaryomuz basit bir “Kullanıcı Kayıt Sistemi” olsun.

Tasarım Adımları:

1. Toolbox’tan formunuza 1 adet Label ve 1 adet TextBox (Ad Soyad almak için) ekleyin. TextBox’ın Name özelliğini txtAdSoyad yapın.
2. Cinsiyet seçimi için 2 adet RadioButton ekleyin. Text özelliklerini “Kadın” ve “Erkek”, Name özelliklerini ise rbKadin ve rbErkek yapın.
3. Mezuniyet durumu seçimi için 1 adet ComboBox ekleyin. Name özelliğini cmbEgitim yapıp, içine (Lise, Lisans, Yüksek Lisans) ekleyin.
4. Kullanıcı sözleşmesi için 1 adet CheckBox ekleyip Text’ini “Sözleşmeyi Kabul Ediyorum”, Name’ini chkSozlesme yapın.
5. Son olarak 1 adet Button ekleyin. Text özelliğini “Kaydet”, Name özelliğini btnKaydet yapın.

Kodlama Adımı: Kaydet butonunun üzerine tasarım ekranında çift tıklayarak “Click” olayına (event) gidelim ve şu C# kodlarını yazalım:

private void btnKaydet_Click(object sender, EventArgs e)
{
    // 1. CheckBox kontrolü: Kullanıcı sözleşmesi onaylanmış mı?
    if (chkSozlesme.Checked == false)
    {
        MessageBox.Show("Lütfen kullanıcı sözleşmesini kabul ediniz!", "Hata");
        return; // Sözleşme onaylanmadıysa işlemi burada kes.
    }

    // 2. TextBox kontrolü: Ad Soyad bilgisini al.
    string adSoyad = txtAdSoyad.Text;

    // 3. RadioButton kontrolü: Hangi cinsiyet seçili?
    string cinsiyet = "";
    if (rbKadin.Checked == true)
    {
        cinsiyet = "Kadın";
    }
    else if (rbErkek.Checked == true)
    {
        cinsiyet = "Erkek";
    }

    // 4. ComboBox kontrolü: Hangi eğitim durumu seçili?
    string egitim = cmbEgitim.Text;

    // 5. Elde edilen tüm verileri birleştirip Label veya MessageBox ile gösterelim.
    string sonucMesaji = "Kayıt Başarılı!\n\n" +
                         "Ad Soyad: " + adSoyad + "\n" +
                         "Cinsiyet: " + cinsiyet + "\n" +
                         "Eğitim: " + egitim;

    MessageBox.Show(sonucMesaji, "Kayıt Bilgisi");
}

Kodlar Nasıl Çalışıyor?

Yukarıdaki kod çalıştırıldığında program önce CheckBox‘ın Checked (işaretli mi?) özelliğini kontrol eder. Eğer seçili değilse işlemi durdurur. Ardından kullanıcının TextBox nesnesine girdiği yazıyı Text özelliği aracılığıyla alır. RadioButton grubunda hangisinin işaretli olduğuna bakar ve son olarak açılır liseden (ComboBox) seçilen değeri alıp başarılı bir mesaj olarak ekrana basar.

Sonuç

C# Windows Form programlamada görsel kontroller, programınızın can damarlarıdır. Visual Studio üzerinde TextBox, Button, Label gibi temel araçları sürükle-bırak yöntemiyle formunuza eklemek ve Properties (Özellikler) penceresinden onları dilediğiniz gibi şekillendirmek son derece eğlencelidir. Kullanıcının eylemlerine (butona tıklamak veya kutuyu işaretlemek gibi) doğru kodlarla cevap verdiğinizde, profesyonel masaüstü uygulamalarının temelini atmış olursunuz. Kontrollerin sınırlarını görmek için Visual Studio’yu açıp kendi form denemelerinizi yapmaktan çekinmeyin! Bol pratik, yazılımı öğrenmenin en iyi yoludur.