TextSnapshot - Adobe ActionScript® 3 (AS3 ) API 참조 설명서

패키지	flash.text
클래스	public class TextSnapshot
상속	TextSnapshot Object

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9, Flash Lite 4

TextSnapshot 객체를 사용하면 동영상 클립에서 정적 텍스트를 처리할 수 있습니다. 예를 들어 이 객체를 사용하여 동적 텍스트보다 훨씬 더 정밀하게 텍스트를 배치할 수 있습니다. 그러나 텍스트에는 여전히 읽기 전용으로만 액세스할 수 있습니다.

TextSnapshot 객체를 만드는 데는 생성자를 사용하지 않습니다. 이 객체는 flash.display.DisplayObjectContainer.textSnapshot 속성을 통해 반환됩니다.

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		charCount : int [읽기 전용] TextSnapshot 객체의 문자 수입니다.	TextSnapshot
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		findText(beginIndex:int, textToFind:String, caseSensitive:Boolean):int 지정된 TextSnapshot 객체를 검색하고 시작 인덱스 이후에 찾을 텍스트가 처음 발견되는 위치를 반환합니다.	TextSnapshot
		getSelected(beginIndex:int, endIndex:int):Boolean 지정된 범위 내에서 선택된 텍스트가 TextSnapshot 객체에 포함되는지 여부를 지정하는 부울 값을 반환합니다.	TextSnapshot
		getSelectedText(includeLineEndings:Boolean = false):String 해당 setSelected() 메서드에 의해 지정된 모든 문자가 포함된 문자열을 반환합니다.	TextSnapshot
		getText(beginIndex:int, endIndex:int, includeLineEndings:Boolean = false):String beginIndex 및 endIndex 매개 변수로 지정된 모든 문자가 들어 있는 문자열을 반환합니다.	TextSnapshot
		getTextRunInfo(beginIndex:int, endIndex:int):Array 텍스트 흐름에 대한 정보가 들어 있는 객체 배열을 반환합니다.	TextSnapshot
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		hitTestTextNearPos(x:Number, y:Number, maxDistance:Number = 0):Number TextSnapshot 객체 내의 문자 중 TextSnapshot 객체의 텍스트가 들어 있는 동영상 클립에서 지정된 x, y 좌표에 있거나 가까이 있는 문자를 확인할 수 있습니다.	TextSnapshot
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		setSelectColor(hexColor:uint = 0xFFFF00):void setSelected() 메서드로 선택한 문자를 강조 표시하는 데 사용할 색상을 지정합니다.	TextSnapshot
		setSelected(beginIndex:int, endIndex:int, select:Boolean):void TextSnapshot 객체에서 선택하거나 선택을 취소할 문자 범위를 지정합니다.	TextSnapshot
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String 지정된 객체의 문자열 표현을 반환합니다.	Object
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object

속성 세부 정보

charCount

속성

charCount:int [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9, Flash Lite 4

TextSnapshot 객체의 문자 수입니다.

구현
public function get charCount():int

관련 API 요소

flash.text.TextSnapshot.getText()

메서드 세부 정보

findText

()

메서드

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

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9, Flash Lite 4

지정된 TextSnapshot 객체를 검색하고 beginIndex 이후에서 textToFind가 처음 발견되는 위치를 반환합니다. textToFind이 없으면 메서드는 -1을 반환합니다.

매개 변수

	`beginIndex:int` — 지정된 텍스트를 찾기 시작할 위치를 지정합니다.

	`textToFind:String` — 검색할 텍스트를 지정합니다. String 유형의 변수 대신 문자열 리터럴을 지정하려면 문자열을 따옴표로 묶습니다.

	`caseSensitive:Boolean` — 텍스트와 `textToFind`의 문자열이 대/소문자가 일치해야 하는지 여부를 지정합니다.

반환값

int — 지정된 텍스트가 처음으로 발견되는 인덱스 위치(0부터 시작) 또는 -1입니다.

관련 API 요소

flash.text.TextSnapshot.getText()

getSelected

()

메서드

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

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9, Flash Lite 4

지정된 범위 내에서 선택된 텍스트가 TextSnapshot 객체에 포함되는지 여부를 지정하는 부울 값을 반환합니다.

모든 문자를 검색하려면 start에 0 값을 전달하고, end에 charCount(또는 임의의 매우 큰 수)를 전달합니다. 단일 문자를 검색하려면 end 매개 변수에 start 매개 변수보다 하나 더 큰 값을 전달합니다.

매개 변수

	`beginIndex:int` — 검사할 첫 번째 문자의 위치를 나타냅니다. `beginIndex`에 유효한 값은 `0`에서 `TextSnapshot.charCount - 1` 사이입니다. `beginIndex`가 음수이면 `0`이 사용됩니다.

	`endIndex:int` — 검사할 마지막 문자의 인덱스에 1을 더한 값입니다. `endIndex`에 유효한 값은 `0`에서 `charCount` 사이입니다. `endIndex` 매개 변수로 인덱싱된 문자는 추출된 문자열에 포함되지 않습니다. 이 매개 변수를 생략하면 `charCount`가 사용됩니다. 이 값이 `beginIndex`보다 작거나 같으면 `beginIndex + 1`이 사용됩니다.

반환값

Boolean — 지정된 범위에서 최소한 하나의 문자가 해당 setSelected() 메서드를 통해 선택되었는지 여부를 true 또는 false로 나타내는 부울 값입니다.

getSelectedText

()

메서드

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

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9., Flash Lite 4

해당 setSelected() 메서드에 의해 지정된 모든 문자가 포함된 문자열을 반환합니다. setSelected() 메서드에 의해 지정된 문자가 없으면 빈 문자열이 반환됩니다.

includeLineEndings에 true를 전달하면 반환 문자열에 개행 문자가 삽입되어 반환 문자열이 입력 범위보다 길어질 수 있습니다. includeLineEndings가 false이거나 생략된 경우 메서드는 문자를 추가하지 않고 선택한 텍스트를 반환합니다.

매개 변수

includeLineEndings:Boolean (default = false) — 반환 문자열에서 적절한 위치에 개행 문자를 삽입할지 여부를 지정하는 부울 값으로서 선택 사항입니다. 기본값은 false입니다.

반환값

String — 해당 setSelected() 명령으로 지정한 모든 문자가 포함된 문자열입니다.

getText

()

메서드

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

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9., Flash Lite 4

beginIndex 및 endIndex 매개 변수에 의해 지정된 모든 문자가 들어 있는 문자열을 반환합니다. 선택된 문자가 없으면 빈 문자열이 반환됩니다.

모든 문자를 반환하려면 beginIndex에 0 값을 전달하고 endIndex에 charCount(또는 임의의 매우 큰 수)를 전달합니다. 단일 문자를 반환하려면 endIndex에 beginIndex + 1 값을 전달합니다.

includeLineEndings에 true 값을 전달하면 반환 문자열에서 적절한 위치에 개행 문자가 삽입됩니다. 이 경우 반환 문자열이 입력 범위보다 길어질 수 있습니다. includeLineEndings가 false이거나 생략되면 문자가 추가되지 않고 선택한 텍스트가 그대로 반환됩니다.

매개 변수

	`beginIndex:int` — 반환 문자열에 포함될 첫 번째 문자의 위치를 나타냅니다. `beginIndex`에 유효한 값은 `0`에서 `charCount - 1` 사이입니다. `beginIndex`가 음수이면 `0`이 사용됩니다.

	`endIndex:int` — 검사할 마지막 문자의 인덱스에 1을 더한 값입니다. `endIndex`에 유효한 값은 `0`에서 `charCount` 사이입니다. `endIndex` 매개 변수로 인덱싱된 문자는 추출된 문자열에 포함되지 않습니다. 이 매개 변수를 생략하면 `charCount`가 사용됩니다. 이 값이 `beginIndex`보다 작거나 같으면 `beginIndex + 1`이 사용됩니다.

	`includeLineEndings:Boolean` (default = `false`) — 선택 요소로서, 반환 문자열에 개행 문자를 삽입할지 여부를 `true` 또는 `false`로 지정하는 부울 값입니다. 기본값은 `false`입니다.

반환값

String — 지정된 범위의 문자가 포함된 문자열입니다. 지정된 범위에서 문자를 찾을 수 없는 경우에는 빈 문자열입니다.

getTextRunInfo

()

메서드

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

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9, Flash Lite 4

텍스트 흐름에 대한 정보가 들어 있는 객체 배열을 반환합니다. 각 객체는 두 개의 메서드 매개 변수에 의해 지정된 문자 범위의 한 문자에 해당합니다.

참고: 큰 범위의 텍스트에 getTextRunInfo() 메서드를 사용하면 큰 객체가 반환될 수 있습니다. 따라서 beginIndex 및 endIndex 매개 변수로 정의되는 텍스트 범위를 제한하는 것이 좋습니다.

매개 변수

	`beginIndex:int` — TextSnapshot 객체의 문자 범위에서 첫 번째 문자의 인덱스 값입니다.

	`endIndex:int` — TextSnapshot 객체의 문자 범위에서 마지막 문자의 인덱스 값입니다.

반환값

Array — 각각 beginIndex 및 endIndex 매개 변수로 지정한 문자 범위의 특정 문자에 대한 정보가 들어 있는 객체로 이루어진 객체 배열입니다. 각 객체에는 다음과 같은 11가지 속성이 들어 있습니다.

indexInRun - 선택한 텍스트 흐름이 아닌 전체 문자열을 기준으로 하는 문자의 정수 인덱스(0부터 시작)입니다.
selected - 문자가 선택되었는지 여부를 true 또는 false로 나타내는 부울 값입니다.
font - 문자의 글꼴 이름입니다.
color - 문자의 알파 값과 색상 값의 결합입니다. 처음 두 자리의 16진수 숫자는 알파 값을 나타내고 나머지 자리의 숫자는 색상 값을 나타냅니다.
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 파일에 포함되어 있는 경우에만 사용할 수 있습니다.

관련 API 요소

Matrix 클래스

hitTestTextNearPos

()

메서드

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

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9., Flash Lite 4

TextSnapshot 객체 내의 문자 중 TextSnapshot 객체의 텍스트가 들어 있는 동영상 클립에서 지정된 x, y 좌표에 있거나 가까이 있는 문자를 확인할 수 있습니다.

maxDistance의 값을 생략하거나 값으로 0을 전달한 경우 x, y 좌표로 지정한 위치는 TextSnapshot 객체의 경계 상자 내부에 있어야 합니다.

이 메서드는 문자 메트릭 정보가 포함된 글꼴에서만 제대로 작동하지만 기본적으로 Flash 제작 도구에서는 정적 텍스트 필드에 이 정보가 포함되지 않습니다. 따라서, 이 메서드는 인덱스 값 대신 -1을 반환할 수 있습니다. 인덱스 값이 반환되도록 하려면 Flash 제작 도구가 글꼴에 대한 문자 메트릭 정보를 포함하도록 지정할 수 있습니다. 이렇게 하려면 해당 글꼴을 사용하는 동적 텍스트 필드를 추가하고 동적 텍스트 필드에 대한 문자 옵션을 선택한 다음 적어도 하나 이상의 문자에 대해 글꼴 외곽선이 포함되도록 지정합니다. 어떤 문자를 지정하는지 또는 정적 텍스트 필드에 사용되는 문자인지 여부는 중요하지 않습니다.

매개 변수

	`x:Number` — 텍스트가 들어 있는 동영상 클립의 `x` 좌표를 나타내는 숫자입니다.

	`y:Number` — 텍스트가 들어 있는 동영상 클립의 `y` 좌표를 나타내는 숫자입니다.

	`maxDistance:Number` (default = `0`) — 선택 요소로서, `x`, `y` 좌표를 기준으로 텍스트를 검색할 수 있는 최대 거리를 나타내는 숫자입니다. 이 거리는 각 문자의 중심점으로부터 측정됩니다. 기본값은 `0`입니다.

반환값

Number — 지정된 x, y 좌표에 가장 가까이 있는 문자의 인덱스 값을 나타내는 숫자입니다. 문자를 찾지 못했거나 글꼴에 문자 메트릭 정보가 없는 경우에는 -1이 반환됩니다.

setSelectColor

()

메서드

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

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9., Flash Lite 4

setSelected() 메서드로 선택한 문자를 강조 표시하는 데 사용할 색상을 지정합니다. 이 색상은 항상 불투명하므로 투명도 값을 지정할 수 없습니다.

이 메서드는 문자 메트릭 정보가 포함된 글꼴에서만 제대로 작동하지만 기본적으로 Flash 제작 도구에서는 정적 텍스트 필드에 이 정보가 포함되지 않습니다. 따라서 메서드가 인덱스 값 대신 -1을 반환할 수 있습니다. 인덱스 값이 반환되도록 하려면 Flash 제작 도구가 글꼴에 대한 문자 메트릭 정보를 포함하도록 지정할 수 있습니다. 이렇게 하려면 해당 글꼴을 사용하는 동적 텍스트 필드를 추가하고 동적 텍스트 필드에 대한 문자 옵션을 선택한 다음 적어도 하나 이상의 문자에 대해 글꼴 외곽선이 포함되도록 지정합니다. 어떤 문자를 지정하는지 또는 정적 텍스트 필드에 사용되는 문자인지 여부는 중요하지 않습니다.

매개 변수

hexColor:uint (default = 0xFFFF00) — 해당 setSelected() 명령으로 선택한 문자 주위의 테두리에 사용되는 색상으로, 16진수 형식(0x RRGGBB)으로 표현됩니다.

관련 API 요소

flash.text.TextSnapshot.setSelected()

setSelected

()

메서드

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

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9., Flash Lite 4

TextSnapshot 객체에서 선택하거나 선택을 취소할 문자 범위를 지정합니다. 선택된 문자는 그 뒤에 색상이 지정된 사각형으로 그려집니다. 이 사각형은 해당 문자의 경계 상자와 일치합니다. 경계 상자의 색상은 setSelectColor()로 정의됩니다.

모든 문자를 선택하거나 선택을 취소하려면 beginIndex에 0 값을 전달하고 endIndex에 charCount(또는 임의의 매우 큰 수)를 전달합니다. 단일 문자를 지정하려면 endIndex에 start + 1 값을 전달합니다.

문자는 개별적으로 선택된 것으로 표시되므로 여러 문자를 선택하려면 이 메서드를 여러 번 호출하면 됩니다. 즉, 이 메서드를 사용해도 이 메서드에서 설정한 다른 문자의 선택이 해제되지 않습니다.

선택 영역을 나타내는 색상이 지정된 사각형은 문자 메트릭 정보가 포함된 글꼴에만 표시됩니다. Flash는 기본적으로 정적 텍스트 필드에 이 정보를 포함하지 않습니다. 이로 인해 경우에 따라 선택한 텍스트가 화면에서 선택된 상태로 표시되지 않을 수 있습니다. 선택한 모든 텍스트를 선택된 것으로 표시하려면 Flash 제작 도구가 글꼴에 대한 문자 메트릭 정보를 포함하도록 지정할 수 있습니다. 이렇게 하려면 해당 글꼴을 사용하는 동적 텍스트 필드를 추가하고 동적 텍스트 필드에 대한 문자 옵션을 선택한 다음 적어도 하나 이상의 문자에 대해 글꼴 외곽선이 포함되도록 지정합니다. 어떤 문자를 지정하는지 또는 그 문자가 정적 텍스트 필드에 사용되는지 여부는 중요하지 않습니다.

매개 변수

	`beginIndex:int` — 선택할 첫 번째 문자의 위치를 나타냅니다. `beginIndex`에 유효한 값은 `0`에서 `charCount - 1` 사이입니다. `beginIndex`가 음수이면 `0`이 사용됩니다.

	`endIndex:int` — 검사할 마지막 문자의 인덱스에 1을 더한 정수입니다. `end`에 유효한 값은 `0`에서 `charCount` 사이입니다. `end` 매개 변수로 인덱싱된 문자는 추출된 문자열에 포함되지 않습니다. 이 매개 변수를 생략하면 `TextSnapshot.charCount`가 사용됩니다. `beginIndex` 값이 `endIndex` 값보다 작거나 같으면 `beginIndex + 1`이 사용됩니다.

	`select:Boolean` — 텍스트 선택 여부를 `true` 또는 `false`로 지정하는 부울 값입니다.

법적 고지 사항 | 온라인 개인 정보 보호 정책

TextSnapshot - AS3

패키지x

언어 요소

부록

패키지 flash.text

charCount

findText

getSelected

getSelectedText

getText

getTextRunInfo

hitTestTextNearPos

setSelectColor

setSelected