Onay Kutusu (DİACheckbox)
DİACheckbox kullanıcının ikili bir seçim yapmasına, yani birbirini dışlayan iki olası seçenekten biri arasında seçim yapmasına olanak tanıyan grafiksel bir nesnedir.
Özellikler
| Adı | Default | Değerleri | Amacı |
|---|---|---|---|
| 🆔 Nesne ID | diaCheckbox_1 | depokeys | Nesneye atanacak benzersiz kimliktir. Süreç tasarımında ve kod tarafında bu ID üzerinden erişim sağlanır. |
| 🏷️ Başlık | - | Serbest metin | Form üzerinde kullanıcıya gösterilecek açıklama yazısıdır. |
| 🎨 Arka Plan Rengi | ⚪ | 🟢 Yeşil / 🔵 Mavi / 🟣 Mor | Metin kutusunun arka plan rengini belirler. Görselliği artırmak veya önemli alanları vurgulamak için kullanılır. |
| ✒️ Yazı Rengi | ⚫ | 🟢 Yeşil / 🔵 Mavi / 🟣 Mor | Kullanıcının girdiği veya placeholder olarak görünen metnin 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. |
| ✅ Seçili | Seçili | Seçili / Seçili Değil | Checkbox seçili olarak gelsin mi? |
| 👁️ Gösterim | Görünür | Görünür / Gizli | Nesnenin formda görünüp görünmeyeceğini belirler. |
| 🔒 Salt Okunur | Hayır | Evet / Hayır | Alanın sadece okunabilir olmasını sağlar. Kullanıcı içerik değiştiremez. |
| 🎭 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 | Alana tıklandığında tetiklenir. |
Fonksiyonlar
DİACheckbox 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ç Label'ın değerini okur
📥 Parametre Yok
📤 Dönüş String değer
deger = diaCheckbox_1.getValue() print(deger) # Çıktı: "Başlık"
✏️ setValue()
🎯 Amaç Label'ın değerini değiştirir
📥 Parametre value (String)
📤 Dönüş Yok
diaCheckbox_1.setValue("Yeni Başlık")
# Sonuç: "Yeni Başlık" görünür
🗑️ clearValue()
🎯 Amaç Label'ı temizler
📥 Parametre Yok
📤 Dönüş Yok
diaCheckbox_1.clearValue() # Sonuç: Label boş görünür
🆔 Kimlik Yönetimi
🔍 getId()
Nesne ID'sini döndürür
nesneID = diaCheckbox_1.getId()
print(f"ID: {nesneID}")
# Çıktı: ID: diaCheckbox_1
🏷️ setId()
Nesne ID'sini değiştirir
diaCheckbox_1.setId("baslikLabel")
# Yeni ID: baslikLabel
🎨 Renk Kontrolü
🖌️ Arkaplan Rengi
setBackgroundColor(color)
# Hex kod
diaCheckbox_1.setBackgroundColor("#FF5733")
# Renk ismi
diaCheckbox_1.setBackgroundColor("lightblue")
# RGB
diaCheckbox_1.setBackgroundColor("rgb(255,87,51)")
getBackgroundColor()
renk = diaCheckbox_1.getBackgroundColor()
print(f"Arkaplan: {renk}")
# Çıktı: Arkaplan: #FF5733
✒️ Yazı Rengi
setFontColor(color)
# Farklı formatlar
diaCheckbox_1.setFontColor("#2E86AB")
diaCheckbox_1.setFontColor("darkgreen")
diaCheckbox_1.setFontColor("rgb(46,134,171)")
getFontColor()
yaziRengi = diaCheckbox_1.getFontColor()
print(f"Yazı rengi: {yaziRengi}")
# Çıktı: Yazı rengi: #2E86AB
🔤 Font Ayarları
📏 Boyut
setFontSize(size)
diaCheckbox_1.setFontSize(18)
getFontSize()
boyut = diaCheckbox_1.getFontSize()
print(f"Boyut: {boyut}pt")
# Çıktı: Boyut: 18pt
🔤 Tip
setFont(fontName)
diaCheckbox_1.setFont("Arial")
getFont()
font = diaCheckbox_1.getFont()
print(f"Font: {font}")
# Çıktı: Font: Arial
↔️ Hizalama
setTextAlign(alignment)
diaCheckbox_1.setTextAlign("AlignTop", "AlignHCenter")
diaCheckbox_1.setTextAlign("AlignVCenter", "AlignRight")
✨ Stil Efektleri
Kalın
diaCheckbox_1.setBold(True) # Yazı kalınlaşır diaCheckbox_1.setBold(False) # Normal yazı
İtalik
diaCheckbox_1.setItalic(True) # Yazı italik olur diaCheckbox_1.setItalic(False) # Normal yazı
Alt Çizgi
diaCheckbox_1.setUnderline(True) # Altı çizili diaCheckbox_1.setUnderline(False) # Çizgi yok
Üst Çizgi
diaCheckbox_1.setLineThrough(True) # Üstü çizili diaCheckbox_1.setLineThrough(False) # Çizgi yok
🚀 Kullanım Örneği
🔔 Sinyaller
DİALabel nesnesi için kullanılabilir Aksiyon (Clicked) aşağıda tanımlanmıştır. Bu sinyal aksiyon alanlarında veya script üzerinden bağlanarak kullanılabilir.
🖱️ Kullanıcı Etkileşimi
👆 clicked
🎯 Amaç Label’a tıklandığında tetiklenir
📥 Parametre Yok
📤 Dönüş Yok
# Checkbox'a tıklandığında tetiklenir.
print("Tıklandı!")