Sayı (DiaNumber)
DiaNumber, formlarda kullanıcıların sayı girişi yapabilmesi için kullanılan düzenlenebilir bir alan (input) nesnesidir. Arka plan rengi, yazı rengi, maximum değer, sayı hassasiyeti ve aksiyon tanımlamaları gibi etkileşimsel özellikler de destekler.
Özellikler
| Adı | Default | Değerleri | Amacı |
|---|---|---|---|
| 🆔 Nesne ID | diaNumber_1 | Örn: baslangictarihi | Nesneye atanacak benzersiz kimliktir. Süreç tasarımında ve kod tarafında bu ID üzerinden erişim sağlanır. |
| 🏷️ Değer | 0 | Serbest metin | Form üzerinde kullanıcıya gösterilecek başlık veya açıklama yazısıdır. |
| ⬆️ Max Değer | 9999999999,00 | Serbest sayı | Maximum girilebilecek sayıyı bildirebiliriz. |
| 🎯 Hassasiyet | 2 | Serbest sayı | Sayı alanınımızın hassasiyetini belirleriz. Bir şey girilmezse integer değer olarak giriş yapılı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. |
| ↔️ Yatay Hizalama | Sola | Sol / Orta / Sağ | Metnin yatay konumunu ayarlar. Özellikle başlık veya etiketler için önemlidir. |
| ↕️ Dikey Hizalama | Orta | Üst / Orta / Alt | Metnin kutu içerisindeki dikey konumunu ayarlar. |
| 🧮 Hesap Makinesi | Göster | Göster/Gösterme | İnput alanı içerisinde hesap makinesinin olmasını kontrol eder. |
| 💬 İpucu (Tooltip) | - | Serbest metin | Alanın üzerine gelindiğinde küçük bilgi kutusu şeklinde görünen açıklamadır. |
| 🔒 Salt Okunur | Hayır | Evet / Hayır | Alanın sadece okunabilir olmasını sağlar. Kullanıcı içerik değiştiremez. |
| 👁️ Gösterim | Görünür | Görünür / Gizli | Nesnenin formda görünüp görünmeyeceğini belirler. |
| ❗ Zorunluluk | Hayır | Evet / Hayır | Kullanıcı bu alanı doldurmadan formu kaydedemez. |
| 📅 Takvim | Göster | Göster / Gösterme | Alanın sadece okunabilir olmasını sağlar. Kullanıcı içerik değiştiremez. |
| ✅ Boş Girilebilsin | Hayır | Evet / Hayır | Gönderilen değer null olabilsin mi? |
| 🎭 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 (Sayı Changed) | - | Olay bağlanabilir | Kullanıcı metin değiştirdiğinde tetiklenir. |
| 🖱️ Aksiyon (Return Pressed) | - | Olay bağlanabilir | Kullanıcı Enter tuşuna bastığında tetiklenir. |
| 🖱️ Aksiyon (Editing Finished) | - | Olay bağlanabilir | Kullanıcı yazma işlemini tamamladığında (fokus kaybı veya enter) çalışır. |
| 🖱️ Aksiyon (Focus In) | - | Olay bağlanabilir | Alan seçildiğinde tetiklenir. |
| 🖱️ Aksiyon (Focus Out) | - | Olay bağlanabilir | Alan odaktan çıktığında tetiklenir. |
Fonksiyonlar
DiaNumber 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ç Sayı alanının değerini okur
📥 Parametre Yok
📤 Dönüş String değer
deger = diaNumber_1.getValue() print(deger) # Çıktı: “35”
✏️ setValue()
🎯 Amaç Sayı alanına yeni değer atar
📥 Parametre value (String)
📤 Dönüş Yok
diaNumber_1.setValue(“10”) diaNumber_1.setValue(29) # Sonuç: “10” görünür
🗑️ clearValue()
🎯 Amaç Sayı alanını temizler
📥 Parametre Yok
📤 Dönüş Yok
diaNumber_1.clearValue() # Sonuç: Sayı alanı boş görünür
🆔 Kimlik Yönetimi
🔍 getId()
Nesne ID'sini döndürür
nesneID = diaNumber_1.getId()
print(f"ID: {nesneID}")
# Çıktı: ID: diaNumber_1
🏷️ setId()
Nesne ID'sini değiştirir
diaNumber_1.setId(“sayi3”) # Yeni ID: sayi3
🎨 Renk Kontrolü
🖌️ Arkaplan Rengi
setBackgroundColor(color)
# Hex kod
diaNumber_1.setBackgroundColor("#F0F8FF")
# Renk ismi
diaNumber_1.setBackgroundColor("lightgray")
# RGB
diaNumber_1.setBackgroundColor("rgb(240,248,255)")
getBackgroundColor()
renk = diaNumber_1.getBackgroundColor()
print(f"Arkaplan: {renk}")
# Çıktı: Arkaplan: #F0F8FF
✒️ Yazı Rengi
setFontColor(color)
# Farklı formatlar
diaNumber_1.setFontColor("#333333")
diaNumber_1.setFontColor("darkblue")
diaNumber_1.setFontColor("rgb(51,51,51)")
getFontColor()
yaziRengi = diaNumber_1.getFontColor()
print(f"Yazı rengi: {yaziRengi}")
# Çıktı: Yazı rengi: #333333
🔤 Font Ayarları
📏 Boyut
setFontSize(size)
diaNumber_1.setFontSize(14)
getFontSize()
boyut = diaNumber_1.getFontSize()
print(f"Boyut: {boyut}")
# Çıktı: Boyut: 14px
🔤 Tip
setFont(fontName)
diaNumber_1.setFont("Consolas")
getFont()
font = diaNumber_1.getFont()
print(f"Font: {font}")
# Çıktı: Font: "Consolas"
↔️ Hizalama
setSayıAlign(vAlign, hAlign)
# Ortada hizala
diaNumber_1.setSayıAlign("AlignVCenter", "AlignHCenter")
# Sağa hizala
diaNumber_1.setSayıAlign("AlignVCenter", "AlignRight")
✨ Stil Efektleri
Kalın
diaNumber_1.setBold(True) # Yazı kalınlaşır diaNumber_1.setBold(False) # Normal yazı
İtalik
diaNumber_1.setItalic(True) # Yazı italik olur diaNumber_1.setItalic(False) # Normal yazı
Alt Çizgi
diaNumber_1.setUnderline(True) # Altı çizili diaNumber_1.setUnderline(False) # Çizgi yok
Üst Çizgi
diaNumber_1.setLineThrough(True) # Üstü çizili diaNumber_1.setLineThrough(False) # Çizgi yok
🔢 Sayısal Alan Özellikleri
🧮 showCalculator()
🎯 Amaç Hesap makinesi iconunu göster/gizle işlemlerini sağlar
📥 Parametre True/False
📤 Dönüş Yok
deger = diaNumber_1.showCalculator(False)
🔢 setPrecision()
🎯 Amaç Sayı alanının hassasiyetini belirler
📥 Parametre value (Integer)
📤 Dönüş Yok
diaNumber_1.setValue(4)
⬆️ setMaxValue()
🎯 Amaç Maximum girilebilecek sayıyı berlirtir.
📥 Parametre Value(Integer)
📤 Dönüş Yok
diaNumber_1.setMaxValue(100)
🖱️ Kullanıcı Etkileşimi
🔤 Sayı Changed
🎯 Amaç Kullanıcı metin alanındaki içeriği değiştirdiğinde tetiklenir.
📥 Parametre Yeni metin (str)
📥 Dönüş Yok
print(“Sayı değişti:", newSayı)
↩️ Return Pressed
🎯 Amaç Kullanıcı Enter tuşuna bastığında tetiklenir.
📥 Parametre Yok
📥 Dönüş Yok
print("Enter tuşuna basıldı")
✅ Editing Finished
🎯 Amaç Kullanıcı yazma işlemini bitirdiğinde (Enter tuşu veya fokus kaybı) tetiklenir.
📥 Parametre Yok
📥 Dönüş Yok
print(“Düzenleme tamamlandı")
👁️ Focus In
🎯 Amaç Metin alanı odaklandığında tetiklenir.
📥 Parametre Yok
📤 Dönüş Yok
print("Alan seçildi (focus in)")
👁️ Focus Out
🎯 Amaç Metin alanı odaktan çıktığında tetiklenir.
📥 Parametre Yok
📥 Dönüş Yok
print("Alan odaktan çıktı (focus out)")