E-posta (DİAMailText)
DİAMailText, formlarda kullanıcıların e-posta tanımının yapılabilmesini sağlayan bir input nesnesidir. DİAText sınıfısından türetilen bu nesne e-posta yazım kurallarına göre özelleştirilmiştir.
Özellikler
| Adı | Default | Değerleri | Amacı |
|---|---|---|---|
| 🆔 Nesne ID | diaMailText_1 | Örn: carikartkodu | 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. |
| 👁️ 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. |
| 🔒 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 (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İAMailText 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ç Text alanının değerini okur
📥 Parametre Yok
📤 Dönüş String değer
deger = diaMailText_1.getValue() print(deger) # Çıktı: "arge@dia.com.tr"
✏️ setValue()
🎯 Amaç Text alanına yeni değer atar
📥 Parametre value (String)
📤 Dönüş Yok
diaMailText_1.setValue("arge@dia.com.tr")
# Sonuç: "arge@dia.com.tr" görünür
🗑️ clearValue()
🎯 Amaç Text alanını temizler
📥 Parametre Yok
📤 Dönüş Yok
diaMailText_1.clearValue() # Sonuç: Text alanı boş görünür
🆔 Kimlik Yönetimi
🔍 getId()
Nesne ID'sini döndürür
nesneID = diaMailText_1.getId()
print(f"ID: {nesneID}")
# Çıktı: ID: diaMailText_1
🏷️ setId()
Nesne ID'sini değiştirir
diaMailText_1.setId("kullaniciAdiText")
# Yeni ID: kullaniciAdiText
🎨 Renk Kontrolü
🖌️ Arkaplan Rengi
setBackgroundColor(color)
# Hex kod
diaMailText_1.setBackgroundColor("#F0F8FF")
# Renk ismi
diaMailText_1.setBackgroundColor("lightgray")
# RGB
diaMailText_1.setBackgroundColor("rgb(240,248,255)")
getBackgroundColor()
renk = diaMailText_1.getBackgroundColor()
print(f"Arkaplan: {renk}")
# Çıktı: Arkaplan: #F0F8FF
✒️ Yazı Rengi
setFontColor(color)
# Farklı formatlar
diaMailText_1.setFontColor("#333333")
diaMailText_1.setFontColor("darkblue")
diaMailText_1.setFontColor("rgb(51,51,51)")
getFontColor()
yaziRengi = diaMailText_1.getFontColor()
print(f"Yazı rengi: {yaziRengi}")
# Çıktı: Yazı rengi: #333333
🔤 Font Ayarları
📏 Boyut
setFontSize(size)
diaMailText_1.setFontSize(14)
getFontSize()
boyut = diaMailText_1.getFontSize()
print(f"Boyut: {boyut}")
# Çıktı: Boyut: 14px
🔤 Tip
setFont(fontName)
diaMailText_1.setFont("Consolas")
getFont()
font = diaMailText_1.getFont()
print(f"Font: {font}")
# Çıktı: Font: "Consolas"
↔️ Hizalama
setTextAlign(vAlign, hAlign)
# Ortada hizala
diaMailText_1.setTextAlign("AlignVCenter", "AlignHCenter")
# Sağa hizala
diaMailText_1.setTextAlign("AlignVCenter", "AlignRight")
✨ Stil Efektleri
Kalın
diaMailText_1.setBold(True) # Yazı kalınlaşır diaMailText_1.setBold(False) # Normal yazı
İtalik
diaMailText_1.setItalic(True) # Yazı italik olur diaMailText_1.setItalic(False) # Normal yazı
Alt Çizgi
diaMailText_1.setUnderline(True) # Altı çizili diaMailText_1.setUnderline(False) # Çizgi yok
Üst Çizgi
diaMailText_1.setLineThrough(True) # Üstü çizili diaMailText_1.setLineThrough(False) # Çizgi yok
🚀 Kullanım Örnekleri
✉️ E-posta alanı
diaMailText_1.setBackgroundColor("#FFF3CD")
diaMailText_1.setFontColor("#856404")
diaMailText_1.setFont("Consolas")
🖱️ Kullanıcı Etkileşimi
🔤 Text Changed
🎯 Amaç Kullanıcı metin alanındaki içeriği değiştirdiğinde tetiklenir.
📥 Parametre Yeni metin (str)
📥 Dönüş Yok
print("Metin 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("Metin 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)")