TextFlow  - AS3

Bu TextFlow nesnesi için Configuration nesnesi. Configuration nesnesi, başlangıç karakter ve paragraf biçimlerini, başlangıç kap biçimini ve vurgu, bağ, odak ve kaydırma niteliklerini belirtir.

Bir Configuration nesnesi belirtmezseniz, Text Layout Framework (Metin Mizanpajı Çerçevesi), defaultConfiguration özelliği tarafından başvurulan varsayılan bir Configuration nesnesini kullanır.

İlgili API Öğeleri

Konfigürasyon belirtilmediyse, tüm yeni TextFlow nesneleri için varsayılan konfigürasyon.

İlgili API Öğeleri

Bu öğenin kaplarını yönetir.

Öğeden oluşturulan TextLine nesneleri, kabın alt öğeleri olarak görüntülenir. flowComposer, kapları yönetir ve metin düzenlendikçe, kaplara satır ekler veya kaplardan satır kaldırır. flowComposer aynı zamanda oluşturulacak genişlik ve yükseklik, kaydırmanın açık olup olmaması, vb. gibi bazı kritik nitelikleri de takip eder.

Kap ve flowComposer yakından ilgilidir. flowComposer öğesini sıfırlarsanız, kap yeni flowComposer öğesinin kabına sıfırlanır. Aynı şekilde, kap sıfırlanırsa, flowComposer, kabın yeni flowComposer öğesine sıfırlanır.

İlgili API Öğeleri

Öğe stillerinin çözümlenmesine yönelik geri çağrı işlevi. Örneğin, CSS veya adlandırılmış stiller kullanarak stil sağlamak için bunu kullanabilirsiniz.

İlgili API Öğeleri

Bu TextFlow nesnesinin oluşturma numarası. Geri alma ve yineleme işlemleri, bir işlemin geri alınmasının ve yinelenmesinin geçerli olduğunu doğrulamak için oluşturma numarasını kullanır. Oluşturma numaraları eşleşmelidir.

Her model değişikliği, oluşturma değerini artırır, böylece, oluşturma numarası değiştiğinde TextFlow modelinin değiştiğini anlarsınız.

Bu TextFlow nesnesi için TextLayoutFormat nesnesi. Bu, ana bilgisayar biçimlerinin yeniden kullanılmasına yönelik birçok en iyileştirmeye olanak sağlar. Örneğin;

        textFlowA.hostFormat = textFlowB.hostFormat
        

        format = new TextLayoutFormat()
        textFlow.hostFormat = format
        format.fontSize = 24;
        

İlgili API Öğeleri

Bu TextFlow nesnesiyle ilişkilendirilmiş InteractionManager.

Metindeki tüm seçim ve düzenlemeyi kontrol eder. TextFlow seçilebilir durumda değilse, interactionManager öğesi null değerinde olur. TextFlow öğesini düzenlenebilir duruma getirmek için, hem ISelectionManager hem de IEditManager olan bir interactionManager atayın. Salt okunur olan ve seçime olanak sağlayan bir TextFlow oluşturmak için, yalnızca ISelectionManager olan bir interactionManager atayın.

İlgili API Öğeleri

Constructor - yeni bir TextFlow örneği oluşturur.

Bir config parametresi sağlarsanız, Configuration nesnesinin içerikleri kopyalanır ve siz değişiklik yapamazsınız. Ancak configuration özelliği üzerinden konfigürasyon ayarlarına erişebilirsiniz. config parametresi null olursa, defaultConfiguration özelliği üzerinden varsayılan konfigürasyon ayarlarına erişebilirsiniz.

Configuration nesnesi, bir TextFlow öğesi üzerinde konfigüre edilebilir varsayılan niteliklerin ayarlanmasına yönelik bir mekanizma sağlar. Configuration nesnesi üzerinde değişiklik yapamasanız da, gerekirse TextFlow öğesinin ve bunun alt öğelerinin niteliklerini ayarlayarak, varsayılan nitelikleri geçersiz kılabilirsiniz.

İlgili API Öğeleri

EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. Belirli türde bir olay, aşama ve öncelik için görüntüleme listesindeki tüm düğümlere olay dinleyicilerini kaydedebilirsiniz.

Bir olay dinleyicisini başarıyla kaydettikten sonra, addEventListener() öğesine ek çağrılar yaparak önceliğini değiştiremezsiniz. Bir dinleyicinin önceliğini değiştirmek için, ilk olarak removeEventListener() öğesini çağırmanız gerekir. Daha sonra dinleyiciyi yeni öncelik seviyesiyle kaydedebilirsiniz.

Dinleyici kaydedildikten sonra, farklı bir type veya useCapture değeriyle addEventListener() öğesine yapılan çağrılar, ayrı bir dinleyici kaydının oluşturulmasıyla sonuçlanır. Örneğin ilk olarak useCapture true değerine ayarlanmış durumdayken bir dinleyiciyi kaydederseniz, dinleyici yalnızca yakalama aşaması boyunca dinleme işlemi yapar. Aynı listener nesnesini kullanarak, ancak useCapture false değerine ayarlanmış durumdayken tekrar addEventListener() öğesini çağırırsanız, iki ayrı dinleyiciniz olur: bunlardan biri yakalama aşamasında dinleme işlemi yapar, diğeri ise hedef ve köpürme aşamasında dinleme işlemi yapar.

Yalnızca hedef aşaması veya köpürme aşaması için bir olay dinleyicisini kaydedemezsiniz. Köpürme yalnızca hedef düğümün alt öğeleri için geçerli olduğundan, bu aşamalar kayıt sırasında birleştirilir.

Artık bir olay dinleyicisine ihtiyacınız olmadığında, EventDispatcher.removeEventListener() öğesini çağırarak olay dinleyicisini kaldırın, aksi takdirde bellek sorunları oluşabilir. Çöp toplayıcı, başvuruları olan nesneleri çıkarmadığından, kayıtlı olay dinleyicileri olan nesneler bellekten otomatik olarak kaldırılmaz.

Bir EventDispatcher örneği kopyalandığında, o örneğe ekli olan olay dinleyicileri kopyalanmaz. (Yeni oluşturulmuş düğümünüz için bir olay dinleyicisi gerekiyorsa, düğümü oluşturduktan sonra dinleyiciyi eklemeniz gerekir.) Ancak bir EventDispatcher örneğini taşırsanız, örneğe ekli olan olay dinleyicileri de onunla birlikte taşınır.

Bir olay düğümde işlenirken olay dinleyicisi o düğüme kaydediliyorsa, geçerli aşama sırasında olay dinleyicisi tetiklenmez ancak olay akışındaki köpürme aşaması gibi sonraki bir aşamada tetiklenebilir.

Bir olay düğümde işlenirken olay dinleyicisi o düğümden kaldırılırsa, geçerli eylemler tetiklenmeye devam eder. Olay dinleyicisi kaldırıldıktan sonra asla tekrar çağrılmaz (ileride işlenmek üzere tekrar kaydedilmediği sürece).

Parametreler

Olay akışına bir olay gönderir. Olay hedefi, dispatchEvent() öğesinin çağrıldığı EventDispatcher nesnesidir.

Parametreler

id özelliği, idName parametresiyle eşleşen bir öğe döndürür. id özelliğini temel alan bir stil uygulama yeteneği sağlar.

Örneğin, aşağıdaki satır, id span1 değerine sahip öğe için "color" stilini 0xFF0000 (kırmızı) olarak ayarlar.

         textFlow.getElementByID("span1").setStyle("color", 0xFF0000);
         

Not: Aşağıdaki kodda, p.addChild(s), s öğesini orijinal üst öğesinden kaldırıp yeni p üst öğesine ekler.

         var s:SpanElement = new SpanElement();
         var p:ParagraphElement = new ParagraphElement();
         ...
         s = textFlow.getElementByID("span3") as SpanElement;
         p.addChild(s);
         textFlow.addChild(p);
         

Parametreler

İlgili API Öğeleri

package flashx.textLayout.elements.examples {
    import flash.display.Sprite;
    
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class TextFlow_getElementByIDExample extends Sprite
    {
        public function TextFlow_getElementByIDExample()
        {    
            // create the TextFlow object
            var textFlow:TextFlow = new TextFlow();
            
            // xml markup that defines the attributes and contents of a text flow
            var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
            "<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\" verticalScrollPolicy=\"auto\" horizontalScrollPolicy=\"auto\" fontSize=\"14\" textIndent=\"15\" marginBottom=\"15\" paddingTop=\"4\" paddingLeft=\"4\">"+
                "<flow:p>"+
                    "<flow:span id='span1'>In the first paragraph of the </flow:span>"+
                    "<flow:span id='span2' fontStyle=\"italic\">cheap </flow:span>"+
                    "<flow:span id='span3'>Western novel, a cowboy meets a saloon girl.</flow:span>"+
                "</flow:p>"+
            "</flow:TextFlow>";
            var s:SpanElement = new SpanElement();
            var s2:SpanElement = new SpanElement();
            var p:ParagraphElement = new ParagraphElement();
            // import the xml markup into a TextFlow object and display it on the stage
            textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
            // get element with ID of span3, make a copy of it
            textFlow.getElementByID("span3").setStyle("color", 0xFF0000); 
            textFlow.flowComposer.addController(new ContainerController(this, 200, 800));
            textFlow.flowComposer.updateAllControllers();
        }
    }
}

            
            

styleName öğesi styleNameValue değerine ayarlı olan tüm öğeleri döndürür

Parametreler

İlgili API Öğeleri

typeName öğesi typeNameValue değerine ayarlı olan tüm öğeleri döndürür.

Parametreler

İlgili API Öğeleri

EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. Bu, EventDispatcher nesnesinin olay akışı hiyerarşisindeki bir event türünün işlenmesini nerede değiştirdiğini belirlemenize izin verir. Belirli türde bir olayın olay dinleyicisini gerçekten tetikleyip tetiklemeyeceğini belirlemek için IEventDispatcher.willTrigger() öğesini kullanın.

hasEventListener() ile willTrigger() arasındaki fark, hasEventListener() öğesi yalnızca ait olduğu nesneyi incelerken willTrigger() öğesinin type parametresi ile belirtilen olayın tüm olay akışını incelemesidir.

Parametreler

TextFlow nesnesinin tüm biçimlendirme bilgilerini geçersiz kılarak bu bilgileri yeniden hesaplanmaya zorlar. Stiller değiştiğinde bu yöntemi çağırın.

İlgili API Öğeleri

EventDispatcher nesnesinden bir dinleyiciyi kaldırır. EventDispatcher nesnesiyle kayıtlı eşlenen bir dinleyici yoksa, bu yönteme yapılan çağrının herhangi bir etkisi yoktur.

Parametreler

Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder. Belirtilen türde bir olay bu EventDispatcher nesnesine veya herhangi bir alt öğesine gönderildiğinde olay akışının herhangi bir aşamasında bir olay dinleyicisi tetiklenirse, bu yöntem true döndürür.

hasEventListener() ile willTrigger() arasındaki fark, hasEventListener() öğesi yalnızca ait olduğu nesneyi incelerken willTrigger() öğesinin type parametresi ile belirtilen olayın tüm olay akışını incelemesidir.

Parametreler

Herhangi bir bağ tıklatıldığında gönderilir.

Her yeniden oluşturma işleminden sonra gönderilir.

Her zarar gördüğünde bir TextFlow nesnesi tarafından gönderilir. TextFlow nesnesinin değiştiğini öğrenmek için bunu kullanabilirsiniz, ancak bu olay gönderildiğinde TextFlow nesnesine erişmeyin. TextFlow değişiklikleri kısmen tamamlandığında, tutarlı bir durumda olabilmesi için bu olay gönderilir: bazı değişiklikler önceden yapılmıştır ve bazı değişiklikler de halen beklemededir. Olaydan ihtiyaç duyduğunuz bilgileri edinin ve kontrol, uygulamanıza geri döndükten sonra gerekli değişiklikleri yapın.

Bu noktada (çalıştırıldıktan sonra) bir işlemin değiştirilmesi başarısız olabilir.

Genişlik veya yükseklik otomatik ya da yüzde olduğundan ve grafik yüklemeyi bitirdiğinden, InlineGraphicElement yeniden boyutlandırıldığında gönderilir.

Bir bağın üzerinde fareye basıldığında gönderilir.

Fare bir bağın üzerinden geçtiğinde gönderilir.

Fare bir bağın üzerinden serbest bırakıldığında gönderilir.

Fare bağ dışına çıktığında gönderilir.

Fare ilk defa bir bağa girdiğinde gönderilir.

Bir denetleyici kabı içinde metin kaydırıldıktan sonra bir TextFlow nesnesi tarafından gönderilir.

Seçim her değiştiğinde gönderilir. Birincil olarak, seçime bağlı kullanıcı arabirimini güncelleştirmek için kullanılır. Ayrıca seçimi değiştirmek için de kullanılabilir ancak TextFlow öğesinin kendisini değiştirmek için kullanılamaz.

Bir kompozisyon sonucunda kapta yeni bir DisplayObject eklendiğinde veya güncellendiğinde, TextFlow nesnesi tarafından gönderilir.