TextFlow  - AS3

이 TextFlow의 Configuration 객체입니다. Configuration 객체는 초기 문자 및 단락 서식, 초기 컨테이너 서식과 선택 영역 강조, 링크, 포커스 및 스크롤의 속성을 지정합니다.

Configuration 객체를 지정하지 않으면 Text Layout Framework에서 기본 Configuration 객체를 사용합니다. 기본 Configuration 객체는 defaultConfiguration 속성으로 참조됩니다.

관련 API 요소

구성을 지정하지 않은 경우 모든 새 TextFlow 객체의 기본 구성입니다.

관련 API 요소

이 요소의 컨테이너를 관리합니다.

요소에서 만들어진 TextLines는 컨테이너의 자식으로 나타납니다. flowComposer는 컨테이너를 관리하고, 텍스트가 편집될 때 컨테이너에 줄을 추가하거나 줄을 제거합니다. 또한 flowComposer는 컴포지션할 폭과 높이, 스크롤 설정 여부 등 몇 가지 중요 속성을 추적합니다.

컨테이너 및 flowComposer는 밀접하게 관련되어 있습니다. flowComposer를 재설정하면 컨테이너가 새 flowComposer의 컨테이너로 재설정됩니다. 마찬가지로 컨테이너가 재설정되면 flowComposer가 컨테이너의 새 flowComposer로 재설정됩니다.

관련 API 요소

요소 스타일을 해결하는 콜백 함수입니다. 이 함수를 통해 CSS, 이름 지정된 스타일 등을 사용하는 스타일을 제공할 수 있습니다.

관련 API 요소

이 TextFlow 객체의 생성 번호입니다. 실행 취소 및 다시 실행 작업은 생성 번호를 사용하여 작업을 실행 취소 또는 다시 실행하는 것이 적절한지 확인합니다. 이 경우 생성 번호가 일치해야 합니다.

각 모델 변경에 따라 generation 이 증가되므로, 생성 번호가 변경되면 TextFlow 모델이 변경되었음을 알 수 있습니다.

이 TextFlow 객체의 TextLayoutFormat 객체입니다. 이를 통해 호스트 서식을 재사용하는 일부 작업을 최적화할 수 있습니다. 예를 들어 다음과 같습니다.

        textFlowA.hostFormat = textFlowB.hostFormat
        

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

관련 API 요소

이 TextFlow 객체와 연관된 InteractionManager입니다.

모든 선택 영역과 텍스트에 대한 편집을 제어합니다. TextFlow를 선택할 수 없는 경우 interactionManager는 null입니다. TextFlow를 편집 가능하도록 설정하려면 ISelectionManager이면서 동시에 IEditManager인 interationManager를 지정합니다. 읽기 전용이며 선택 가능한 TextFlow를 만들려면 ISelectionManager 전용인 interactionManager를 지정합니다.

관련 API 요소

생성자 - 새 TextFlow 인스턴스를 만듭니다.

config 매개 변수를 지정하면 Configuration 객체의 내용이 복사되며 사용자가 변경할 수 없습니다. 하지만 configuration 속성을 통해 구성 설정에 액세스할 수 있습니다. config 매개 변수가 null인 경우에는 defaultConfiguration 속성을 통해 기본 구성 설정에 액세스할 수 있습니다.

Configuration 객체는 TextFlow의 구성 가능한 기본 속성을 설정할 수 있는 메커니즘을 제공합니다. Configuration 객체를 변경할 수 없는 경우 필요하면 TextFlow 및 자식의 속성을 설정하여 기본 속성을 재정의할 수 있습니다.

관련 API 요소

리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. 표시 목록의 모든 노드에서 특정 유형의 이벤트, 단계, 우선 순위에 대한 이벤트 리스너를 등록할 수 있습니다.

이벤트 리스너의 등록을 마친 뒤에는 addEventListener()를 추가로 호출하여 그 우선 순위를 변경할 수 없습니다. 리스너의 우선 순위를 변경하려면 먼저 removeEventListener()를 호출해야 합니다. 그런 다음 해당 리스너를 새로운 우선 순위 레벨로 다시 등록할 수 있습니다.

리스너가 등록된 다음, 이어서 type 또는 useCapture에 다른 값을 설정하여 addEventListener()를 호출하면 별도의 리스너 등록이 만들어집니다. 예를 들어 useCapture가 true로 설정된 리스너를 등록하면 이 리스너는 캡처 단계 동안에만 수신합니다. 그러나 useCapture를 false로 설정하고 동일한 리스너 객체를 사용하여 addEventListener()를 다시 호출하면 별도로 두 개의 리스너가 등록되어, 한 리스너는 캡처 단계 동안 수신하고 다른 하나는 대상 및 버블링 단계 동안 수신합니다.

대상 단계 또는 버블링 단계 전용의 이벤트 리스너를 등록할 수는 없습니다. 버블링은 대상 노드의 조상에만 적용되기 때문에 이들 단계는 등록 과정에서 하나로 통합됩니다.

사용하지 않는 이벤트 리스너는 EventDispatcher.removeEventListener()를 호출하여 제거하도록 합니다. 이렇게 하지 않으면 메모리 문제가 발생할 수 있습니다. 가비지 수집기는 참조가 남아 있는 객체를 제거하지 않으므로, 등록된 이벤트 리스너가 있는 객체는 메모리에서 자동으로 제거되지 않습니다.

EventDispatcher 인스턴스를 복사해도 연결된 이벤트 리스너는 복사되지 않습니다. 새로 만든 노드에 이벤트 리스너가 필요한 경우, 노드를 만든 후 리스너를 연결해야 합니다. 그러나 EventDispatcher 인스턴스를 이동할 때에는 연결된 이벤트 리스너도 함께 이동됩니다.

이벤트가 노드에서 처리되는 동안 이벤트 리스너도 이 노드에서 등록되는 중이면, 이벤트 리스너가 현재 단계에서는 트리거되지 않지만 버블링 단계와 같은 이벤트 흐름의 나중 단계에서 트리거될 수 있습니다.

이벤트를 처리 중인 노드에서 이벤트 리스너를 제거하는 경우, 그 리스너는 현재 액션에 의해 트리거됩니다. 일단 제거된 이벤트 리스너는 이후의 처리를 위해 재등록하지 않는 한 다시는 호출되지 않습니다.

매개 변수

이벤트를 이벤트 흐름으로 전달합니다. 이벤트 대상은 dispatchEvent()가 호출되는 EventDispatcher 객체입니다.

매개 변수

id 속성이 idName 매개 변수와 일치하는 요소를 반환합니다. id를 기준으로 스타일을 적용하는 기능을 제공합니다.

예를 들어 다음 줄은 id span1인 요소에 대해 "color" 스타일을 0xFF0000(빨강)으로 설정합니다.

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

참고: 다음 코드에서 p.addChild(s)는 원본 부모에서 s를 제거하고 새 부모에 p를 추가합니다.

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

매개 변수

관련 API 요소

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이 styleNameValue로 설정된 모든 요소를 반환합니다.

매개 변수

관련 API 요소

typeName이 typeNameValue로 설정된 모든 요소를 반환합니다.

매개 변수

관련 API 요소

EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. 이를 통해 이벤트 흐름 계층 구조의 어떤 지점에서 EventDispatcher 객체가 이벤트 유형 처리를 변경했는지 확인할 수 있습니다. 특정 이벤트 유형이 실제로 이벤트 리스너를 트리거하는지 여부를 확인하려면 IEventDispatcher.willTrigger()를 사용합니다.

hasEventListener()와 willTrigger() 간의 차이점은 hasEventListener()가 자신이 속한 객체만 검사하는 반면 willTrigger()는 type 매개 변수에 의해 지정된 이벤트의 전체 흐름을 검사한다는 점입니다.

매개 변수

TextFlow의 모든 서식 정보를 무효화하여 다시 계산되도록 합니다. 스타일이 변경되면 이 메서드를 호출합니다.

관련 API 요소

EventDispatcher 객체에서 리스너를 제거합니다. EventDispatcher 객체와 함께 등록된 리스너 중 일치하는 것이 없다면 이 메서드를 호출해도 아무 영향이 없습니다.

매개 변수

이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. 지정된 유형의 이벤트가 이 EventDispatcher 객체나 그 자손으로 전달되었을 때 이벤트 흐름의 특정 단계에서 이벤트 리스너가 트리거되는 경우 이 메서드는 true를 반환합니다.

hasEventListener()와 willTrigger() 간의 차이점은 hasEventListener()가 자신이 속한 객체만 검사하는 반면 willTrigger()는 type 매개 변수에 의해 지정된 이벤트의 전체 흐름을 검사한다는 점입니다.

매개 변수

링크를 클릭하면 전달됩니다.

다시 컴포지션할 때마다 전달됩니다.

TextFlow 객체가 손상될 때마다 해당 객체에서 전달합니다. 이 이벤트를 사용하여 TextFlow가 변경되었음을 알 수는 있지만 이 이벤트가 전송되었을 때 TextFlow 자체에 액세스하지는 못합니다. TextFlow의 변경이 부분적으로 완료되어 일관되지 않은 상태에 있을 때 이 이벤트가 전송됩니다. 일부 변경 내용은 이미 적용되었지만 다른 변경 내용은 보류 중인 경우에 일관되지 않은 상태가 될 수 있습니다. 이벤트에서 필요한 정보를 얻고 응용 프로그램으로 제어가 반환된 후 필요한 내용을 변경합니다.

작업이 실행된 후에는 작업을 변경할 수 없습니다.

폭이나 높이가 자동 또는 퍼센트로 지정되어 InlineGraphicElement 크기가 조정되고 그래픽 로딩이 완료될 때 전달됩니다.

링크를 마우스 단추로 누르면 전달됩니다.

마우스가 링크 위를 지나가면 전달됩니다.

링크 위에서 마우스 단추를 놓으면 전달됩니다.

마우스가 링크를 벗어나면 전달됩니다.

마우스가 처음으로 링크 위에 오면 전달됩니다.

컨트롤러 컨테이너 내에서 텍스트가 스크롤된 후 TextFlow 객체에서 전달됩니다.

선택 영역이 변경될 때마다 전달됩니다. 선택 영역에 종속된 사용자 인터페이스를 업데이트하는 데 주로 사용됩니다. 선택 영역을 변경하는 데 사용될 수도 있지만 TextFlow 자체를 변경하는 데는 사용될 수 없습니다.

컨테이너에서 컴포지션의 결과로 새 DisplayObjects를 추가하거나 업데이트할 때마다 TextFlow 객체에서 전달합니다.