List bileşenini kullanma

List bileşeni kaydırılabilir bir tekli veya çoklu seçim listesi kutusudur. Liste, diğer bileşenler dahil olmak üzere görüntüleme grafiklerini de görüntüleyebilir. Etiketler veya veri parametresi alanlarını tıklattığınızda görüntülenen Değerler iletişim kutusunu kullanarak listede görüntülenen öğeleri eklersiniz. Listeye öğe eklemek için List.addItem() ve List.addItemAt() yöntemlerini de kullanabilirsiniz.

List bileşeni, 0 dizinine sahip öğenin en üstte görüntülenen öğe olduğu sıfır temelli dizini kullanır. List sınıfı yöntemlerini ve özelliklerini kullanarak liste öğeleri eklendiğinde, kaldırıldığında veya değiştirildiğinde liste öğesinin dizinini belirtmeniz gerekebilir.

List bileşeniyle kullanıcı etkileşimi

Kullanıcıların tek veya çoklu seçim yapabileceği şekilde bir listeyi ayarlayabilirsiniz. Örneğin, e-ticaret web sitesini ziyaret eden bir kullanıcının hangi öğeyi satın alacağını seçmesi gerekir. Kullanıcının kaydırarak gezindiği ve öğeleri tıklayarak seçtiği listede 30 öğe vardır.

Ayrıca kullanıcıya daha fazla bilgi görüntüleyebilmeniz için özel film kliplerini satırlar olarak kullanan bir List öğesi de tasarlayabilirsiniz. Örneğin, bir e-posta uygulamasında her posta kutusu bir List bileşeni olabilir ve her satır öncelik ve durumunu belirten simgeler içerebilir.

Üzerini tıklattığınızda veya üzerine bastığınızda List öğesi odağı alır ve bunu denetlemek için şu tuşları kullanabilirsiniz:

Anahtar

Açıklama

Alfasayısal tuşlar

Etiketinde ilk karakteri Key.getAscii() olan bir sonraki öğeye atlar.

Kontrol Et

Birden çok bitişik seçime veya birden çok bitişik seçimin kaldırılmasına olanak sağlayan aç/kapa tuşu.

Aşağı Ok

Seçimi bir öğe aşağı taşır.

Home

Seçimi listenin en üstüne taşır.

Sayfa Aşağı

Seçimi bir sayfa aşağı taşır.

Sayfa Yukarı

Seçimi bir sayfa yukarı taşır.

Üst Karakter

Bitişik seçime olanak sağlar.

Yukarı Ok

Seçimi bir öğe yukarı taşır.

Not: Kaydırma boyutlarının satır değil piksel cinsinden olduğunu unutmayın.
Not: Sayfa Yukarı ve Sayfa Aşağı tuşları tarafından kullanılan sayfa boyutu, görüntüye sığan öğe sayısından bir tane azdır. Örneğin, on satırlık açılır listede sayfa aşağı inildiğinde, her sayfada bir öğe örtüşerek 0-9, 9-18, 18-27, vb. öğeleri gösterilir.

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 IFocusManager arabirimine ve FocusManager sınıfına bakın.

Her bir List ö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.

Bir uygulamaya List bileşenini eklediğinizde, aşağıdaki ActionScript kodu satırlarını ekleyerek bu bileşeni bir ekran okuyucusu için erişilebilir duruma getirebilirsiniz:

import fl.accessibility.ListAccImpl; 
 
ListAccImpl.enableAccessibility();

Bileşenin kaç tane örneğe sahip olduğuna bakılmaksızın, bir bileşenin erişilebilirliğini yalnızca bir defa etkinleştirebilirsiniz. Daha fazla bilgi için bkz. Bölüm 18, “Erişilebilir İçerik Oluşturma,” Flash Uygulamasını Kullanma .

List bileşeni parametreler

Her List bileşeni örneği için Özellik denetçisinde ve Bileşen denetçisinde şu parametreleri ayarlayabilirsiniz: allowMultipleSelection , dataProvider, horizontalLineScrollSize, horizontalPageScrollSize, horizontalScrollPolicy, multipleSelection, verticalLineScrollSize, verticalPageScrollSize ve verticalScrollPolicy . 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 List sınıfına bakın. dataProvider parametresini kullanma hakkında bilgi almak için, bkz. dataProvider parametresini kullanma .

List bileşeniyle uygulama oluşturma

Aşağıdaki örnekler, geliştirme sırasında bir uygulamaya nasıl List bileşeni ekleneceğini açıklamaktadır.

Uygulamaya basit bir List bileşeni ekleme

Bu örnekte List öğesi, araba modellerini ve fiyatların yer aldığı veri alanlarını tanımlayan etiketlerden oluşur.

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

  2. List bileşenini Bileşenler panelinden Sahne Alanı'na sürükleyin.

  3. Özellik denetçisinde şunları yapın:

    • aList örnek adını girin.

    • W (genişlik) öğesine 200 değerini atayın.

  4. aList öğesinin aşağısında bir metin alanı oluşturmak için Metin aracını kullanın ve bu metin alanına aTf örnek adını verin.

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

    import fl.controls.List; 
    import flash.text.TextField; 
     
    aTf.type = TextFieldType.DYNAMIC; 
    aTf.border = false; 
     
    // Create these items in the Property inspector when data and label 
    // parameters are available. 
    aList.addItem({label:"1956 Chevy (Cherry Red)", data:35000}); 
    aList.addItem({label:"1966 Mustang (Classic)", data:27000}); 
    aList.addItem({label:"1976 Volvo (Xcllnt Cond)", data:17000}); 
    aList.allowMultipleSelection = true; 
     
    aList.addEventListener(Event.CHANGE, showData); 
     
    function showData(event:Event) { 
        aTf.text = "This car is priced at: $" + event.target.selectedItem.data; 
    }

    Bu kod, aList öğesini üç öğeyle doldurmak için addItem() yöntemini kullanır ve öğelerin her birine listede görüntülenen bir label değeri ve bir data değeri atar. List öğesinde bir öğeyi seçtiğinizde, olay dinleyicisi, seçili öğe için data değerini görüntüleyen showData() işlevini çağırır.

  6. Bu uygulamayı derlemek ve çalıştırmak için Kontrol Et > Filmi Test Et seçeneklerini belirleyin.

Liste örneğini veri sağlayıcısıyla doldurma

Bu örnek, araba modellerinin ve fiyatlarının bir List öğesini oluşturur. Ancak List öğesini doldurmak için addItem() yöntemi yerine bir veri sağlayıcısını kullanır.

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

  2. List bileşenini Bileşenler panelinden Sahne Alanı'na sürükleyin.

  3. Özellik denetçisinde şunları yapın:

    • aList örnek adını girin.

    • W (genişlik) öğesine 200 değerini atayın.

  4. aList öğesinin aşağısında bir metin alanı oluşturmak için Metin aracını kullanın ve bu metin alanına aTf örnek adını verin.

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

    import fl.controls.List; 
    import fl.data.DataProvider; 
    import flash.text.TextField; 
     
    aTf.type = TextFieldType.DYNAMIC; 
    aTf.border = false; 
     
    var cars:Array = [ 
    {label:"1956 Chevy (Cherry Red)", data:35000}, 
    {label:"1966 Mustang (Classic)", data:27000}, 
    {label:"1976 Volvo (Xcllnt Cond)", data:17000}, 
    ]; 
    aList.dataProvider = new DataProvider(cars); 
    aList.allowMultipleSelection = true; 
     
    aList.addEventListener(Event.CHANGE, showData); 
     
    function showData(event:Event) { 
        aTf.text = "This car is priced at: $" + event.target.selectedItem.data; 
    }
  6. Öğelerin yer aldığı List öğesini görmek için Kontrol Et > Filmi Test Et seçeneklerini belirleyin.

MovieClip örneğini denetlemek için List bileşenini kullanma

Aşağıdaki örnek, renk adlarının bir List öğesini oluşturur ve bir renk seçtiğinizde o rengi MovieClip öğesine uygular.

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

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

    • Örnek adı için aList girin.

    • H değeri için 60 girin.

    • X değeri için 100 girin.

    • Y değeri için 150 girin.

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

    aList.addItem({label:"Blue", data:0x0000CC}); 
    aList.addItem({label:"Green", data:0x00CC00}); 
    aList.addItem({label:"Yellow", data:0xFFFF00}); 
    aList.addItem({label:"Orange", data:0xFF6600}); 
    aList.addItem({label:"Black", data:0x000000}); 
     
    var aBox:MovieClip = new MovieClip(); 
    addChild(aBox); 
     
    aList.addEventListener(Event.CHANGE, changeHandler); 
    function changeHandler(event:Event) { 
        drawBox(aBox, event.target.selectedItem.data); 
    }; 
     
    function drawBox(box:MovieClip,color:uint):void { 
                box.graphics.beginFill(color, 1.0); 
                box.graphics.drawRect(225, 150, 100, 100); 
                box.graphics.endFill();         
    }
  4. Uygulamayı çalıştırmak için Kontrol Et > Filmi Test Et'i seçin.

  5. List öğesindeki renkleri MovieClip öğesinde görüntülenmesi için tıklatın.

ActionScript kullanarak List bileşen örneği oluşturma

Bu örnek ActionScript kullanarak basit bir liste oluşturur ve addItem() yöntemi ile doldurur.

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

  2. List bileşenini Bileşenler panelinden 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.List; 
     
    var aList:List = new List(); 
    aList.addItem({label:"One", data:1}); 
    aList.addItem({label:"Two", data:2}); 
    aList.addItem({label:"Three", data:3}); 
    aList.addItem({label:"Four", data:4}); 
    aList.addItem({label:"Five", data:5}); 
    aList.setSize(60, 40); 
    aList.move(200,200); 
    addChild(aList); 
    aList.addEventListener(Event.CHANGE, changeHandler); 
    function changeHandler(event:Event):void { 
        trace(event.target.selectedItem.data); 
    }
  4. Uygulamayı çalıştırmak için Kontrol Et > Filmi Test Et'i seçin.