Saat (DİAtime)
DİAtime, formlarda kullanıcıların saat 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 | diaTime_1 | Örn: baslangicsaati | 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. |
| 🎭 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İATime 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ç Saat alanının değerini okur
📥 Parametre Yok
📤 Dönüş String değer
deger = diaTime_1.getValue() print(deger) # Çıktı: "12:13:23"
✏️ setValue()
🎯 Amaç Saar alanına yeni değer atar
📥 Parametre value (String)
📤 Dönüş Yok
diaTime_1.setValue("12:13:13")
# Sonuç: 12:13:13
🗑️ clearValue()
🎯 Amaç Text alanını temizler
📥 Parametre Yok
📤 Dönüş Yok
diaTime_1.clearValue() # Sonuç: Saat alanı boş görünür
🆔 Kimlik Yönetimi
🔍 getId()
Nesne ID'sini döndürür
nesneID = diaTime_1.getId()
print(f"ID: {nesneID}")
# Çıktı: ID: diaTime_1
🏷️ setId()
Nesne ID'sini değiştirir
diaTime_1.setId("saat2")
# Yeni ID: saat2
🎨 Renk Kontrolü
🖌️ Arkaplan Rengi
setBackgroundColor(color)
# Hex kod
diaTime_1.setBackgroundColor("#F0F8FF")
# Renk ismi
diaTime_1.setBackgroundColor("lightgray")
# RGB
diaTime_1.setBackgroundColor("rgb(240,248,255)")
getBackgroundColor()
renk = diaTime_1.getBackgroundColor()
print(f"Arkaplan: {renk}")
# Çıktı: Arkaplan: #F0F8FF
✒️ Yazı Rengi
setFontColor(color)
# Farklı formatlar
diaTime_1.setFontColor("#333333")
diaTime_1.setFontColor("darkblue")
diaTime_1.setFontColor("rgb(51,51,51)")
getFontColor()
yaziRengi = diaTime_1.getFontColor()
print(f"Yazı rengi: {yaziRengi}")
# Çıktı: Yazı rengi: #333333
🔤 Font Ayarları
📏 Boyut
setFontSize(size)
diaTime_1.setFontSize(14)
getFontSize()
boyut = diaTime_1.getFontSize()
print(f"Boyut: {boyut}")
# Çıktı: Boyut: 14px
🔤 Tip
setFont(fontName)
diaTime_1.setFont("Consolas")
getFont()
font = diaTime_1.getFont()
print(f"Font: {font}")
# Çıktı: Font: "Consolas"
↔️ Hizalama
setTextAlign(vAlign, hAlign)
# Ortada hizala
diaTime_1.setTextAlign("AlignVCenter", "AlignHCenter")
# Sağa hizala
diaTime_1.setTextAlign("AlignVCenter", "AlignRight")
✨ Stil Efektleri
Kalın
diaTime_1.setBold(True) # Yazı kalınlaşır diaTime_1.setBold(False) # Normal yazı
İtalik
diaTime_1.setItalic(True) # Yazı italik olur diaTime_1.setItalic(False) # Normal yazı
Alt Çizgi
diaTime_1.setUnderline(True) # Altı çizili diaTime_1.setUnderline(False) # Çizgi yok
Üst Çizgi
diaTime_1.setLineThrough(True) # Üstü çizili diaTime_1.setLineThrough(False) # Çizgi yok
🚀 Kullanım Örnekleri
🔠 Saati set edelim diaTime_1.setBackgroundColor(“red”) diaTime_1.setFontColor(“#155724”) diaTime_1.setValue(“12.34:00”)
🖱️ Kullanıcı Etkileşimi
🔤 Text Changed
🎯 Amaç Kullanıcı saat alanındaki içeriği değiştirdiğinde tetiklenir.
📥 Parametre Yeni metin (str)
📥 Dönüş Yok
print("Saat değişti:", newText)
↩️ 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("Saat 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)")