Seçim Kutusu (DİAOptionBox)
DİAOptionBox, formlarda kullanıcıların tek seçim yapabilmesi için kullanılan radio button (seçenek kutusu) nesnesidir.
Bu nesne sayesinde kullanıcıdan seçim yapılabilir, seçim durumu kontrol edilebilir ve formun tasarımına uygun görsel ayarlamalar yapılabilir.
Arka plan rengi, yazı rengi, font ve hizalama gibi görsel özelliklerinin yanında; tooltip, seçim durumu ve aksiyon tanımlamaları gibi etkileşimsel özellikler de destekler.
Özellikler
| Adı | Default | Değerleri | Amacı |
|---|
| 🆔 Nesne ID | diaOptionBox_1 | Örn: cinsiyetSecimi | Nesneye atanacak benzersiz kimliktir. Süreç tasarımında ve kod tarafında bu ID üzerinden erişim sağlanır. |
| 🏷️ Değer | Seçenek Kutusu | Serbest metin | Radio button'un yanında görünecek etiket metnidir. |
| 🎨 Arka Plan Rengi | ⚪ | 🟢 Yeşil / 🔵 Mavi / 🟣 Mor | Radio button'un arka plan rengini belirler. Görselliği artırmak veya önemli alanları vurgulamak için kullanılır. |
| ✒️ Yazı Rengi | ⚫ | 🟢 Yeşil / 🔵 Mavi / 🟣 Mor | Etiket metninin rengini belirler. |
| 🔤 Font | Helvetica | Sistem fontları | Yazının tipografisini belirler. Örn: Arial, Times New Roman. |
| 🔠 Font Boyu | 12 pt | Sayısal değer | Yazının büyüklüğünü ayarlar. |
| 🔡 Font Tipi | Normal | Koyu, İtalik, Altı Çizgili, Üstü Çizgili | Metin stilini belirler. Birden fazla stil aynı anda uygulanabilir. |
| 👁️ Gösterim | Görünür | Görünür / Gizli | Nesnenin formda görünüp görünmeyeceğini belirler. |
| ✅ Seçili Durum | Hayır | Evet / Hayır | Radio button'un başlangıçta seçili olup olmayacağını belirler. |
| 🎭 Stil (CSS Sınıfı) | - | CSS sınıfı | Tasarım tarafında özel CSS sınıfları eklenerek özelleştirilmiş görsel stil uygulanabilir. |
| 🖱️ Aksiyon (Clicked) | - | Olay bağlanabilir | Kullanıcı radio button'a tıkladığında tetiklenir. |
Fonksiyonlar
DİAOptionBox nesnesi için kullanılabilir tüm fonksiyonlar, kullanım örnekleri ve çıktıları ile birlikte aşağıda kategorize edilmiştir. Nesne özelliklerinde yer alan aksiyon alanlarında açılan DİAScript editörü üzerinde fonksiyonlar kullanılabilir.
📝 Değer İşlemleri
📖 getValue()
🎯 Amaç
OptionBox'un seçili durumunu okur
📥 Parametre
Yok
📤 Dönüş
Boolean değer (True/False)
seciliMi = diaOptionBox_1.getValue() print(seciliMi) # Çıktı: True veya False
✏️ setValue()
🎯 Amaç
OptionBox'un seçili durumunu ayarlar
📥 Parametre
value (Boolean)
📤 Dönüş
Yok
# Seçili yap diaOptionBox_1.setValue(True) # Seçimi kaldır diaOptionBox_1.setValue(False)
🆔 Kimlik Yönetimi
🔍 getId()
Nesne ID'sini döndürür
nesneID = diaOptionBox_1.getId()
print(f"ID: {nesneID}")
# Çıktı: ID: diaOptionBox_1
🏷️ setId()
Nesne ID'sini değiştirir
diaOptionBox_1.setId("cinsiyetErkek")
# Yeni ID: cinsiyetErkek
🎨 Renk Kontrolü
🖌️ Arkaplan Rengi
setBackgroundColor(color)
# Hex kod
diaOptionBox_1.setBackgroundColor("#F0F8FF")
# Renk ismi
diaOptionBox_1.setBackgroundColor("lightgray")
# RGB
diaOptionBox_1.setBackgroundColor("rgb(240,248,255)")
getBackgroundColor()
renk = diaOptionBox_1.getBackgroundColor()
print(f"Arkaplan: {renk}")
# Çıktı: Arkaplan: #F0F8FF
✒️ Yazı Rengi
setFontColor(color)
# Farklı formatlar
diaOptionBox_1.setFontColor("#333333")
diaOptionBox_1.setFontColor("darkblue")
diaOptionBox_1.setFontColor("rgb(51,51,51)")
getFontColor()
yaziRengi = diaOptionBox_1.getFontColor()
print(f"Yazı rengi: {yaziRengi}")
# Çıktı: Yazı rengi: #333333
🔤 Font Ayarları
📏 Boyut
setFontSize(size)
diaOptionBox_1.setFontSize(14)
getFontSize()
boyut = diaOptionBox_1.getFontSize()
print(f"Boyut: {boyut}")
# Çıktı: Boyut: 14px
🔤 Tip
setFont(fontName)
diaOptionBox_1.setFont("Consolas")
getFont()
font = diaOptionBox_1.getFont()
print(f"Font: {font}")
# Çıktı: Font: "Consolas"
↔️ Hizalama
setTextAlign(vAlign, hAlign)
# Ortada hizala
diaOptionBox_1.setTextAlign("AlignVCenter", "AlignHCenter")
# Sağa hizala
diaOptionBox_1.setTextAlign("AlignVCenter", "AlignRight")
✨ Stil Efektleri
Kalın
diaOptionBox_1.setBold(True) # Yazı kalınlaşır diaOptionBox_1.setBold(False) # Normal yazı
İtalik
diaOptionBox_1.setItalic(True) # Yazı italik olur diaOptionBox_1.setItalic(False) # Normal yazı
Alt Çizgi
diaOptionBox_1.setUnderline(True) # Altı çizili diaOptionBox_1.setUnderline(False) # Çizgi yok
Üst Çizgi
diaOptionBox_1.setLineThrough(True) # Üstü çizili diaOptionBox_1.setLineThrough(False) # Çizgi yok
🚀 Kullanım Örnekleri
✅ Seçim Kontrolü
# Kullanıcı seçim yaptı mı kontrol et
if diaOptionBox_1.getValue():
print("Seçenek seçildi")
else:
print("Seçenek seçilmedi")
🎨 Görsel Özelleştirme
# Önemli seçenekleri vurgula
diaOptionBox_1.setBackgroundColor("#FFF3CD")
diaOptionBox_1.setFontColor("#856404")
diaOptionBox_1.setFont("Arial Black")
diaOptionBox_1.setFontSize(14)
diaOptionBox_1.setBold(True)
🔄 Dinamik Seçim
# Koşula göre seçimi ayarla
if kullaniciTipi == "admin":
diaOptionBox_1.setValue(True)
else:
diaOptionBox_1.setValue(False)
🖱️ Kullanıcı Etkileşimi
🖱️ Clicked
🎯 Amaç
Kullanıcı radio button'a tıkladığında (seçim durumu değiştiğinde) tetiklenir.
📥 Parametre
Yok
📤 Dönüş
Yok
# Seçim yapıldığında işlem yap
if diaOptionBox_1.getValue():
print("Seçenek seçildi")
# İlgili işlemleri yap
else:
print("Seçenek kaldırıldı")
