flash.text.TextSnapshot (Flex™ 2 레퍼런스 가이드)

	property	정의
		charCount : int [read-only] TextSnapshot object내의 캐릭터수입니다.	TextSnapshot
		constructor : Object 특정의 object 인스턴스의 클래스 object 또는 constructor　　 함수에의 참조입니다.	Object
		prototype : Object [static] 클래스 또는 함수 object의 prototype object에의 참조입니다.	Object

	Methods	정의
		findText (beginIndex:int , textToFind:String , caseSensitive:Boolean ):int 지정된 TextSnapshot object내를 검색해, 최초로 (또는 `beginIndex` 의 뒤에) 발견된 `textToFind` 의 위치를 돌려줍니다.	TextSnapshot
		getSelected (beginIndex:int , endIndex:int ):Boolean 선택된 텍스트가 TextSnapshot object의 지정 범위에 존재할지 어떨지를 나타내는 불리언 값을 돌려줍니다.	TextSnapshot
		getSelectedText (includeLineEndings:Boolean = false):String 대응하는 `setSelected()` Methods로 지정된 모든 캐릭터를 포함한 string를 돌려줍니다.	TextSnapshot
		getText (beginIndex:int , endIndex:int , includeLineEndings:Boolean = false):String `beginIndex` Parameters와 `endIndex` Parameters로 지정된 모든 캐릭터를 포함한 string를 돌려줍니다.	TextSnapshot
		getTextRunInfo (beginIndex:int , endIndex:int ):Array 연속한 텍스트에 관한 정보를 포함한 object의 배열을 돌려줍니다.	TextSnapshot
		hasOwnProperty (name:String ):Boolean object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.	Object
		hitTestTextNearPos (x:Number , y:Number , maxDistance:Number = 0):Number TextSnapshot object내의 어느 캐릭터가, TextSnapshot object의 텍스트를 포함한 무비 클립의 지정 좌표 `x`,`y` 상또는 그 부근에 존재하는지를 평가합니다.	TextSnapshot
		isPrototypeOf (theClass:Object ):Boolean Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.	Object
		propertyIsEnumerable (name:String ):Boolean 지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.	Object
		setPropertyIsEnumerable (name:String , isEnum:Boolean = true):void 루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.	Object
		setSelectColor (hexColor:uint = 0xFFFF00):void `setSelected()` Methods로 선택된 캐릭터를 강조 표시할 경우에 사용하는 색을 지정합니다.	TextSnapshot
		setSelected (beginIndex:int , endIndex:int , select:Boolean ):void 선택 또는 선택 해제하는 TextSnapshot object의 캐릭터 범위를 지정합니다.	TextSnapshot
		toString ():String 지정된 object의 string 표현을 돌려줍니다.	Object
		valueOf ():Object 지정된 object의 원시적치를 돌려줍니다.	Object

property의 상세

charCount

property

charCount:int [read-only]

TextSnapshot object내의 캐릭터수입니다.

Implements
public function get charCount():int

See also

flash.text.TextSnapshot.getText()

Methods의 상세

findText

()

Methods

public function findText(beginIndex:int , textToFind:String , caseSensitive:Boolean ):int

지정된 TextSnapshot object내를 검색해, 최초로 (또는 beginIndex 의 뒤에) 발견된 textToFind 의 위치를 돌려줍니다. textToFind 가 발견되지 않았던 경우는,-1 을 돌려줍니다.

Parameters

	`beginIndex:int` — 지정된 텍스트를 검색하는 개시 포인트를 지정합니다.

	`textToFind:String` — 검색 대상의 텍스트를 지정합니다. String 형의 변수는 아니고, string 리터럴을 지정하는 경우는, 그 캐릭터 라인을 인용부호로 둘러쌀 필요가 있습니다.

	`caseSensitive:Boolean` — `textToFind` 로 검색할 때에 대문자와 소문자를 구별할지 어떨지를 지정합니다.

반환값

int — 지정된 텍스트가 최초로 발견된 위치를 나타내는 제로 베이스의 인덱스 위치 또는 -1 입니다.

See also

flash.text.TextSnapshot.getText()

getSelected

()

Methods

public function getSelected(beginIndex:int , endIndex:int ):Boolean

선택된 텍스트가 TextSnapshot object의 지정 범위에 존재할지 어떨지를 나타내는 불리언 값을 돌려줍니다.

모든 캐릭터를 검색하려면 ,start 에는 0 을 지정해,end 에는 charCount (또는 충분히 큰 수치)를 지정합니다. 1 개의 캐릭터만을 검색하는 경우는,start Parameters에 1 을 더한 값을 end Parameters로서 지정합니다.

Parameters

	`beginIndex:int` — 검사를 개시하는 캐릭터의 위치를 나타냅니다. `beginIndex` 로 지정할 수 있는 값은,`0` ~ `TextSnapshot.charCount - 1` 입니다. `beginIndex` 가 부의 값의 경우,`0` 이 사용됩니다.

	`endIndex:int` — 검사하는 마지막 캐릭터의 인덱스에 1 을 더한 값입니다. `endIndex` 로 지정할 수 있는 값은,`0` ~ `charCount` 입니다. `endIndex` Parameters로 지정된 인덱스 위치의 캐릭터는, 추출되는 string에는 포함되지 않습니다. 이 Parameters를 생략 하면,`charCount` 가 사용됩니다. 이 값이 `beginIndex` 로 지정된 값과 같은가 작은 경우,`beginIndex + 1` 이 사용됩니다.

반환값

Boolean — 지정된 범위의 적어도 1 캐릭터가, 대응하는 setSelected() Methods로 선택되고 있는지 어떤지를 나타내는 불리언 값입니다. 선택되고 있는 경우는 true, 선택되어 있지 않은 경우는 false 입니다.

getSelectedText

()

Methods

public function getSelectedText(includeLineEndings:Boolean = false):String

대응하는 setSelected() Methods로 지정된 모든 캐릭터를 포함한 string를 돌려줍니다. setSelected() Methods로 캐릭터가 지정되지 않는 경우는, empty의 string가 돌려주어집니다.

includeLineEndings 에 true 를 지정했을 경우는, 돌려주어지는 string에 개행 캐릭터 (newline)가 삽입되어 돌려주어지는 string는 입력 범위보다 길어지는 경우가 있습니다. includeLineEndings 에 false 를 지정했을 경우, 또는 생략 했을 경우는, 어떤 캐릭터도 추가되지 않고 선택된 텍스트가 돌려주어집니다.

Parameters

includeLineEndings:Boolean (default = false) — 불리언 값입니다. 반환값의 string의 적절한 개소에, 개행 캐릭터 (newline)를 삽입할지 어떨지를 지정합니다. 이 Parameters는 옵션입니다. 디폴트치는 false 입니다.

반환값

String — 대응하는 setSelected() 커멘드로 지정된 모든 캐릭터를 포함한 string입니다.

getText

()

Methods

public function getText(beginIndex:int , endIndex:int , includeLineEndings:Boolean = false):String

beginIndex Parameters와 endIndex Parameters로 지정된 모든 캐릭터를 포함한 string를 돌려줍니다. 선택된 캐릭터가 존재하지 않는 경우는, empty의 string가 돌려주어집니다.

모든 캐릭터를 취득하려면 ,beginIndex 에는 0 을 지정해,endIndex 에는 charCount (또는 충분히 큰 수치)를 지정합니다. 1 개의 캐릭터만을 돌려주는 경우는,endIndex 에 beginIndex + 1 을 지정합니다.

includeLineEndings 에 true 를 지정했을 경우는, 돌려주어진 string의 적당한 위치에 개행 캐릭터 (newline)가 삽입됩니다. 이 경우, 돌려주어지는 string는, 입력 범위보다 길어지는 경우가 있습니다. includeLineEndings 에 false 를 지정했을 경우, 또는 생략 했을 경우는, 어떤 캐릭터도 추가되지 않고 선택된 텍스트가 돌려주어집니다.

Parameters

	`beginIndex:int` — 돌려주어지는 string에 포함되는 선두 캐릭터의 위치를 나타냅니다. `beginIndex` 로 지정할 수 있는 값은,`0` ~ `charCount - 1` 입니다. `beginIndex` 가 부의 값의 경우,`0` 이 사용됩니다.

	`endIndex:int` — 검사하는 마지막 캐릭터의 인덱스에 1 을 더한 값입니다. `endIndex` 로 지정할 수 있는 값은,`0` ~ `charCount` 입니다. `endIndex` Parameters로 지정된 인덱스 위치의 캐릭터는, 추출되는 string에는 포함되지 않습니다. 이 Parameters를 생략 하면,`charCount` 가 사용됩니다. 이 값이 `beginIndex` 로 지정된 값과 같은가 작은 경우,`beginIndex + 1` 이 사용됩니다.

	`includeLineEndings:Boolean` (default = `false`) — 불리언 값입니다. 반환값의 string에 개행 캐릭터 (newline)를 삽입하는지 (`true`), 또는 삽입하지 않는가 (`false`)를 지정합니다. 이 Parameters는 옵션입니다. 디폴트치는 `false` 입니다.

반환값

String — 지정된 범위의 캐릭터를 포함한 string. 지정된 범위에 캐릭터가 존재하지 않는 경우는 empty의 string입니다.

getTextRunInfo

()

Methods

public function getTextRunInfo(beginIndex:int , endIndex:int ):Array

연속한 텍스트에 관한 정보를 포함한 object의 배열을 돌려줍니다. 각 object는, 2 개의 Methods Parameters로 지정한 캐릭터 범위내의 1 개의 캐릭터에 대응합니다.

메모 :큰 범위의 텍스트에 대해서 getTextRunInfo() Methods를 사용하면, 큰 object를 돌려줄 수가 있습니다. beginIndex Parameters 및 endIndex Parameters로 정의하는 텍스트 범위를 제한하는 것을 추천합니다.

Parameters

	`beginIndex:int` — TextSnapshot object내의 캐릭터 범위내의 최초의 캐릭터를 나타내는 인덱스치입니다.

	`endIndex:int` — TextSnapshot object내의 캐릭터 범위내의 마지막 캐릭터를 나타내는 인덱스치입니다.

반환값

Array — beginIndex Parameters 및 endIndex Parameters로 지정된 캐릭터의 범위내의 특정의 캐릭터에 관한 정보가 포함되는 개개의 object로 구성된 object의 배열입니다. 각 object에는, 다음의 11 개의 property가 있습니다.

indexInRun—선택한 연속한 텍스트가 아니고, string 전체를 기준으로 한 캐릭터의 제로로부터 시작되는 정수의 인덱스입니다.
selected—캐릭터가 선택될지 어떨지를 나타내는 불리언 값입니다. 선택되는 경우는 true, 선택되지 않는 경우는 false 입니다.
font—캐릭터의 폰트명입니다.
color—캐릭터의 칼라와 알파 (투명도)의 값의 편성입니다. 16 진수의 최초의 2 자리수는 알파치를 나타내, 나머지의 자리수는 칼라치를 나타냅니다.
height—캐릭터의 높이입니다 (픽셀 단위).
matrix_a,matrix_b,matrix_c,matrix_d,matrix_tx,matrix_ty—캐릭터에 관한 도형 변환을 정의하는 매트릭스치입니다. 통상, 수직 텍스트의 매트릭스는 [1 0 0 1 x y] 의 형식입니다. 여기서, x 와 y 는 친무비 클립내의 캐릭터의 위치입니다. 텍스트의 높이는 관계 없습니다. 이 매트릭스는 친무비 클립의 좌표계에 있어, 그 무비 클립 자신 또는 친무비 클립에서의 변환을 포함하지 않습니다.
corner0x,corner0y,corner1x,corner1y,corner2x,corner2y,corner3x,corner3y—친무비 클립의 좌표계에 근거하는, 캐릭터의 경계 박스의 정점입니다. 이러한 값은, 캐릭터에 사용하는 폰트가 SWF 파일에 포함되고 있는 경우에게만 사용할 수 있습니다.

See also

Matrix class

hitTestTextNearPos

()

Methods

public function hitTestTextNearPos(x:Number , y:Number , maxDistance:Number = 0):Number

TextSnapshot object내의 어느 캐릭터가, TextSnapshot object의 텍스트를 포함한 무비 클립의 지정 좌표 x,y 상또는 그 부근에 존재하는지를 평가합니다.

maxDistance 의 값을 생략 했을 경우 또는 0 을 지정했을 경우,x,y 좌표로 지정되는 위치는, TextSnapshot object의 경계 박스내에 있을 필요가 있습니다.

이 Methods는, 캐릭터 시학 정보를 포함한 폰트를 사용하는 경우에게만 정상적으로 기능합니다. 다만, 디폴트에서는, Flash authoring tool의 정지 텍스트 필드에 이 정보는 포함되지 않습니다. 따라서, 인덱스치 대신에 -1 가 돌려주어집니다. 인덱스치가 돌려주어지도록(듯이), Flash authoring tool로 강제적으로 폰트의 캐릭터 시학 정보를 포함할 수가 있습니다. 이것을 실시하려면 , 그 폰트를 사용하는 다이나믹 텍스트 필드를 추가해, 그 다이나믹 텍스트 필드로 [캐릭터 옵션] 을 선택해, 포함하는 폰트의 아우트라인을 1 개 이상의 캐릭터에 대해서 지정합니다. 어느 캐릭터를 지정해도, 정지 텍스트 필드로 그 캐릭터가 사용되고 있어도 괜찮습니다.

Parameters

	`x:Number` — 텍스트를 포함한 무비 클립의 `x` 좌표를 나타내는 수치입니다.

	`y:Number` — 텍스트를 포함한 무비 클립의 `y` 좌표를 나타내는 수치입니다.

	`maxDistance:Number` (default = `0`) — 텍스트의 검색이 가능한,`x`,`y` 로부터의 최대 거리를 나타내는 수치입니다. 이 Parameters는 옵션입니다. 이 거리는, 각 캐릭터의 중심 위치를 기준으로 해 측정됩니다. 디폴트치는 `0` 입니다.

반환값

Number — 지정된 x 및 y 좌표에 가장 가까운 캐릭터의 인덱스치를 나타내는 수치입니다. 캐릭터가 발견되지 않는 경우, 또는 폰트에 캐릭터 시학 정보가 포함되지 않은 경우에는 -1 을 돌려줍니다.

setSelectColor

()

Methods

public function setSelectColor(hexColor:uint = 0xFFFF00):void

setSelected() Methods로 선택된 캐릭터를 강조 표시할 경우에 사용하는 색을 지정합니다. 항상 투명색이 사용됩니다. 투명도치를 지정할 수 없습니다.

Parameters

hexColor:uint (default = 0xFFFF00) — 대응하는 setSelected() 커멘드로 선택된 캐릭터의 경계에 사용하는 색입니다. 16 진수 형식 (0xRRGGBB)에서 지정합니다.

See also

flash.text.TextSnapshot.setSelected()

setSelected

()

Methods

public function setSelected(beginIndex:int , endIndex:int , select:Boolean ):void

선택 또는 선택 해제하는 TextSnapshot object의 캐릭터 범위를 지정합니다. 선택된 캐릭터는, 캐릭터의 경계 박스에 맞추어 배경색첨부의 구형으로 묘화 됩니다. 경계 박스의 색은,setSelectColor() 로 정의됩니다.

모든 캐릭터를 선택 또는 선택 해제하는데는,beginIndex 에는 0 을 지정해,endIndex 에는 charCount (또는 충분히 큰 수치)를 지정합니다. 1 개의 캐릭터만을 지정하는 경우는,endIndex 에 start + 1 을 지정합니다.

캐릭터의 선택 상태는 개개에 마킹 되기 (위해)때문에, 이 Methods를 몇회인가 호출하는 것으로, 복수의 캐릭터를 선택할 수 있습니다. 즉, 이 Methods를 사용해도, 이미 이 Methods로 선택되고 있는 다른 캐릭터에 대해서는 선택 해제되지 않습니다.

선택 범위를 나타내는 색첨부의 구형은, 캐릭터 시학 정보를 포함한 폰트 에 대해서만 표시됩니다. 디폴트에서는, 정지 텍스트 필드에는 이 정보는 포함되지 않습니다. 이것이 원인으로, 선택된 텍스트가 화면에 선택 상태로 표시되지 않는 경우가 있습니다. 선택된 텍스트 전체가 선택 상태로 표시되도록(듯이), Flash authoring tool로 강제적으로 폰트의 캐릭터 시학 정보를 포함할 수가 있습니다. 이것을 실시하려면 , 그 폰트를 사용하는 다이나믹 텍스트 필드를 추가해, 그 다이나믹 텍스트 필드로 [캐릭터 옵션] 을 선택해, 포함하는 폰트의 아우트라인을 1 개 이상의 캐릭터에 대해서 지정합니다. 어느 캐릭터를 지정해도, 대상이 되는 정지 텍스트 필드로 그 캐릭터가 사용되고 있어도 괜찮습니다.

Parameters

	`beginIndex:int` — 선택을 개시하는 캐릭터의 위치를 나타냅니다. `beginIndex` 로 지정할 수 있는 값은,`0` ~ `charCount - 1` 입니다. `beginIndex` 가 부의 값의 경우,`0` 이 사용됩니다.

	`endIndex:int` — 검사하는 마지막 캐릭터의 인덱스에 1 을 더한 정수입니다. `end` 로 지정할 수 있는 값은,`0` ~ `charCount` 입니다. `end` Parameters로 지정된 인덱스 위치의 캐릭터는, 꺼내지는 string에는 포함되지 않습니다. 이 Parameters를 생략 하면,`TextSnapshot.charCount` 가 사용됩니다. `beginIndex` 의 값이 `endIndex` 로 지정된 값과 같은가 작은 경우,`beginIndex + 1` 이 사용됩니다.

	`select:Boolean` — 텍스트를 선택할지 어떨지를 지정하는 불리언 값입니다. 선택하는 경우는 `true`, 선택 해제하는 경우는 `false` 입니다.

Adobe® Flex™ 2 Language Reference		모든 패키지 \| 모든 클래스 \| 언어 엘리먼트 \| 색인 \| 부록 \| 규칙 \| 프레임내에 표시 프레임 없음 버젼
Class TextSnapshot	property \| Methods

Package	flash.text
Class	public class TextSnapshot
Inheritance	TextSnapshot Object