패키지 | flashx.textLayout.elements |
클래스 | public class SpanElement |
상속 | SpanElement FlowLeafElement FlowElement Object |
하위 클래스 | SpecialCharacterElement |
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5 |
단락의 모든 텍스트가 동일한 속성 집합을 공유할 경우 ParagraphElement에는 단일 SpanElement 객체가 포함됩니다. 단락 텍스트에 적용된 서식이 여러 가지일 경우 여러 개의 SpanElement 객체가 포함됩니다.
기본 MXML 속성mxmlChildren
기타 예제
관련 API 요소
공용 속성
속성 | 정의 주체 | ||
---|---|---|---|
alignmentBaseline : *
TextLayoutFormat: 도미넌트 기준선 정렬의 기준이 되는 기준선을 지정합니다. | FlowElement | ||
backgroundAlpha : *
TextLayoutFormat: 배경에 대한 알파(투명도) 값입니다. 겹쳐 놓기 동안 undefined인 경우 기본값이 사용됩니다. | FlowElement | ||
backgroundColor : *
TextLayoutFormat: 텍스트의 배경색입니다. 겹쳐 놓기 동안 undefined인 경우 기본값이 사용됩니다. | FlowElement | ||
baselineShift : *
TextLayoutFormat: dominantBaseline 값에서 기준선을 이동하는 정도입니다. | FlowElement | ||
blockProgression : *
TextLayoutFormat: 줄 배치의 수직 또는 수평 진행을 지정합니다. | FlowElement | ||
breakOpportunity : *
TextLayoutFormat: 텍스트를 줄 바꿈하여 여러 줄로 나눌 때 줄을 나눌 수 있는 위치를 제어합니다. | FlowElement | ||
cffHinting : *
TextLayoutFormat: 이 텍스트에 사용된 CFF 힌팅 유형입니다. | FlowElement | ||
clearFloats : *
TextLayoutFormat: 부동 항목 주변 텍스트의 배열 방식을 제어합니다. | FlowElement | ||
color : *
TextLayoutFormat: 텍스트의 색상입니다. | FlowElement | ||
columnCount : *
TextLayoutFormat: 텍스트 열 수입니다. 겹쳐 놓기 동안 undefined인 경우 기본값이 사용됩니다. | FlowElement | ||
columnGap : *
TextLayoutFormat: 열 사이에 남겨 둘 제본용 여백 공간의 크기(픽셀 단위)를 지정합니다. 겹쳐 놓기 동안 undefined인 경우 기본값이 사용됩니다. | FlowElement | ||
columnWidth : *
TextLayoutFormat: 픽셀 단위의 열 폭입니다. 겹쳐 놓기 동안 undefined인 경우 기본값이 사용됩니다. | FlowElement | ||
computedFormat : flashx.textLayout.formats:ITextLayoutFormat [재정의] [읽기 전용]
이 요소에 적용되는 계산된 텍스트 서식 특성입니다. | FlowLeafElement | ||
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
coreStyles : Object [읽기 전용] 이 FlowElement에 대한 coreStyles를 반환합니다. | FlowElement | ||
digitCase : *
TextLayoutFormat: 이 텍스트에 사용된 숫자 케이스 유형입니다. | FlowElement | ||
digitWidth : *
TextLayoutFormat: 이 텍스트에 사용된 숫자 폭 유형입니다. | FlowElement | ||
direction : *
TextLayoutFormat: 텍스트 블록에 있는 텍스트의 기본 양방향 포함 수준을 지정합니다. | FlowElement | ||
dominantBaseline : *
TextLayoutFormat: 줄에 있는 요소의 세로 위치를 결정하기 위해 alignmentBaseline에 물릴 요소 기준선을 지정합니다. | FlowElement | ||
firstBaselineOffset : *
TextLayoutFormat: 컨테이너에서 첫 번째 줄의 기준선 위치를 지정합니다. | FlowElement | ||
fontFamily : *
TextLayoutFormat: 사용할 글꼴의 이름 또는 쉼표로 구분한 글꼴 이름 목록입니다. | FlowElement | ||
fontLookup : *
TextLayoutFormat: 사용할 글꼴 조회입니다. | FlowElement | ||
fontSize : *
TextLayoutFormat: 텍스트의 크기(픽셀 단위)입니다. | FlowElement | ||
fontStyle : *
TextLayoutFormat: 텍스트의 스타일입니다. | FlowElement | ||
fontWeight : *
TextLayoutFormat: 텍스트의 두께입니다. | FlowElement | ||
format : flashx.textLayout.formats:ITextLayoutFormat TextLayoutFormat 속성은 이 요소에 직접 적용됩니다. | FlowElement | ||
id : String
요소에 식별 이름을 지정하면 id를 참조하여 요소의 스타일을 설정할 수 있습니다. | FlowElement | ||
justificationRule : *
TextLayoutFormat: 단락에서 텍스트를 양쪽 정렬하는 데 사용되는 규칙입니다. | FlowElement | ||
justificationStyle : *
TextLayoutFormat: 단락의 양쪽 정렬에 사용되는 스타일입니다. | FlowElement | ||
kerning : *
TextLayoutFormat: 커닝은 가독성을 향상시키기 위해 특정 문자 쌍 사이의 픽셀을 조정합니다. | FlowElement | ||
leadingModel : *
TextLayoutFormat: 행간 기준과 행간 방향이 결합된 행간 모델을 지정합니다. | FlowElement | ||
ligatureLevel : *
TextLayoutFormat: 글꼴에 정의된 합자 중 텍스트에 사용할 수 있는 합자를 제어합니다. | FlowElement | ||
lineBreak : *
TextLayoutFormat: 컨테이너 내 줄 바꿈을 제어합니다. 겹쳐 놓기 동안 undefined인 경우 기본값이 사용됩니다. | FlowElement | ||
lineHeight : *
TextLayoutFormat: 텍스트에 대한 행간 컨트롤입니다. | FlowElement | ||
lineThrough : *
TextLayoutFormat: true이면 텍스트 가운데에 선이 그려지는 취소선이 적용됩니다. | FlowElement | ||
linkActiveFormat : *
TextLayoutFormat: 일반 상태의 링크에 사용되는 서식 지정 특성을 정의합니다. | FlowElement | ||
linkHoverFormat : *
TextLayoutFormat: 마우스가 링크 경계 내에 있을 때 마우스로 링크를 가리킨 상태의 링크에 사용되는 서식 지정 특성을 정의합니다. | FlowElement | ||
linkNormalFormat : *
TextLayoutFormat: 일반 상태의 링크에 사용되는 서식 지정 특성을 정의합니다. | FlowElement | ||
listAutoPadding : *
TextLayoutFormat: 목록이 시작되는 쪽의 패딩 값이 auto인 경우 목록이 시작되는 가장자리에 자동 들여쓰기를 지정합니다. | FlowElement | ||
listMarkerFormat : *
TextLayoutFormat: 서식 지정 특성 목록 표시자를 정의합니다. | FlowElement | ||
listStylePosition : *
TextLayoutFormat: 올바른 값은 ListStylePosition.INSIDE, ListStylePosition.OUTSIDE, FormatValue.INHERIT입니다. 기본값은 설정되지 않았음을 나타내는 undefined입니다. 겹쳐 놓기 동안 undefined인 경우 이 속성은 조상의 값을 상속합니다. | FlowElement | ||
listStyleType : *
TextLayoutFormat: 올바른 값은 ListStyleType.UPPER_ALPHA, ListStyleType.LOWER_ALPHA, ListStyleType.UPPER_ROMAN, ListStyleType.LOWER_ROMAN, ListStyleType.NONE, ListStyleType.DISC, ListStyleType.CIRCLE, ListStyleType.SQUARE, ListStyleType.BOX, ListStyleType.CHECK, ListStyleType.DIAMOND, ListStyleType.HYPHEN, ListStyleType.ARABIC_INDIC, ListStyleType.BENGALI, ListStyleType.DECIMAL, ListStyleType.DECIMAL_LEADING_ZERO, ListStyleType.DEVANAGARI, ListStyleType.GUJARATI, ListStyleType.GURMUKHI, ListStyleType.KANNADA, ListStyleType.PERSIAN, ListStyleType.THAI, ListStyleType.URDU, ListStyleType.CJK_EARTHLY_BRANCH, ListStyleType.CJK_HEAVENLY_STEM, ListStyleType.HANGUL, ListStyleType.HANGUL_CONSTANT, ListStyleType.HIRAGANA, ListStyleType.HIRAGANA_IROHA, ListStyleType.KATAKANA, ListStyleType.KATAKANA_IROHA, ListStyleType.LOWER_ALPHA, ListStyleType.LOWER_GREEK, ListStyleType.LOWER_LATIN, ListStyleType.UPPER_ALPHA, ListStyleType.UPPER_GREEK, ListStyleType.UPPER_LATIN, FormatValue.INHERIT입니다. 기본값은 설정되지 않았음을 나타내는 undefined입니다. 겹쳐 놓기 동안 undefined인 경우 이 속성은 조상의 값을 상속합니다. | FlowElement | ||
locale : *
TextLayoutFormat: 텍스트의 로캘입니다. | FlowElement | ||
mxmlChildren : Array
span 태그 안 내용을 기준으로 텍스트를 설정하고, 항상 기존 자식은 삭제합니다. | SpanElement | ||
paddingBottom : *
TextLayoutFormat: 아래쪽 인세트(픽셀 단위)입니다. | FlowElement | ||
paddingLeft : *
TextLayoutFormat: 왼쪽 인세트(픽셀 단위)입니다. | FlowElement | ||
paddingRight : *
TextLayoutFormat: 오른쪽 인세트(픽셀 단위)입니다. | FlowElement | ||
paddingTop : *
TextLayoutFormat: 위쪽 인세트(픽셀 단위)입니다. | FlowElement | ||
paragraphEndIndent : *
TextLayoutFormat: 단락의 끝 가장자리를 들여 쓸 크기를 지정하는 숫자(픽셀 단위)입니다. | FlowElement | ||
paragraphSpaceAfter : *
TextLayoutFormat: 단락 뒤에 남겨 둘 공간 크기(픽셀 단위)를 지정하는 숫자입니다. | FlowElement | ||
paragraphSpaceBefore : *
TextLayoutFormat: 단락 앞에 남겨 둘 공간 크기(픽셀 단위)를 지정하는 숫자입니다. | FlowElement | ||
paragraphStartIndent : *
TextLayoutFormat: 단락의 시작 가장자리를 들여 쓸 크기를 지정하는 숫자(픽셀 단위)입니다. | FlowElement | ||
parent : FlowGroupElement [읽기 전용] 이 FlowElement 객체의 부모를 반환합니다. | FlowElement | ||
parentRelativeEnd : int [읽기 전용] 부모에서 이 FlowElement 객체의 상대적 끝을 반환합니다. | FlowElement | ||
parentRelativeStart : int [읽기 전용] 부모에서 이 FlowElement 객체의 상대적 시작을 반환합니다. | FlowElement | ||
renderingMode : *
TextLayoutFormat: 이 텍스트에 사용되는 렌더링 모드입니다. | FlowElement | ||
styleName : *
TextLayoutFormat: 요소에 식별 클래스를 지정하면 styleName을 참조하여 요소의 스타일을 설정할 수 있습니다. | FlowElement | ||
styles : Object [읽기 전용] 이 FlowElement의 styles를 반환합니다. | FlowElement | ||
tabStops : *
TextLayoutFormat: 단락과 연결된 탭 정지를 지정합니다. | FlowElement | ||
text : String
이 SpanElement 객체가 보유하는 텍스트의 String을 수신합니다. | SpanElement | ||
textAlign : *
TextLayoutFormat: 컨테이너를 기준으로 한 단락의 줄 정렬입니다. | FlowElement | ||
textAlignLast : *
TextLayoutFormat: 양쪽 정렬된 텍스트의 컨테이너를 기준으로 한 단락의 마지막 줄 또는 유일한 줄의 정렬입니다. | FlowElement | ||
textAlpha : *
TextLayoutFormat: 텍스트의 알파(투명도) 값입니다. | FlowElement | ||
textDecoration : *
TextLayoutFormat: 텍스트의 장식입니다. | FlowElement | ||
textIndent : *
TextLayoutFormat: 단락의 첫 번째 줄을 들여 쓸 크기를 지정하는 숫자(픽셀 단위)입니다. | FlowElement | ||
textJustify : *
TextLayoutFormat: 텍스트를 양쪽 정렬하는 옵션을 지정합니다. | FlowElement | ||
textLength : int [읽기 전용]
이 FlowElement 객체 및 자식이 소유하는 텍스트의 전체 길이를 반환합니다. | FlowElement | ||
textRotation : *
TextLayoutFormat: 이 텍스트를 회전할 각도의 수를 결정합니다. | FlowElement | ||
tracking : Object [쓰기 전용]
자간을 설정하며 trackingRight 속성과 같습니다. | FlowElement | ||
trackingLeft : *
TextLayoutFormat: 각 문자의 왼쪽에 적용할 자간(수동 커닝)의 크기를 나타내는 픽셀 단위의 숫자 또는 fontSize의 퍼센트(예: 120%)입니다. | FlowElement | ||
trackingRight : *
TextLayoutFormat: 각 문자의 오른쪽에 적용할 자간(수동 커닝)의 크기를 나타내는 픽셀 단위의 숫자 또는 fontSize의 퍼센트(예: 120%)입니다. | FlowElement | ||
typeName : String
각 FlowElement마다 typeName이 있습니다. | FlowElement | ||
typographicCase : *
TextLayoutFormat: 이 텍스트에 사용된 입력 체계 대/소문자 유형입니다. | FlowElement | ||
userStyles : Object FlowElement 객체에서 사용자 스타일을 읽고 쓸 수 있도록 합니다. | FlowElement | ||
verticalAlign : *
TextLayoutFormat: 세로 정렬 또는 양쪽 정렬입니다. 겹쳐 놓기 동안 undefined인 경우 기본값이 사용됩니다. | FlowElement | ||
whiteSpaceCollapse : *
TextLayoutFormat: 텍스트를 TextFlow로 가져올 때 공백을 축소하거나 유지합니다. | FlowElement | ||
wordSpacing : *
TextLayoutFormat: 양쪽 정렬하는 동안 사용할 단어 사이의 최적, 최소 및 최대 간격을 보통 간격의 배수로 지정합니다. | FlowElement |
공용 메서드
메서드 | 정의 주체 | ||
---|---|---|---|
생성자 - 단락의 텍스트 흐름을 유지하는 SpanElement 객체를 만듭니다. | SpanElement | ||
이 FlowElement 객체의 styleProp 매개 변수로 지정된 스타일을 지웁니다. | FlowElement | ||
두 개의 지정된 문자 위치 간의 내용을 복사하고, 복사본을 FlowElement 객체로 반환하여 이 FlowElement 객체의 전체 복사본(모든 자식 포함)을 만듭니다. | FlowElement | ||
이 클래스의 userStyles를 otherElement의 userStyles와 비교합니다. | FlowElement | ||
텍스트 흐름에서 요소의 시작 위치를 절대 인덱스로 반환합니다. | FlowElement | ||
FlowElement 객체에 상대적인, 지정된 위치의 문자를 반환합니다. | FlowElement | ||
FlowElement에 상대적인, 지정된 위치의 문자 코드를 반환합니다. | FlowElement | ||
범위의 FontMetrics 객체를 반환합니다. | FlowLeafElement | ||
상위 항목 요소에 상대적인 이 요소의 시작을 반환합니다. | FlowElement | ||
다음 FlowLeafElement 객체를 반환합니다. | FlowLeafElement | ||
텍스트 흐름 계층 구조에서 다음 FlowElement 형제를 반환합니다. | FlowElement | ||
이 요소와 연관된 ParagraphElement 객체를 반환합니다. | FlowElement | ||
이전 FlowLeafElement 객체를 반환합니다. | FlowLeafElement | ||
텍스트 흐름 계층 구조에서 이전 FlowElement 형제를 반환합니다. | FlowElement | ||
styleProp 매개 변수로 지정된 스타일의 값을 반환합니다. 이 매개 변수는 스타일 이름을 지정하며 임의의 사용자 스타일 이름을 포함할 수 있습니다. | FlowElement | ||
흐름 요소에서 지정한 텍스트 범위를 가져옵니다. | FlowElement | ||
텍스트 흐름 계층 구조를 올라가 요소의 루트 TextFlow 객체를 반환합니다. | FlowElement | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
구현하는 객체가 만들어지고 MXML 태그에 지정된 모든 구성 요소 속성이 초기화된 후 MXML 객체에 대해 호출됩니다. | FlowElement | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
지정된 시작 및 종료 위치에 따라 텍스트 범위의 텍스트를 업데이트합니다. | SpanElement | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
styleProp 매개 변수로 지정된 스타일을 newValue 매개 변수로 지정된 값으로 설정합니다. | FlowElement | ||
지정된 두 문자 위치 간의 내용을 복사하여 이 FlowElement 객체의 복사본을 만듭니다. | FlowElement | ||
relativePosition 매개 변수로 지정된 위치에서 이 FlowElement 객체를 분리합니다. 지정된 위치는 이 요소의 텍스트에 있는 상대적 위치입니다. | FlowElement | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object |
속성 세부 정보
mxmlChildren | 속성 |
mxmlChildren:Array
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5 |
span 태그 안 내용을 기준으로 텍스트를 설정하고, 항상 기존 자식은 삭제합니다. 이 속성은 Flex의 컴파일된 MXML 가져오기를 수행하는 동안 사용됩니다. Flash Professional에서는 이 속성이 무시됩니다. TLF 마크업 요소에 다른 TLF 마크업 요소가 자식으로 포함된 경우 해당 자식이 이 속성에 지정됩니다.
구현
public function get mxmlChildren():Array
public function set mxmlChildren(value:Array):void
오류
TypeError — 배열 요소가 SpecialCharacterElement 또는 String이 아닌 경우입니다.
|
text | 속성 |
생성자 세부 정보
SpanElement | () | 생성자 |
public function SpanElement()
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5 |
생성자 - 단락의 텍스트 흐름을 유지하는 SpanElement 객체를 만듭니다.
메서드 세부 정보
replaceText | () | 메서드 |
public function replaceText(relativeStartPosition:int, relativeEndPosition:int, textValue:String):void
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10, AIR 1.5 |
지정된 시작 및 종료 위치에 따라 텍스트 범위의 텍스트를 업데이트합니다. 텍스트를 삽입하려면 종료 위치를 시작 위치와 같도록 설정합니다. 범위의 기존 텍스트에 텍스트를 추가하려면 시작 위치와 종료 위치를 기존 텍스트 길이와 같게 설정합니다.
대체되는 텍스트에는 시작 문자부터 종료 문자 전까지의 모든 문자가 포함됩니다.
매개 변수
relativeStartPosition:int — 바꿀 텍스트 시작 부분의 인덱스 위치이며 범위의 시작에 상대적입니다. 범위에서 첫 번째 문자는 위치 0에 있습니다.
| |
relativeEndPosition:int — 바꿀 텍스트의 마지막 문자 위치보다 1 뒤의 인덱스이며 범위의 시작에 상대적입니다. 이 값은 삽입을 위한 relativeStartPos 와 같습니다.
| |
textValue:String — 경우에 따라 대체 텍스트 또는 추가할 텍스트입니다.
|
오류
RangeError — 지정된 relativeStartPosition 또는 relativeEndPosition 이 범위를 벗어나거나 바꾸기의 결과로 서로게이트 쌍이 분리되고 있습니다.
|
예제 ( 예제 사용 방법 )
이 예에서는 replaceText()를 여러 번 호출하여 텍스트 시작 부분에 문자열을 삽입하고, 텍스트 종료 부분에 문자열을 추가하고, 텍스트 중간에 문자열을 삽입하고, 전체 텍스트를 새 문자열로 바꿉니다.
이 예에서는 두 번째 범위(span2)를 사용하여 결과를 표시합니다.
package flashx.textLayout.elements.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.elements.ParagraphElement; import flashx.textLayout.elements.SpanElement; import flashx.textLayout.elements.TextFlow; public class SpanElement_replaceTextExample extends Sprite { public function SpanElement_replaceTextExample() { // create container and add it to the stage var container:Sprite = new Sprite(); this.stage.addChild(container); // create TextFlow, ParagraphElement, and SpanElement objects var textFlow:TextFlow = new TextFlow(); var paragraph:ParagraphElement = new ParagraphElement(); var span:SpanElement = new SpanElement; var span2:SpanElement = new SpanElement; // add composer and container controller var controller:ContainerController = new ContainerController(container, 200, 700 ); textFlow.flowComposer.addController(controller); textFlow.fontSize = 24; // set font size // create text string and add it to the span var str:String = "0123456"; span.text = str; // insert at the beginning span.replaceText(0, 0, "abc"); span2.text = span.text + '\n'; // append to the end of the text span.replaceText(10, 10, "abc"); span2.text += span.text + '\n'; // insert string in the middle of the text span.replaceText(5, 8, "abc"); span2.text += span.text + '\n'; // replace text with string span.replaceText(0, 13, "abc"); span2.text += span.text + '\n'; // replace text with string span.replaceText(0, 3, "That's all she wrote!\n"); span2.text += span.text + '\n'; // display the results paragraph.addChild(span2); textFlow.addChild(paragraph); textFlow.flowComposer.updateAllControllers(); } } }
예제 예제 사용 방법
SpanElementExample.as
이 예에서는 스타일이 서로 다른 두 개의 SpanElement 객체를 사용하여 Hello World를 표시합니다.
package flashx.textLayout.elements.examples { import flash.display.Sprite; import flash.text.engine.FontPosture; import flashx.textLayout.container.ContainerController; import flashx.textLayout.elements.ParagraphElement; import flashx.textLayout.elements.SpanElement; import flashx.textLayout.elements.TextFlow; public class SpanElementExample extends Sprite { public function SpanElementExample() { // create a container and add it to the stage var container:Sprite = new Sprite(); this.stage.addChild(container); // create TextFlow, ParagraphElement, and SpanElement objects var textFlow:TextFlow = new TextFlow(); var p:ParagraphElement = new ParagraphElement(); var spanHello:SpanElement = new SpanElement(); var spanWorld:SpanElement = new SpanElement(); // add text and styles to the spans spanHello.text = "Hello, "; spanHello.fontSize = 48; spanWorld.text = "World!"; spanWorld.fontSize = 56; spanWorld.fontStyle = FontPosture.ITALIC; spanWorld.color = 0xFFCC00; // add spans to paragraph, paragraph to text flow p.addChild(spanHello); p.addChild(spanWorld); textFlow.addChild(p); // update controller to display text var controller:ContainerController = new ContainerController(container, 400, 200 ); textFlow.flowComposer.addController(controller); textFlow.flowComposer.updateAllControllers(); } } }
Tue Jun 12 2018, 03:17 PM Z