패키지 | flash.text.engine |
클래스 | public final class GroupElement |
상속 | GroupElement ContentElement Object |
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
content
속성에 한 단위로 할당할 수 있는 TextElement, GraphicElement 또는 다른 GroupElement 객체의 컬렉션을 그룹화합니다. GroupElement 객체는 다른 GroupElement 객체 내의 공통 형식을 공유할 수도 있습니다.
GroupElement에 다른 GroupElement가 포함된 경우 내부 GroupElement는 자체 형식(ElementFormat 설정)을 유지합니다. 외부 GroupElement의 형식이 상속되지는 않습니다.
GroupElement에서 대부분의 형식 속성은 효과가 없습니다. 따라서 elementFormat
매개 변수가 null인 GroupElement 객체에 대한 텍스트 행을 만들 수 있습니다. kerning
및 ligature
등의 몇 가지 형식 속성은 그룹의 멤버가 서로 겹치는 부분의 형식에 영향을 줍니다. 그룹의 형식이 null인 경우 그룹의 멤버가 서로 겹치는 부분의 형식은 이전 요소의 형식에 따라 결정됩니다.
관련 API 요소
속성 | 정의 주체 | ||
---|---|---|---|
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
elementCount : int [읽기 전용]
그룹의 요소 수입니다. | GroupElement | ||
elementFormat : ElementFormat
요소에 사용되는 ElementFormat 객체입니다. | ContentElement | ||
eventMirror : EventDispatcher
이 내용 요소에 기반을 둔 유효한 텍스트 행에 전달된 모든 이벤트의 복사본을 수신하는 EventDispatcher 객체입니다. | ContentElement | ||
groupElement : GroupElement [읽기 전용]
이 요소를 포함하는 GroupElement입니다. 이 요소가 그룹에 포함되지 않은 경우에는 null입니다. | ContentElement | ||
rawText : String [읽기 전용]
요소에 있는 텍스트(U+FDEF 문자 포함)의 복사본입니다. | ContentElement | ||
text : String [읽기 전용]
요소에 있는 텍스트(String의 그래픽 요소를 나타내는 U+FDEF 문자 제외)의 복사본입니다. | ContentElement | ||
textBlock : flash.text.engine:TextBlock [읽기 전용]
이 요소가 속하는 TextBlock입니다. | ContentElement | ||
textBlockBeginIndex : int [읽기 전용]
이 요소의 첫 번째 문자의 텍스트 블록에 있는 인덱스입니다. | ContentElement | ||
textRotation : String
요소에 단위로 적용되는 회전입니다. | ContentElement | ||
userData : *
임의 데이터를 요소와 연관시키는 방법을 응용 프로그램에 제공합니다. | ContentElement |
메서드 | 정의 주체 | ||
---|---|---|---|
GroupElement(elements:Vector.<ContentElement> = null, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
새 GroupElement 인스턴스를 만듭니다. | GroupElement | ||
그룹 내에서 요소를 검색합니다. | GroupElement | ||
charIndex 매개 변수로 지정한 문자가 포함된 요소를 반환합니다. | GroupElement | ||
element 매개 변수로 지정한 요소의 인덱스를 반환합니다. | GroupElement | ||
beginIndex 및 endIndex 매개 변수로 지정한 요소 범위를 해당 요소가 포함된 새 GroupElement로 대체합니다. | GroupElement | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
beginIndex 및 endIndex 매개 변수로 지정한 요소 범위의 텍스트를 beginIndex로 지정한 요소에 병합합니다. 이때 해당 요소의 형식은 그대로 유지합니다. | GroupElement | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
replaceElements(beginIndex:int, endIndex:int, newElements:Vector.<ContentElement>):Vector.<ContentElement>
beginIndex 및 endIndex 매개 변수로 지정된 요소 범위를 newElements 매개 변수의 내용으로 대체합니다. | GroupElement | ||
그룹의 요소를 Vector의 내용으로 설정합니다. | GroupElement | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
TextElement를 두 개로 분할하여 지정된 위치에 새로운 TextElement를 만듭니다. | GroupElement | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 문자열 표현을 반환합니다. | Object | ||
바깥쪽 GroupElement 객체 내에서 groupIndex로 지정한 중첩된 GroupElement의 요소를 그룹 해제합니다. | GroupElement | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object |
elementCount | 속성 |
GroupElement | () | 생성자 |
public function GroupElement(elements:Vector.<ContentElement> = null, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
새 GroupElement 인스턴스를 만듭니다.
매개 변수elements:Vector.<ContentElement> (default = null ) — GroupElement에 포함할 ContentElement 객체의 Vector입니다. Vector는 비워 둘 수 있습니다. 기본값은 null 입니다.
| |
elementFormat:ElementFormat (default = null ) — 그룹의 요소 형식입니다. 기본값은 null 입니다. 이 형식은 그룹에 포함된 요소 사이의 교차 영역에 적용됩니다. 해당 요소는 형식을 상속하지 않습니다.
| |
eventMirror:EventDispatcher (default = null ) — 이 내용 요소를 기반으로 만들어진 텍스트 줄에 전달된 모든 이벤트의 복사본을 수신하는 EventDispatcher 객체입니다. 기본값은 null 입니다.
| |
textRotation:String (default = "rotate0 ") — 요소에 한 단위로 적용되는 회전입니다. 이 속성에는 TextRotation 상수를 사용합니다. 기본값은 TextRotation.ROTATE_0 입니다.
|
오류
ArgumentError — 지정된 elements 에 null 요소가 들어 있습니다.
| |
ArgumentError — 지정된 element 에 ContentElement 의 알려진 하위 클래스가 아닌 요소가 들어 있습니다.
| |
ArgumentError — 지정된 element 에 content (TextBlock )로 지정된 요소가 들어 있습니다.
| |
ArgumentError — 지정된 element 에 이미 그룹의 멤버이거나 elements 에 두 번 이상 나오는 요소가 들어 있습니다.
|
관련 API 요소
getElementAt | () | 메서드 |
public function getElementAt(index:int):ContentElement
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
그룹 내에서 요소를 검색합니다.
매개 변수
index:int — 검색할 요소의 인덱스입니다.
|
ContentElement |
오류
RangeError — index 가 범위를 벗어난 경우입니다.
|
getElementAtCharIndex | () | 메서드 |
public function getElementAtCharIndex(charIndex:int):ContentElement
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
charIndex
매개 변수로 지정한 문자가 포함된 요소를 반환합니다.
매개 변수
charIndex:int — 해당 요소를 찾으려는 문자의 인덱스 값(0부터 시작)입니다. 값 0은 TextBlock의 첫 번째 문자가 아니라 그룹의 첫 번째 문자에 해당합니다.
|
ContentElement — charIndex 의 문자를 포함하는 요소입니다.
|
오류
RangeError — charIndex 가 0 - rawText.length 의 범위를 벗어난 경우입니다.
|
getElementIndex | () | 메서드 |
public function getElementIndex(element:ContentElement):int
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
element
매개 변수로 지정한 요소의 인덱스를 반환합니다.
매개 변수
element:ContentElement — 그룹에서 해당 인덱스를 검색하려는 요소입니다.
|
int — element 로 지정한 요소의 인덱스입니다. 요소가 그룹에 없는 경우 -1입니다.
|
groupElements | () | 메서드 |
public function groupElements(beginIndex:int, endIndex:int):GroupElement
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
beginIndex
및 endIndex
매개 변수로 지정한 요소 범위를 해당 요소가 포함된 새 GroupElement
로 대체합니다. 지정한 대로 beginIndex에서 endIndex-1까지의 요소가 대체됩니다.
매개 변수
beginIndex:int — 그룹으로 묶을 범위의 시작 위치를 나타내는 인덱스 값(0부터 시작)입니다.
| |
endIndex:int — 그룹으로 묶을 범위의 끝 위치 이후를 나타내는 인덱스 값(0부터 시작)입니다.
|
GroupElement — 새 그룹입니다.
|
오류
RangeError — beginIndex 또는 endIndex 가 범위를 벗어난 경우입니다.
|
mergeTextElements | () | 메서드 |
public function mergeTextElements(beginIndex:int, endIndex:int):flash.text.engine:TextElement
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
beginIndex
및 endIndex
매개 변수로 지정한 요소 범위의 텍스트를 beginIndex
로 지정한 요소에 병합합니다. 이때 해당 요소의 형식은 그대로 유지합니다. 지정한 대로 beginIndex에서 endIndex-1까지의 요소에 속한 텍스트가 병합됩니다. 해당 텍스트를 병합한 후에 beginIndex+1에서 endIndex-1까지의 요소가 그룹에서 제거되고 해당 요소는 group
속성이 null
인 고아가 됩니다.
매개 변수
beginIndex:int — 병합할 범위의 시작 위치를 나타내는 인덱스 값(0부터 시작)입니다.
| |
endIndex:int — 병합할 범위의 끝 위치를 나타내는 인덱스 값(0부터 시작)입니다.
|
flash.text.engine:TextElement — 이제 범위의 모든 텍스트를 포함하는 범위의 첫 번째 텍스트 요소입니다.
|
오류
RangeError — beginIndex 또는 endIndex 가 범위를 벗어난 경우입니다.
| |
ArgumentError — 지정된 범위에 TextElement가 아닌 요소가 있는 경우입니다.
|
관련 API 요소
replaceElements | () | 메서드 |
public function replaceElements(beginIndex:int, endIndex:int, newElements:Vector.<ContentElement>):Vector.<ContentElement>
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
beginIndex
및 endIndex
매개 변수로 지정한 요소 범위를 newElements
매개 변수의 내용으로 대체합니다. beginIndex에서 endIndex-1까지의 요소가 대체됩니다.
요소를 삭제하려면 newElements
에 null
을 전달합니다. 요소를 삽입하려면 beginIndex
및 endIndex
에 동일한 값을 전달합니다. 새 요소는 지정된 인덱스 앞에 삽입됩니다. 요소를 추가하려면 beginIndex
및 endIndex
에 elementCount
를 전달합니다.
작업 후 null
group
속성으로 대체된 요소는 고아가 되고 반환됩니다.
매개 변수
beginIndex:int — 바꾸기 범위의 시작 위치를 나타내는 인덱스 값(0부터 시작)입니다.
| |
endIndex:int — 대체 범위의 끝 위치 이후를 나타내는 인덱스 값(0부터 시작)입니다.
| |
newElements:Vector.<ContentElement> — 지정된 요소 범위를 대체하는 데 사용할 요소입니다.
|
Vector.<ContentElement> — 대체된 요소를 포함하는 Vector입니다.
|
오류
RangeError — 지정된 beginIndex 또는 endIndex 가 범위를 벗어납니다.
| |
ArgumentError — 지정된 newElements 에 null 요소가 들어 있습니다.
| |
ArgumentError — 지정된 newElements 에 this 가 들어 있습니다.
| |
ArgumentError — 지정된 newElements 에 ContentElement 의 알려진 하위 클래스가 아닌 요소가 들어 있습니다.
| |
ArgumentError — 지정된 newElements 에 content (TextBlock )로 지정된 요소가 들어 있습니다.
| |
ArgumentError — 지정된 newElements 에 이미 그룹의 멤버이거나 elements 에 두 번 이상 나오는 요소가 들어 있습니다.
| |
ArgumentError — 작업으로 인해 GroupElement 내에서 중첩 회전이 발생하는 경우입니다.
|
setElements | () | 메서드 |
public function setElements(value:Vector.<ContentElement>):void
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
그룹의 요소를 Vector의 내용으로 설정합니다.
매개 변수
value:Vector.<ContentElement> |
오류
ArgumentError — 지정된 value 가 null 요소를 포함합니다.
| |
ArgumentError — 지정된 value 가 this 를 포함합니다.
| |
ArgumentError — 지정된 value 에 ContentElement 의 알려진 하위 클래스가 아닌 요소가 포함되어 있습니다.
| |
ArgumentError — 지정된 value 에 TextBlock 의 content 로 지정한 요소가 포함되어 있습니다.
| |
ArgumentError — 지정된 value 에 이미 그룹의 멤버이거나 value 에 두 번 이상 나오는 요소가 들어 있습니다.
| |
ArgumentError — 작업으로 인해 GroupElement 내에서 중첩 회전이 발생하는 경우입니다.
|
splitTextElement | () | 메서드 |
public function splitTextElement(elementIndex:int, splitIndex:int):flash.text.engine:TextElement
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
TextElement를 두 개로 분할하여 지정된 위치에 새로운 TextElement를 만듭니다.
매개 변수
elementIndex:int — 그룹의 요소 위치를 나타내는 인덱스 값(0부터 시작)입니다.
| |
splitIndex:int — 분할이 발생할 TextElement의 문자를 나타내는 인덱스 값(0부터 시작)입니다. 지정된 문자는 새 TextElement의 첫 번째 문자가 됩니다.
|
flash.text.engine:TextElement — 원래 텍스트 요소의 뒷부분을 포함하는 새 텍스트 요소입니다.
|
오류
RangeError — elementIndex 또는 charIndex 가 범위를 벗어난 경우입니다.
| |
ArgumentError — elementIndex 의 요소가 TextElement가 아닌 경우입니다.
|
관련 API 요소
ungroupElements | () | 메서드 |
public function ungroupElements(groupIndex:int):void
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5, Flash Lite 4 |
바깥쪽 GroupElement 객체 내에서 groupIndex
로 지정한 중첩된 GroupElement의 요소를 그룹 해제합니다. 작업이 끝나면 그룹 해제된 요소가 중첩된 GroupElement를 대체하고 GroupElement는 group
속성이 null
인 고아가 됩니다.
매개 변수
groupIndex:int — 분할할 그룹의 위치를 나타내는 인덱스 값(0부터 시작)입니다.
|
오류
RangeError — groupIndex 가 범위를 벗어난 경우입니다.
| |
ArgumentError — groupIndex 의 요소가 GroupElement가 아닌 경우입니다.
|
content
속성에 GroupElement 객체를 할당합니다.
package { import flash.display.Sprite; import flash.display.MovieClip; import flash.text.engine.ContentElement; import flash.text.engine.TextBlock; import flash.text.engine.TextElement; import flash.text.engine.GraphicElement; import flash.text.engine.GroupElement; import flash.text.engine.TextLine; import flash.text.engine.ElementFormat; import flash.text.engine.FontDescription; public class GroupElementExample extends Sprite { public function GroupElementExample():void { var redBox:MovieClip = new MovieClip(); redBox.graphics.beginFill(0xCC0000, 1.0); redBox.graphics.drawRect(0, 0, 20, 20); redBox.graphics.endFill(); var format:ElementFormat = new ElementFormat(); var fontDescription:FontDescription = new FontDescription("Arial"); format.fontSize = 16; format.fontDescription = fontDescription; var str1:String = "This red box is a GraphicElement "; var str2:String = " in the middle of two TextElements, " + " which together make " + "up a GroupElement in a TextBlock that is broken into three lines."; var textElement1:TextElement = new TextElement(str1,format); var graphicElement:GraphicElement = new GraphicElement(redBox,redBox.width,redBox.height, format); var textElement2:TextElement = new TextElement(str2, format); var groupVector:Vector.<ContentElement> = new Vector.<ContentElement>(); groupVector.push(textElement1, graphicElement, textElement2); var groupElement = new GroupElement(groupVector); var textBlock:TextBlock = new TextBlock(); textBlock.content = groupElement; createTextLines(textBlock); } private function createTextLines(textBlock:TextBlock):void { var yPos = 20; var line_length:Number = 450; var textLine:TextLine = textBlock.createTextLine (null, line_length); while (textLine) { addChild(textLine); textLine.x = 15; yPos += textLine.height+8; textLine.y = yPos; textLine = textBlock.createTextLine(textLine, line_length); } } } }
Tue Jun 12 2018, 03:17 PM Z