TextInput bileşenini kullanma

TextInput bileşeni, yerel ActionScript TextField nesnesi için bir sözcük kaydırıcı olan tek satırlı bir metin bileşenidir. Çok satırlı bir metin bileşeni gerekiyorsa, TextArea bileşenini kullanın. Örneğin, bir formda şifre alanı olarak TextInput bileşenini kullanabilirsiniz. Kullanıcı sekmenin seçimini kaldırarak alandan çıktığında alanda yeterince karakter olup olmadığını kontrol eden bir dinleyici ayarlayabilirsiniz. Bu dinleyici, uygun sayıda karakter girilmesi gerektiğini belirten bir hata mesajı görüntüleyebilir.

TextInput örneğinde görüntülenen metnin stilini değiştirmek için, setStyle() yöntemini kullanarak textFormat özelliğini ayarlayabilirsiniz. TextInput bileşeni, HTML ile veya metni gizleyen bir şifre alanı olarak da biçimlendirilebilir.

TextInput bileşeniyle kullanıcı etkileşimi

TextInput 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. Bir TextInput örneği odağa sahip olduğunda, odağı denetlemek için şu tuşları kullanabilirsiniz:

Anahtar

Açıklama

Ok tuşları

Ekleme noktasını bir karakter sola veya sağa taşır.

Üst Karakter+Sekme

Odağı bir önceki nesneye taşır.

Sekme

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.

Her bir TextInput ö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. Metin canlı önizlemede seçilemez ve Sahne Alanı'nda bileşen örneğine metin giremezsiniz.

Bir uygulamaya TextInput bileşenini eklediğinizde, bileşeni ekran okuyucusu için erişilebilir duruma getirmek için Erişilebilirlik panelini kullanabilirsiniz.

TextInput bileşeni parametreleri

Özellik denetçisinde veya Bileşen denetçisinde her TextInput bileşeni örneği için şu yönetim parametrelerini ayarlayabilirsiniz: editable , displayAsPassword , maxChars , restrict ve text . 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 TextInput sınıfına bakın.

Bunları ve TextInput bileşeninin ek seçeneklerini denetlemek için TextInput 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 TextInput sınıfına bakın.

TextInput bileşeniyle uygulama oluşturma

Aşağıdaki prosedür, geliştirme sırasında bir uygulamaya nasıl TextInput bileşeni ekleneceğini açıklamaktadır. Bu örnek, şifre almak ve şifreyi onaylamak için iki TextInput alanı kullanır. Bu örnek, minimum sekiz karakter girildiğini ve iki alandaki metnin eşleştiğini görmek için bir olay dinleyicisi kullanır.

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

  2. Bir Label bileşenini Bileşenler panelinden Sahne Alanı'na sürükleyin ve Özellik denetçisinde bileşene şu değerleri verin:

    • pwdLabel örnek adını girin.

    • W için 100 değerini girin.

    • X için 50 değerini girin.

    • Y için 150 değerini girin.

    • Parametreler bölümünde, metin parametresi için bir Password: değeri girin.

  3. İkinci bir Label bileşenini Bileşenler panelinden Sahne Alanı'na sürükleyin ve bileşene şu değerleri verin:

    • confirmLabel örnek adını girin.

    • W için 100 değerini girin.

    • X için 50 değerini girin.

    • Y için 200 değerini girin.

    • Parametreler bölümünde, metin parametresi için bir Confirm Password: değeri girin.

  4. Bir TextInput bileşenini Bileşenler panelinden Sahne Alanı'na sürükleyin ve bileşene şu değerleri verin:

    • pwdTi örnek adını girin.

    • W için 150 değerini girin.

    • X için 190 değerini girin.

    • Y için 150 değerini girin.

    • Parametreler bölümünde, displayAsPassword parametresinin değerini çift tıklatın ve true seçeneğini belirleyin. Böylece metin alanına girilen değerin yıldız işaretleriyle maskelenmesi sağlanır.

  5. İkinci bir TextInput bileşenini Bileşenler panelinden Sahne Alanı'na sürükleyin ve bileşene şu değerleri verin:

    • confirmTi örnek adını girin.

    • W için 150 değerini girin.

    • X için 190 değerini girin.

    • Y için 200 değerini girin.

    • Parametreler bölümünde, displayA s Password parametresinin değerini çift tıklatın ve true seçeneğini belirleyin. Böylece metin alanına girilen değerin yıldız işaretleriyle maskelenmesi sağlanır.

  6. Eylemler panelini açın, ana Zaman Çizelgesi'nde Kare 1'i seçin ve şu ActionScript kodunu girin: 

    function tiListener(evt_obj:Event){ 
if(confirmTi.text != pwdTi.text || confirmTi.length < 8) 
{ 
        trace("Password is incorrect. Please reenter it."); 
}  
else { 
        trace("Your password is: " + confirmTi.text); 
} 
} 
confirmTi.addEventListener("enter", tiListener);

    Bu kod, confirmTi adındaki TextInput örneğinde bir enter olay işleyicisi ayarlar. İki şifre eşleşmezse veya kullanıcı sekizden az karakter girerse, örnek, “Şifre yanlış. Lütfen yeniden girin.” mesajını görüntüler. Şifreler en az sekiz karakterse ve birbiriyle eşleşiyorsa, örnek, Çıktı panelinde girilen değeri görüntüler.

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

ActionScript kullanarak TextInput örneği oluşturma

Aşağıdaki örnek, ActionScript ile TextInput bileşeni oluşturur. Bu örnek ayrıca kullanıcının adını girmesini istemek için kullanılan bir Label öğesi de oluşturur. Örnek, bileşenin restrict özelliğini yalnızca büyük harf ve küçük harf, nokta ve boşluğa izin verecek şekilde ayarlar. Ayrıca, hem Label hem de TextInput bileşeninde metni biçimlendirmek için kullanılan bir TextFormat nesnesi de oluşturur.

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

  2. TextInput bileşenini Bileşenler panelinden Kütüphane paneline sürükleyin.

  3. Label bileşenini Bileşenler panelinden Kütüphane paneline sürükleyin.

  4. Eylemler panelini açın, ana Zaman Çizelgesi'nde Kare 1'i seçin ve şu ActionScript kodunu girin: 

    import fl.controls.Label; 
import fl.controls.TextInput; 
 
var nameLabel:Label = new Label(); 
var nameTi:TextInput = new TextInput(); 
var tf:TextFormat = new TextFormat(); 
 
addChild(nameLabel); 
addChild(nameTi); 
 
nameTi.restrict = "A-Z .a-z"; 
 
tf.font = "Georgia"; 
tf.color = 0x0000CC; 
tf.size = 16; 
 
nameLabel.text = "Name: " ; 
nameLabel.setSize(50, 25); 
nameLabel.move(100,100); 
nameLabel.setStyle("textFormat", tf); 
nameTi.move(160, 100); 
nameTi.setSize(200, 25); 
nameTi.setStyle("textFormat", tf);

  5. Uygulamayı çalıştırmak için Kontrol Et > Filmi Test Et'i seçin.