|
TextArea bileşeni, yerel ActionScript TextField nesnesi için bir sözcük kaydırıcıdır. Metni görüntülemek ve
editable
özelliği
true
olduğunda metin girdisi almak için de TextArea bileşenini kullanabilirsiniz.
wordWrap
özelliği
true
değerine ayarlanırsa, bileşen birden çok metin satırını görüntüleyebilir veya alabilir ve uzun metin satırlarını sarar.
restrict
özelliği, kullanıcının girebileceği karakterleri kısıtlamanıza olanak sağlarken,
maxChars
öğesi de kullanıcının girebileceği maksimum karakter sayısı belirtmenize olanak sağlar. Metin, metin alanının yatay ve dikey sınırlarını aşarsa, kaydırma çubuklarının ilişkilendirilmiş özellikleri (
horizontalScrollPolicy
ve
verticalScrollPolicy
)
off
olarak ayarlanmadığı sürece, otomatik olarak yatay ve dikey kaydırma çubukları görüntülenir.
Birden çok metin alanına ihtiyaç duyduğunuz her yerde bir TextArea bileşeni kullanabilirsiniz. Örneğin, bir formda yorum alanı olarak TextArea bileşenini kullanabilirsiniz. Kullanıcı sekmenin seçimini kaldırarak alandan çıktığında alanın boş olup olmadığını kontrol eden bir dinleyici ayarlayabilirsiniz. Dinleyici, alana bir yorumun girilmesi gerektiğini belirten bir hata mesajı görüntüleyebilir.
Tek satırlık bir metin alanına ihtiyacınız varsa TextInput bileşenini kullanın.
TextArea örneğinde görüntülenen metnin stilini değiştirmek için,
setStyle()
yöntemini kullanarak
textFormat
stilini ayarlayabilirsiniz. Ayrıca ActionScript'te
htmlText
özelliğini kullanarak TextArea bileşenini HTML ile biçimlendirebilir ve metni yıldız işaretleriyle maskelemek için
displayAsPassword
özelliğini
true
değerine ayarlayabilirsiniz.
condenseWhite
özelliğini
true
değerine ayarlarsanız, Flash boşluklardan, satır kesmelerinden, vb'den kaynaklanan fazladan beyaz alanı kaldırır. Denetimde önceden yer alan metin üzerinde herhangi bir etkisi yoktur.
TextArea bileşeniyle kullanıcı etkileşimi
TextArea bileşeni, bir uygulamada etkinleştirilebilir veya devre dışı bırakılabilir. Devre dışı durumunda fare veya klavye girdisi alamaz. Etkinleştirildiğinde, ActionScript TextField nesnesiyle aynı odak, seçim ve gezinme kurallarını izler. TextArea örneği odağı aldığında, şu tuşları kullanarak odağı denetleyebilirsiniz:
|
Anahtar
|
Açıklama
|
|
Ok tuşları
|
Metin düzenlenebilir durumdaysa, metin içinde ekleme noktasını yukarı, aşağı, sola veya sağa taşır.
|
|
Sayfa Aşağı
|
Metin düzenlenebilir durumdaysa, ekleme noktasını metnin sonuna taşır.
|
|
Sayfa Yukarı
|
Metin düzenlenebilir durumdaysa, ekleme noktasını metnin başına taşır.
|
|
Üst Karakter+Sekme
|
Sekme döngüsünde odağı bir önceki nesneye taşır.
|
|
Sekme
|
Sekme döngüsünde odağı bir sonraki nesneye taşır.
|
Odağı kontrol etmeyle ilgili daha fazla bilgi için,
Adobe® Flash® Professional CS5 için ActionScript® 3.0 Başvurusu
ve
FocusManager ile çalışma
bölümündeki FocusManager sınıfına bakın.
TextArea bileşeni parametreleri
Özellik denetçisinde ya da Bileşen denetçisinde her TextArea bileşeni örneği için şu yönetim parametrelerini ayarlayabilirsiniz:
condenseWhite
,
düzenlenebilir
,
hortizontalScrollPolicy
,
maxChars
,
restrict
,
text
,
verticalScrollPolicy
ve
wordwrap
. Bu parametrelerin her biri, aynı adda, karşılık gelen ActionScript özelliğine sahiptir. Bu parametrelerin olası değerleriyle ilgili bilgi için,
Adobe® Flash® Professional CS5 için ActionScript® 3.0 Başvurusu
bölümündeki TextArea sınıfına bakın.
Her bir TextArea örneğinin canlı önizlemesi, geliştirme sırasında Özellik denetçisinde veya Bileşen denetçisinde parametrelere yapılan değişiklikleri yansıtır. Kaydırma çubuğu gerekiyorsa, canlı önizlemede görüntülenir ancak çalışmaz. Metin canlı önizlemede seçilemez ve Sahne Alanı'nda bileşen örneğine metin giremezsiniz.
Bunları ve TextArea bileşeninin ek seçeneklerini denetlemek için TextArea bileşeninin özelliklerini, yöntemlerini ve olaylarını kullanarak ActionScript yazabilirsiniz. Daha fazla bilgi için,
Adobe® Flash® Professional CS5 için ActionScript® 3.0 Başvurusu
bölümündeki TextArea sınıfına bakın.
TextArea bileşeniyle uygulama oluşturma
Aşağıdaki prosedür, geliştirme sırasında bir uygulamaya nasıl TextArea bileşeni ekleneceğini açıklamaktadır. Bu örnek, TextArea öğesinde, arabirimin farklı bir bölümüne odağı vermeden önce kullanıcının metin alanına bir şeyler yazdığını doğrulayan
focusOut
olay işleyicisini ayarlar.
-
Yeni bir Flash belgesi (ActionScript 3.0) oluşturun.
-
TextArea bileşenini Bileşenler panelinden Sahne Alanı'na sürükleyin ve bu bileşene
aTa
örnek adını verin. Parametrelerini varsayılan ayarlarında bırakın.
-
İkinci bir TextArea bileşenini Bileşenler panelinden Sahne Alanı'na sürükleyip birinci TextArea öğesinin aşağısına yerleştirin ve bu bileşene
bTa
örnek adını verin. Parametrelerini varsayılan ayarlarında bırakın.
-
Eylemler panelini açın, ana Zaman Çizelgesi'nde Kare 1'i seçin ve şu ActionScript kodunu girin:
import flash.events.FocusEvent;
aTa.restrict = "a-z,'\" \"";
aTa.addEventListener(Event.CHANGE,changeHandler);
aTa.addEventListener(FocusEvent.KEY_FOCUS_CHANGE, k_m_fHandler);
aTa.addEventListener(FocusEvent.MOUSE_FOCUS_CHANGE, k_m_fHandler);
function changeHandler(ch_evt:Event):void {
bTa.text = aTa.text;
}
function k_m_fHandler(kmf_event:FocusEvent):void {
kmf_event.preventDefault();
}
Bu örnek,
aTa
metin alanına girebileceğiniz karakterleri küçük harfli karakterler, virgül, kesme işareti ve boşluklarla sınırlar. Ayrıca
aTa
metin alanında da
change
,
KEY_FOCUS_CHANGE
ve
MOUSE_FOCUS_CHANGE
olaylarını ayarlar.
changeHandler()
işlevi, her bir
change
olayında
aTa.text
öğesini
bTa.text
aTa
olarak ayarlayarak metin alanına girebileceğiniz metnin otomatik olarak
bTa
metin alanında görüntülenmesini sağlar.
KEY_FOCUS_CHANGE
ve
MOUSE_FOCUS_CHANGE
olaylarının
k_m_fHandler()
işlevi, herhangi bir metin girmeden bir sonraki alana geçmeniz için Sekme tuşuna basmanızı önler. Varsayılan davranışı önleyerek bunu yapar.
-
Kontrol Et > Filmi Test Et'i seçin.
Herhangi bir metin girmeden odağı ikinci metin alanına taşımak için Sekme tuşuna basarsanız, bir hata mesajı görmeniz ve odağın birinci metin alanına geri dönmesi gerekir. Birinci metin alanına metin girdiğinizde, bu metnin ikinci metin alanında yinelendiğini görürsünüz.
ActionScript kullanarak TextArea örneği oluşturma
Aşağıdaki örnek, ActionScript ile TextArea bileşeni oluşturur. Bu örnek, beyaz alanı sıkıştırmak için
condenseWhite
özelliğini
true
değerine ayarlar ve HTML metin biçimlendirme niteliklerinden yararlanmak için
htmlText
özelliğine metin atar.
-
Yeni bir Flash (ActionScript 3.0) belgesi oluşturun.
-
TextArea bileşenini Kütüphane paneline sürükleyin.
-
Eylemler panelini açın, ana Zaman Çizelgesi'nde Kare 1'i seçin ve şu ActionScript kodunu girin:
import fl.controls.TextArea;
var aTa:TextArea = new TextArea();
aTa.move(100,100);
aTa.setSize(200, 200);
aTa.condenseWhite = true;
aTa.htmlText = '<b>Lorem ipsum dolor</b> sit amet, consectetuer adipiscing elit. <u>Vivamus quis nisl vel tortor nonummy vulputate.</u> Quisque sit amet eros sed purus euismod tempor. Morbi tempor. <font color="#FF0000">Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos hymenaeos.</font> Curabitur diam. Suspendisse at purus in ipsum volutpat viverra. Nulla pellentesque libero id libero.';
addChild(aTa);
Bu örnek, bir metin bloğuna HTML kalın ve alt çizgi niteliklerini uygulamak ve bu metin bloğunu
a_ta
metin alanında görüntülemek için
htmlText
özelliğini kullanır. Bu örnek aynı zamanda metin bloğu içinde beyaz alanı sıkıştırmak için
condenseWhite
özelliğini
true
değerine ayarlar.
setSize()
yöntemi, metin alanının yükseklik ve genişliğini ayarlarken,
move()
yöntemi de konumunu ayarlar.
addChild()
yöntemi, TextArea örneğini Sahne Alanı'na ekler.
-
Kontrol Et > Filmi Test Et'i seçin.
|
|
|