TextArea bileşenini kullanma

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.

  1. Yeni bir Flash belgesi (ActionScript 3.0) oluşturun.

  2. 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.

  3. İ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.

  4. 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.

  5. 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.

  1. Yeni bir Flash (ActionScript 3.0) belgesi oluşturun.

  2. TextArea bileşenini Kütüphane paneline sürükleyin.

  3. 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.

  4. Kontrol Et > Filmi Test Et'i seçin.