Tarih (DİADate)
DİADate, formlarda kullanıcıların tarih girişi yapabilmesi için kullanılan düzenlenebilir bir alan (input) nesnesidir. Arka plan rengi, yazı rengi ve aksiyon tanımlamaları gibi etkileşimsel özellikler de destekler.
Özellikler
| Adı | Default | Değerleri | Amacı |
|---|---|---|---|
| 🆔 Nesne ID | diaDate_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 | - | Serbest metin | Form üzerinde kullanıcıya gösterilecek başlık veya 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. |
| ↔️ 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. |
| 💬 İ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 | Nesne üzerinde takvimin olup olmamasını belirler. |
| ✅ 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 (Text 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
DİADate 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ç Tarih alanının değerini okur
📥 Parametre Yok
📤 Dönüş String değer
deger = diaDate_1.getValue() print(deger) # Çıktı: "12.06.2025"
✏️ setValue()
🎯 Amaç Tarih alanına yeni değer atar
📥 Parametre value (String)
📤 Dönüş Yok
diaDate_1.setValue("14.08.2025")
# Sonuç: "14.08.2025" görünür
🗑️ clearValue()
🎯 Amaç Tarih alanını temizler
📥 Parametre Yok
📤 Dönüş Yok
diaDate_1.clearValue() # Sonuç: Tarih alanı boş görünür
🆔 Kimlik Yönetimi
🔍 getId()
Nesne ID'sini döndürür
nesneID = diaDate_1.getId()
print(f"ID: {nesneID}")
# Çıktı: ID: diaDate_1
🏷️ setId()
Nesne ID'sini değiştirir
diaDate_1.setId("tarih1")
# Yeni ID: tarih1
🎨 Renk Kontrolü
🖌️ Arkaplan Rengi
setBackgroundColor(color)
# Hex kod
diaDate_1.setBackgroundColor("#F0F8FF")
# Renk ismi
diaDate_1.setBackgroundColor("lightgray")
# RGB
diaDate_1.setBackgroundColor("rgb(240,248,255)")
getBackgroundColor()
renk = diaDate_1.getBackgroundColor()
print(f"Arkaplan: {renk}")
# Çıktı: Arkaplan: #F0F8FF
✒️ Yazı Rengi
setFontColor(color)
# Farklı formatlar
diaDate_1.setFontColor("#333333")
diaDate_1.setFontColor("darkblue")
diaDate_1.setFontColor("rgb(51,51,51)")
getFontColor()
yaziRengi = diaDate_1.getFontColor()
print(f"Yazı rengi: {yaziRengi}")
# Çıktı: Yazı rengi: #333333
🔤 Font Ayarları
📏 Boyut
setFontSize(size)
diaDate_1.setFontSize(14)
getFontSize()
boyut = diaDate_1.getFontSize()
print(f"Boyut: {boyut}")
# Çıktı: Boyut: 14px
🔤 Tip
setFont(fontName)
diaDate_1.setFont("Consolas")
getFont()
font = diaDate_1.getFont()
print(f"Font: {font}")
# Çıktı: Font: "Consolas"
↔️ Hizalama
setTextAlign(vAlign, hAlign)
# Ortada hizala
diaDate_1.setTextAlign("AlignVCenter", "AlignHCenter")
# Sağa hizala
diaDate_1.setTextAlign("AlignVCenter", "AlignRight")
✨ Stil Efektleri
Kalın
diaDate_1.setBold(True) # Yazı kalınlaşır diaDate_1.setBold(False) # Normal yazı
İtalik
diaDate_1.setItalic(True) # Yazı italik olur diaDate_1.setItalic(False) # Normal yazı
Alt Çizgi
diaDate_1.setUnderline(True) # Altı çizili diaDate_1.setUnderline(False) # Çizgi yok
Üst Çizgi
diaDate_1.setLineThrough(True) # Üstü çizili diaDate_1.setLineThrough(False) # Çizgi yok
🚀 Kullanım Örnekleri
🔠 Günün tarihini set edelim
diaDate_1.setBackgroundColor("red")
diaDate_1.setFontColor("#155724")
diaDate_1.setValue("12.06.2025")
🖱️ Kullanıcı Etkileşimi
🔤 Text Changed
🎯 Amaç Kullanıcı tarih alanındaki içeriği değiştirdiğinde tetiklenir.
📥 Parametre Yeni metin (str)
📥 Dönüş Yok
print("Tarih değişti:", newDate)
↩️ 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ç Tarih alanına odaklandığında tetiklenir.
📥 Parametre Yok
📤 Dönüş Yok
print("Alan seçildi (focus in)")
👁️ Focus Out
🎯 Amaç Tarih alanı odaktan çıktığında tetiklenir.
📥 Parametre Yok
📥 Dönüş Yok
print("Alan odaktan çıktı (focus out)")