Uzun Metin (DİATextarea) [DİA Doc]

Uzun Metin (DİATextarea)

DİATextarea, formlarda kullanıcıların uzun metin girişi yapabilmesi için kullanılan düzenlenebilir bir alan (input) nesnesidir. Bu nesne sayesinde kullanıcıdan veri toplanabilir, girilen metin üzerinde doğrulama yapılabilir ve formun tasarımına uygun görsel ayarlamalar yapılabilir. Arka plan rengi, yazı rengi, font ve hizalama gibi görsel özelliklerinin yanında; ipucu, placeholder ve aksiyon tanımlamaları gibi etkileşimsel özellikler de destekler.

Adı	Default	Değerleri	Amacı
🆔 Nesne ID	diaTextarea_1	Örn:notlar	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 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.
💬 Yardımcı Metin (Placeholder)	-	Serbest metin	Alan boşken görünen açıklama yazısıdır. Kullanıcıya hangi bilgiyi girmesi gerektiğini anlatır.
💬 İ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 (Focus In)	-	Olay bağlanabilir	Alan seçildiğinde tetiklenir.
🖱️ Aksiyon (Focus Out)	-	Olay bağlanabilir	Alan odaktan çıktığında tetiklenir.

DİATextarea 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.

🎯 Amaç Text alanının değerini okur

📥 Parametre Yok

📤 Dönüş String değer

deger = diaTextarea_1.getValue()
print(deger)
# Çıktı: "Kullanıcı girişi"

🎯 Amaç Text alanına yeni değer atar

📥 Parametre value (String)

📤 Dönüş Yok

diaTextarea_1.setValue("Yeni metin")
# Sonuç: "Yeni metin" görünür

🎯 Amaç Text alanını temizler

📥 Parametre Yok

📤 Dönüş Yok

diaTextarea_1.clearValue()
# Sonuç: Text alanı boş görünür

Nesne ID'sini döndürür

nesneID = diaTextarea_1.getId()
print(f"ID: {nesneID}")
# Çıktı: ID: diaTextarea_1

Nesne ID'sini değiştirir

diaTextarea_1.setId("kullaniciAdiText")
# Yeni ID: kullaniciAdiText

🖌️ Arkaplan Rengi

setBackgroundColor(color)

# Hex kod
diaTextarea_1.setBackgroundColor("#F0F8FF")

# Renk ismi
diaTextarea_1.setBackgroundColor("lightgray")

# RGB
diaTextarea_1.setBackgroundColor("rgb(240,248,255)")

getBackgroundColor()

renk = diaTextarea_1.getBackgroundColor()
print(f"Arkaplan: {renk}")
# Çıktı: Arkaplan: #F0F8FF

✒️ Yazı Rengi

setFontColor(color)

# Farklı formatlar
diaTextarea_1.setFontColor("#333333")
diaTextarea_1.setFontColor("darkblue")
diaTextarea_1.setFontColor("rgb(51,51,51)")

getFontColor()

yaziRengi = diaTextarea_1.getFontColor()
print(f"Yazı rengi: {yaziRengi}")
# Çıktı: Yazı rengi: #333333

setFontSize(size)

diaTextarea_1.setFontSize(14)

getFontSize()

boyut = diaTextarea_1.getFontSize()
print(f"Boyut: {boyut}")
# Çıktı: Boyut: 14px

setFont(fontName)

diaTextarea_1.setFont("Consolas")

getFont()

font = diaTextarea_1.getFont()
print(f"Font: {font}")
# Çıktı: Font: "Consolas"

setTextAlign(vAlign, hAlign)

# Ortada hizala
diaTextarea_1.setTextAlign("AlignVCenter", "AlignHCenter")

# Sağa hizala
diaTextarea_1.setTextAlign("AlignVCenter", "AlignRight")

Kalın

diaTextarea_1.setBold(True)
# Yazı kalınlaşır

diaTextarea_1.setBold(False)
# Normal yazı

İtalik

diaTextarea_1.setItalic(True)
# Yazı italik olur

diaTextarea_1.setItalic(False)
# Normal yazı

Alt Çizgi

diaTextarea_1.setUnderline(True)
# Altı çizili

diaTextarea_1.setUnderline(False)
# Çizgi yok

Üst Çizgi

diaTextarea_1.setLineThrough(True)
# Üstü çizili

diaTextarea_1.setLineThrough(False)
# Çizgi yok

🔠 Açıklama Girişi Alanı

diaText_2.enableMultiLine() 
diaText_2.setRows(5) 
diaText_2.setPlaceholder("Açıklamanızı buraya yazın...")
 diaText_2.setBackgroundColor("#E9F7EF") 
diaText_2.setFont("Segoe UI") 
diaText_2.setFontSize(12)

🔤 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)

🎯 Amaç Metin alanı odaklandığında tetiklenir.

📥 Parametre Yok

📤 Dönüş Yok

 print("Alan seçildi (focus in)")

🎯 Amaç Metin alanı odaktan çıktığında tetiklenir.

📥 Parametre Yok

📥 Dönüş Yok

 print("Alan odaktan çıktı (focus out)")