HTMLLoader

패키지	flash.html
클래스	public class HTMLLoader
상속	HTMLLoader Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
하위 클래스	FlexHTMLLoader

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

HTMLLoader 클래스는 HTML 내용의 컨테이너인 표시 객체의 유형을 정의합니다.

AIR 프로파일 지원: 이 기능은 모든 데스크톱 운영 체제에서 지원되지만 휴대 장치나 AIR for TV 장치에서는 지원되지 않습니다. HTMLLoader.isSupported 속성을 사용하여 런타임에 지원을 테스트할 수 있습니다. 여러 프로파일 간 API 지원에 대한 자세한 내용은 AIR 프로파일 지원을 참조하십시오.

데스크톱 컴퓨터(데스크톱 및 확장 데스크톱 프로파일 내)에서 HTMLLoader 클래스는 내부 AIR WebKit 엔진을 사용합니다. 사용 가능한 기능 및 렌더링 모양은 StageWebView 클래스와 동일하며, ActionScript와 JavaScript 간의 긴밀한 통합 및 스크립트 브리징이 포함됩니다. StageWebView 클래스는 Flash Player 플러그인이 제공하는 시스템 웹 컨트롤을 사용하므로 StageWebView 인스턴스와 HTMLLoader 인스턴스를 동시에 사용하는 것은 좋지 않습니다. 정의되지 않은 비헤이비어가 발생하고 응용 프로그램이 종료될 수도 있기 때문입니다.

HTMLLoader의 기본 크기는 0 x 0 픽셀입니다. HTMLLoader 객체가 표시되도록 하려면 width 및 height 속성을 설정하십시오.

HTMLLoader 객체의 최대 크기는 높이 4,096픽셀 및 폭 4,096픽셀입니다. HTMLLoader 객체의 width 또는 height를 4,095보다 큰 숫자로 설정하면 HTMLLoader 객체에서 ArgumentError 예외가 발생합니다. 참고로, AIR 2 이전 버전에서는 HTMLLoader 객체의 최대 크기가 2,880픽셀이었습니다.

참고: HTML 페이지에 포함된 SWF 내용이 투명 윈도우에 표시되는 경우, transparent 또는 opaque wmode를 사용하여 내용을 포함해야 합니다. wmode의 기본값은 window이므로 값을 지정하지 않으면 SWF 내용이 표시되지 않을 수 있습니다. Windows와 Linux에서 wmode를 window 또는 opaque로 설정하면 SWF 내용은 항상 다른 내용 위에 나타납니다. 어느 wmode 설정을 사용하든 PDF 내용은 투명 윈도우에 표시할 수 없습니다.

예제 보기

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		accessibilityImplementation : AccessibilityImplementation 이 InteractiveObject 인스턴스에 대한 현재 액세스 가능성 구현(AccessibilityImplementation)입니다.	InteractiveObject
		accessibilityProperties : AccessibilityProperties 이 표시 객체의 현재 액세스 가능성 옵션입니다.	DisplayObject
		alpha : Number 지정된 객체의 알파 투명도 값을 나타냅니다.	DisplayObject
		authenticate : Boolean 이 객체에 의해 실행된 HTTP 요청에 대한 인증 요청을 처리할지(true) 아니면 처리하지 않을지(false)를 지정합니다.	HTMLLoader
		blendMode : String 사용할 블렌드 모드를 지정하는 BlendMode 클래스 값입니다.	DisplayObject
		blendShader : Shader [쓰기 전용] 전경 및 배경을 블렌딩하는 데 사용되는 셰이더를 설정합니다.	DisplayObject
		buttonMode : Boolean 이 Sprite의 버튼 모드를 지정합니다.	Sprite
		cacheAsBitmap : Boolean true로 설정된 경우 Flash 런타임은 표시 객체의 내부 비트맵 표현을 캐시합니다.	DisplayObject
		cacheAsBitmapMatrix : Matrix null이 아닌 경우 이 Matrix 객체는 cacheAsBitmap이 true로 설정될 때 표시 객체가 렌더링되는 방법을 정의합니다.	DisplayObject
		cacheResponse : Boolean 이 객체에 의해 실행된 HTTP 요청에 대해 성공한 응답 데이터를 캐시할지 여부를 지정합니다.	HTMLLoader
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		contentHeight : Number [읽기 전용] HTML 내용의 높이(픽셀 단위)입니다.	HTMLLoader
		contentWidth : Number [읽기 전용] HTML 내용의 폭(픽셀 단위)입니다.	HTMLLoader
		contextMenu : NativeMenu 이 객체에 연결된 컨텍스트 메뉴를 지정합니다.	InteractiveObject
		doubleClickEnabled : Boolean 이 객체에서 doubleClick 이벤트를 받을지 여부를 지정합니다.	InteractiveObject
		dropTarget : DisplayObject [읽기 전용] 드래그하는 Sprite 아래의 표시 객체 또는 Sprite를 드래그해 놓은 표시 객체를 지정합니다.	Sprite
		filters : Array 현재 표시 객체와 연관된 각 필터 객체가 들어 있는 인덱싱된 배열입니다.	DisplayObject
		focusRect : Object 이 객체에서 포커스 사각형을 표시할지 여부를 지정합니다.	InteractiveObject
		graphics : Graphics [읽기 전용] 벡터 드로잉 명령을 내릴 수 있는 이 Sprite에 속한 Graphics 객체를 지정합니다.	Sprite
		hasFocusableContent : Boolean [읽기 전용] HTMLLoader 객체의 내용이 포커스를 가질 수 있는지 여부를 나타냅니다.	HTMLLoader
		height : Number [재정의] 렌더링되는 HTML 캔바스의 직사각형 높이를 지정합니다.	HTMLLoader
		historyLength : uint [읽기 전용] 앞뒤 항목을 비롯한 기록 목록의 전체 길이입니다.	HTMLLoader
		historyPosition : uint 기록 목록에서의 현재 위치입니다.	HTMLLoader
		hitArea : Sprite Sprite의 히트 영역으로 사용할 다른 Sprite를 지정합니다.	Sprite
		htmlHost : flash.html:HTMLHost 특정 사용자 인터페이스 요소에 대한 변경 내용을 처리하는 데 사용되는 HTMLHost 객체입니다(예: HTMLLoader 객체의 window.document.title 속성).	HTMLLoader
		idleTimeout : Number 이 객체가 보낸 HTTP 요청에 대해 유휴 시간 초과 값(밀리초 단위)을 지정합니다.	HTMLLoader
		isSupported : Boolean [정적] [읽기 전용] 클라이언트 시스템에서 HTMLLoader 클래스를 지원하는지 여부를 나타냅니다.	HTMLLoader
		loaded : Boolean [읽기 전용] 이전 load() 또는 loadString() 메서드 호출에 해당하는 JavaScript load 이벤트가 HTMLLoader 객체의 HTML DOM으로 전달되었는지 여부를 나타냅니다.	HTMLLoader
		loaderInfo : LoaderInfo [읽기 전용] 이 표시 객체가 속한 파일의 로딩 정보가 포함된 LoaderInfo 객체를 반환합니다.	DisplayObject
		location : String [읽기 전용] HTMLLoader 객체에 로드되는 내용의 URL입니다.	HTMLLoader
		manageCookies : Boolean HTTP 프로토콜 스택이 이 객체의 쿠키를 관리하는지 여부를 지정합니다.	HTMLLoader
		mask : DisplayObject 호출하는 표시 객체는 지정된 mask 객체에 의해 마스크 처리됩니다.	DisplayObject
		metaData : Object PlaceObject4 태그를 통해 SWF 파일에 해당 DisplayObject의 인스턴스와 함께 메타데이터가 저장된 경우 DisplayObject 인스턴스의 메타데이터 객체를 가져옵니다.	DisplayObject
		mouseChildren : Boolean 해당 객체의 자식에서 마우스 또는 사용자 입력 장치가 사용하도록 설정되어 있는지 여부를 결정합니다.	DisplayObjectContainer
		mouseEnabled : Boolean 이 객체가 마우스 또는 기타 사용자 입력, 메시지를 수신할지 여부를 지정합니다.	InteractiveObject
		mouseX : Number [읽기 전용] 마우스 또는 사용자 입력 장치 위치의 x 좌표를 픽셀로 나타냅니다.	DisplayObject
		mouseY : Number [읽기 전용] 마우스 또는 사용자 입력 장치 위치의 y 좌표를 픽셀로 나타냅니다.	DisplayObject
		name : String DisplayObject의 인스턴스 이름을 나타냅니다.	DisplayObject
		navigateInSystemBrowser : Boolean HTML 내용에 있는 루트 프레임의 탐색(예: 사용자가 링크를 클릭하거나 window.location 속성이 설정되거나 window.open()을 호출한 경우)이 HTMLLoader 객체에서 탐색될지(false) 아니면 기본 시스템 웹 브라우저에서 탐색될지(true)를 지정합니다.	HTMLLoader
		needsSoftKeyboard : Boolean 이 InteractiveObject 인스턴스가 포커스를 받을 때 가상 키보드(화면의 소프트웨어 키보드)를 표시할지 여부를 지정합니다.	InteractiveObject
		numChildren : int [읽기 전용] 이 객체의 자식 수를 반환합니다.	DisplayObjectContainer
		opaqueBackground : Object 표시 객체를 특정 배경색으로 불투명하게 처리할지 여부를 지정합니다.	DisplayObject
		paintsDefaultBackground : Boolean HTMLLoader 문서의 배경을 불투명한 흰색으로 설정할지(true) 아니면 설정하지 않을지(false)를 지정합니다.	HTMLLoader
		parent : DisplayObjectContainer [읽기 전용] 이 표시 객체가 포함된 DisplayObjectContainer 객체를 나타냅니다.	DisplayObject
		pdfCapability : int [정적] [읽기 전용] 사용자 시스템에 대한 PDF 지원 유형으로, 정수 코드 값으로 정의됩니다.	HTMLLoader
		placeLoadStringContentInApplicationSandbox : Boolean loadString() 메서드를 통해 로드된 내용이 응용 프로그램 샌드박스(true)에 배치되는지 비응용 프로그램 샌드박스(false)에 배치되는지 지정합니다.	HTMLLoader
		root : DisplayObject [읽기 전용] 로드된 SWF 파일에 있는 표시 객체의 경우, 해당 SWF 파일이 나타내는 표시 목록의 트리 구조 부분에서 맨 위에 위치하는 표시 객체가 루트 속성이 됩니다.	DisplayObject
		rotation : Number DisplayObject 인스턴스가 원점으로부터 회전한 각도입니다.	DisplayObject
		rotationX : Number DisplayObject 인스턴스가 3D parent 컨테이너를 기준으로 원점으로부터 x축 회전한 각도를 나타냅니다.	DisplayObject
		rotationY : Number DisplayObject 인스턴스가 3D parent 컨테이너를 기준으로 원점으로부터 y축 회전한 각도를 나타냅니다.	DisplayObject
		rotationZ : Number DisplayObject 인스턴스가 3D parent 컨테이너를 기준으로 원점으로부터 z축 회전한 각도를 나타냅니다.	DisplayObject
		runtimeApplicationDomain : ApplicationDomain HTML 페이지의 JavaScript에서 window.runtime 객체가 사용하는 응용 프로그램 도메인입니다.	HTMLLoader
		scale9Grid : Rectangle 현재 적용 중인 크기 조절 격자입니다.	DisplayObject
		scaleX : Number 등록 포인트에서 적용된 객체의 가로 크기(백분율)를 나타냅니다.	DisplayObject
		scaleY : Number 객체의 등록 포인트에서 적용된 객체의 세로 크기(백분율)를 나타냅니다.	DisplayObject
		scaleZ : Number 객체의 등록 포인트에서 적용된 객체의 깊이 크기(백분율)를 나타냅니다.	DisplayObject
		scrollH : Number HTMLLoader 객체에 있는 HTML 내용의 가로 스크롤 위치입니다.	HTMLLoader
		scrollRect : Rectangle 표시 객체의 스크롤 사각형 경계입니다.	DisplayObject
		scrollV : Number HTMLLoader 객체에 있는 HTML 내용의 세로 스크롤 위치입니다.	HTMLLoader
		softKeyboard : String 소프트 키보드의 모양을 제어합니다.	InteractiveObject
		softKeyboardInputAreaOfInterest : Rectangle 소프트 키보드가 표시될 때 화면에서 그대로 유지되는 영역을 정의합니다(iOS에서는 사용할 수 없음).	InteractiveObject
		soundTransform : flash.media:SoundTransform 이 Sprite 내에서 사운드를 제어합니다.	Sprite
		stage : Stage [읽기 전용] 표시 객체의 Stage입니다.	DisplayObject
		swfCapability : int [정적] [읽기 전용] 사용자 시스템에 대한 SWF 지원 유형으로, 정수 코드 값으로 정의됩니다.	HTMLLoader
		tabChildren : Boolean 객체의 자식에서 탭 기능을 사용할 수 있는지 여부를 결정합니다.	DisplayObjectContainer
		tabEnabled : Boolean 이 객체가 탭 순서에 있는지 여부를 지정합니다.	InteractiveObject
		tabIndex : int SWF 파일에서 객체의 탭 순서를 지정합니다.	InteractiveObject
		textEncodingFallback : String HTML 페이지에 문자 인코딩이 지정되지 않은 경우 HTMLLoader 내용에 사용되는 문자 인코딩입니다.	HTMLLoader
		textEncodingOverride : String HTML 페이지의 모든 설정을 재정의하여 HTMLLoader 내용에 사용되는 문자 인코딩입니다.	HTMLLoader
		textSnapshot : flash.text:TextSnapshot [읽기 전용] 이 DisplayObjectContainer 인스턴스에 대한 TextSnapshot 객체를 반환합니다.	DisplayObjectContainer
		transform : flash.geom:Transform 표시 객체의 행렬, 색상 변환 및 픽셀 경계와 관련된 속성을 가진 객체입니다.	DisplayObject
		useCache : Boolean 이 객체에 의해 실행된 HTTP 요청에 따라 데이터를 페치하기 전에 로컬 캐시를 참조할지 여부를 지정합니다.	HTMLLoader
		useHandCursor : Boolean buttonMode 속성이 true로 설정된 스프라이트 위로 포인터를 움직일 때 손 모양(손 모양 커서)을 표시할지 여부를 나타내는 부울 값입니다.	Sprite
		userAgent : String 이 HTMLLoader 객체에서 예정되어 있는 내용 요청에 사용할 사용자 에이전트 문자열입니다.	HTMLLoader
		visible : Boolean 표시 객체가 표시되는지 여부를 나타냅니다.	DisplayObject
		width : Number [재정의] 렌더링되는 HTML 캔바스의 직사각형 폭을 지정합니다.	HTMLLoader
		window : Object [읽기 전용] HTML 컨트롤에 로드되는 내용의 전역 JavaScript 객체입니다.	HTMLLoader
		x : Number 부모 DisplayObjectContainer의 로컬 좌표를 기준으로 DisplayObject 인스턴스의 x 좌표를 나타냅니다.	DisplayObject
		y : Number 부모 DisplayObjectContainer의 로컬 좌표를 기준으로 DisplayObject 인스턴스의 y 좌표를 나타냅니다.	DisplayObject
		z : Number 3D parent 컨테이너를 기준으로 DisplayObject 인스턴스의 z축에 있는 z 좌표 위치를 나타냅니다.	DisplayObject

공용 메서드

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

상속되는 공용 메서드 표시

	메서드		정의 주체
		HTMLLoader() HTMLLoader 객체를 만듭니다.	HTMLLoader
		addChild(child:DisplayObject):DisplayObject 이 DisplayObjectContainer 인스턴스에 자식 DisplayObject 인스턴스를 추가합니다.	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject 이 DisplayObjectContainer 인스턴스에 자식 DisplayObject 인스턴스를 추가합니다.	DisplayObjectContainer
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.	EventDispatcher
		areInaccessibleObjectsUnderPoint(point:Point):Boolean 지정된 point 점으로 DisplayObjectContainer.getObjectsUnderPoint() 메서드를 호출하여 반환된 목록에서 임의의 표시 객체가 보안 제한 사항으로 인해 생략되는지 여부를 나타냅니다.	DisplayObjectContainer
		cancelLoad():void 진행 중인 로드 작업을 취소합니다.	HTMLLoader
		contains(child:DisplayObject):Boolean 지정된 표시 객체가 DisplayObjectContainer 인스턴스의 자식인지 아니면 인스턴스 자체인지를 확인합니다.	DisplayObjectContainer
		createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader [정적] HTMLLoader 객체를 포함하는 새 NativeWindow 객체를 만듭니다.	HTMLLoader
		dispatchEvent(event:Event):Boolean 이벤트를 이벤트 흐름으로 전달합니다.	EventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle targetCoordinateSpace 객체의 좌표계를 기준으로 표시 객체의 영역을 정의하는 사각형을 반환합니다.	DisplayObject
		getChildAt(index:int):DisplayObject 지정된 인덱스에 존재하는 자식 표시 객체 인스턴스를 반환합니다.	DisplayObjectContainer
		getChildByName(name:String):DisplayObject 지정된 이름을 가진 자식 표시 객체를 반환합니다.	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int 자식 DisplayObject 인스턴스의 인덱스 위치를 반환합니다.	DisplayObjectContainer
		getHistoryAt(position:uint):flash.html:HTMLHistoryItem 지정된 위치의 기록 항목을 반환합니다.	HTMLLoader
		getObjectsUnderPoint(point:Point):Array 이 DisplayObjectContainer 인스턴스의 자식(또는 손자 등)으로서 지정된 점 아래에 있는 객체의 배열을 반환합니다.	DisplayObjectContainer
		getRect(targetCoordinateSpace:DisplayObject):Rectangle 대상 좌표 공간 매개 변수에 의해 정의되는 좌표계를 기준으로 모양의 획을 제외하고 표시 객체의 경계를 정의하는 사각형을 반환합니다.	DisplayObject
		globalToLocal(point:Point):Point Point 객체를 Stage 전역 좌표에서 표시 객체의 로컬 좌표로 변환합니다.	DisplayObject
		globalToLocal3D(point:Point):Vector3D Stage(전역) 좌표의 2차원 점을 3차원 표시 객체(로컬) 좌표로 변환합니다.	DisplayObject
		hasEventListener(type:String):Boolean EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		historyBack():void 가능한 경우 브라우저 기록에서 뒤로 이동합니다.	HTMLLoader
		historyForward():void 가능한 경우 브라우저 기록에서 앞으로 이동합니다.	HTMLLoader
		historyGo(steps:int):void 브라우저 기록에서 지정된 단계 수만큼 이동합니다.	HTMLLoader
		hitTestObject(obj:DisplayObject):Boolean 표시 객체의 경계 상자를 평가하여 obj 표시 객체의 경계 상자와 겹치거나 교차하는지 확인합니다.	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean 표시 객체를 평가하여 x 및 y 매개 변수에 의해 지정된 점과 겹치거나 교차하는지 확인합니다.	DisplayObject
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		load(urlRequestToLoad:URLRequest):void urlRequestToLoad 매개 변수로 지정된 사이트에서 데이터와 함께 HTMLLoader 객체를 로드합니다.	HTMLLoader
		loadString(htmlContent:String):void HTML 문자열에 포함된 HTML 내용과 함께 HTMLLoader 객체를 로드합니다.	HTMLLoader
		local3DToGlobal(point3d:Vector3D):Point 3차원 표시 객체의 로컬 좌표에 있는 3차원 점을 Stage 전역 좌표의 2차원 점으로 변환합니다.	DisplayObject
		localToGlobal(point:Point):Point Point 객체를 표시 객체의 로컬 좌표에서 Stage 전역 좌표로 변환합니다.	DisplayObject
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		reload():void 현재 위치에서 페이지를 다시 로드합니다.	HTMLLoader
		removeChild(child:DisplayObject):DisplayObject 지정된 자식 DisplayObject 인스턴스를 DisplayObjectContainer 인스턴스의 자식 목록에서 제거합니다.	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject DisplayObjectContainer 자식 목록에서 지정된 인덱스 위치에 있는 자식 DisplayObject를 제거합니다.	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void 모든 자식 DisplayObject 인스턴스를 DisplayObjectContainer 인스턴스의 자식 목록에서 제거합니다.	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher 객체에서 리스너를 제거합니다.	EventDispatcher
		requestSoftKeyboard():Boolean 가상 키보드를 표시합니다.	InteractiveObject
		setChildIndex(child:DisplayObject, index:int):void 표시 객체 컨테이너에서 기존 자식의 위치를 변경합니다.	DisplayObjectContainer
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void 지정된 Sprite를 드래그할 수 있도록 합니다.	Sprite
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void 터치 지원 장치에서 지정된 스프라이트를 드래그할 수 있도록 합니다.	Sprite
		stopAllMovieClips():void 이 객체가 루트로 지정된 모든 MovieClip의 타임라인 실행을 재귀적으로 중지합니다.	DisplayObjectContainer
		stopDrag():void startDrag() 메서드를 종료합니다.	Sprite
		stopTouchDrag(touchPointID:int):void startTouchDrag() 메서드를 종료합니다. 터치 지원 장치에서 사용합니다.	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void 지정된 두 개의 자식 객체의 z 순서(전후 순서)를 맞바꿉니다.	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void 자식 목록에서 지정된 두 곳의 인덱스 위치에 있는 자식 객체의 z 순서(전후 순서)를 맞바꿉니다.	DisplayObjectContainer
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String 지정된 객체의 문자열 표현을 반환합니다.	Object
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object
		willTrigger(type:String):Boolean 이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher

이벤트

이벤트에 대한 자세한 내용을 보려면 클릭하십시오.

상속되는 이벤트 숨기기

상속되는 이벤트 표시

	요약	정의 주체
activate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.	EventDispatcher
added	표시 객체를 표시 목록에 추가할 때 전달됩니다.	DisplayObject
addedToStage	표시 객체를 직접 또는 해당 표시 객체가 포함된 하위 트리 추가를 통해 스테이지 표시 목록에 추가할 때 전달됩니다.	DisplayObject
clear	사용자가 텍스트 컨텍스트 메뉴에서 '지우기' 또는 '삭제'를 선택할 때 전달됩니다.	InteractiveObject
click	사용자가 동일한 InteractiveObject 위에서 포인팅 장치의 기본 버튼을 눌렀다 놓을 때 전달됩니다.	InteractiveObject
complete	loadString 또는 load 메서드에서 요청한 마지막 로드 작업이 완료되었음을 알립니다.	HTMLLoader
contextMenu	사용자 동작이 AIR 응용 프로그램의 이 대화형 객체와 연결된 컨텍스트 메뉴를 트리거할 때 전달됩니다.	InteractiveObject
copy	사용자가 복사 작업에 대해 플랫폼 관련 액셀러레이터 키 조합을 활성화하거나 텍스트 컨텍스트 메뉴에서 '복사'를 선택할 때 전달됩니다.	InteractiveObject
cut	사용자가 잘라내기 작업에 대해 플랫폼 관련 액셀러레이터 키 조합을 활성화하거나 텍스트 컨텍스트 메뉴에서 '잘라내기'를 선택할 때 전달됩니다.	InteractiveObject
deactivate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.	EventDispatcher
doubleClick	객체의 doubleClickEnabled 플래그가 true로 설정되어 있는 경우 사용자가 동일한 InteractiveObject 위에서 포인팅 장치의 기본 버튼을 연속으로 빠르게 두 번 눌렀다 놓을 때 전달됩니다.	InteractiveObject
enterFrame	[브로드캐스트 이벤트] 재생 헤드가 새 프레임에 들어갈 때 전달됩니다.	DisplayObject
exitFrame	[브로드캐스트 이벤트] 재생 헤드가 현재 프레임을 종료할 때 전달됩니다.	DisplayObject
focusIn	표시 객체가 포커스를 얻은 후 전달됩니다.	InteractiveObject
focusOut	표시 객체가 포커스를 잃은 후 전달됩니다.	InteractiveObject
frameConstructed	[브로드캐스트 이벤트] 프레임 표시 객체의 생성자가 실행되었지만 프레임 스크립트는 아직 실행되지 않았을 때 전달됩니다.	DisplayObject
gestureDirectionalTap	사용자가 InteractiveObject 인스턴스를 사용하여 터치 표면 가장자리를 따라 접점을 만들 때 전달됩니다(예: Siri Remote for Apple TV의 터치 표면 가장자리를 따라 누르기). 일부 장치에서는 이 접점을 여러 터치 이벤트의 조합으로 해석할 수도 있습니다.	InteractiveObject
gestureLongPress	사용자가 터치 지원 장치의 동일한 InteractiveObject 인스턴스 위에서 여러 접점을 누를 때 전달됩니다(터치 스크린이 있는 휴대 전화 또는 타블렛의 표시 객체를 손가락 두 개로 눌렀다가 놓는 경우 등).	InteractiveObject
gesturePan	사용자가 터치 지원 장치의 InteractiveObject 인스턴스 위에서 한 접점을 이동할 때 전달됩니다(예: 터치 스크린이 있는 휴대 전화 또는 타블렛의 표시 객체 위에서 손가락 하나를 왼쪽에서 오른쪽으로 움직이는 경우).	InteractiveObject
gestureRotate	사용자가 InteractiveObject 인스턴스와의 접점에서 회전 동작을 수행할 때 전달됩니다(예: 터치 스크린이 있는 휴대 전화 또는 타블렛에서 손가락 두 개로 표시 객체에 접촉한 후 회전하는 경우).	InteractiveObject
gestureSwipe	사용자가 InteractiveObject 인스턴스와의 접점에서 스와이프 동작을 수행할 때 전달됩니다(예: 터치 스크린이 있는 휴대폰 또는 타블렛에서 화면에 손가락을 세 개 댄 상태에서 표시 객체 위에서 손가락들을 동시에 이동할 때).	InteractiveObject
gestureTap	사용자가 InteractiveObject 인스턴스를 사용하여 접점을 만든 다음 터치 지원 장치를 누를 때 전달됩니다(예: 터치 스크린이 있는 휴대 전화 또는 타블렛에서 손가락 여러 개를 표시 객체 위에 놓아 메뉴를 연 다음 손가락 하나로 메뉴 항목을 눌러 선택하는 경우).	InteractiveObject
gestureZoom	사용자가 InteractiveObject 인스턴스와의 접점에서 확대/축소 동작을 수행할 때 전달됩니다(예: 터치 스크린이 있는 휴대폰 또는 타블렛에서 화면에 손가락을 두 개 댄 상태에서 표시 객체 위에서 손가락 사이의 거리를 빠르게 벌릴 때).	InteractiveObject
htmlBoundsChange	HTMLLoader 객체의 contentWidth 및 contentHeight 속성 중 하나 또는 둘 다 변경되었음을 알립니다.	HTMLLoader
htmlDOMInitialize	로드 작업에 대한 응답으로 HTML DOM이 만들어졌음을 알립니다.	HTMLLoader
htmlRender	HTMLLoader 객체의 내용 렌더링이 최신 상태임을 알립니다.	HTMLLoader
imeStartComposition	이 이벤트는 IME에서 인라인 입력을 지원하는 모든 클라이언트 응용 프로그램으로 전달됩니다.	InteractiveObject
keyDown	사용자가 키를 누를 때 전달됩니다.	InteractiveObject
keyFocusChange	사용자가 키보드를 사용하여 포커스를 바꾸려고 할 때 전달됩니다.	InteractiveObject
keyUp	사용자가 키를 놓을 때 전달됩니다.	InteractiveObject
locationChange	HTMLLoader 객체의 location 속성이 변경되었음을 알립니다.	HTMLLoader
locationChange	HTMLLoader 객체의 location 속성이 변경되었음을 알립니다.	HTMLLoader
locationChanging	HTMLLoader 객체의 location 속성이 변경됨을 알립니다.	HTMLLoader
middleClick	사용자가 동일한 InteractiveObject 위에서 포인팅 장치의 중간 버튼을 눌렀다 놓을 때 전달됩니다.	InteractiveObject
middleMouseDown	사용자가 InteractiveObject 인스턴스 위에서 포인팅 장치의 중간 버튼을 누를 때 전달됩니다.	InteractiveObject
middleMouseUp	InteractiveObject 인스턴스 위에 포인팅 장치를 놓고 버튼을 놓을 때 전달됩니다.	InteractiveObject
mouseDown	InteractiveObject 인스턴스 위에 포인팅 장치를 놓고 버튼을 누를 때 전달됩니다.	InteractiveObject
mouseFocusChange	사용자가 포인팅 장치를 사용하여 포커스를 바꾸려고 할 때 전달됩니다.	InteractiveObject
mouseMove	포인팅 장치가 InteractiveObject 위에 있을 때 포인팅 장치를 움직이면 전달됩니다.	InteractiveObject
mouseOut	포인팅 장치를 InteractiveObject 인스턴스에서 멀리 하면 전달됩니다.	InteractiveObject
mouseOver	포인팅 장치를 InteractiveObject 인스턴스 위로 옮길 때 전달됩니다.	InteractiveObject
mouseUp	InteractiveObject 인스턴스 위에 포인팅 장치를 놓고 버튼을 놓을 때 전달됩니다.	InteractiveObject
mouseWheel	InteractiveObject 인스턴스 위에 마우스를 놓고 휠을 굴릴 때 전달됩니다.	InteractiveObject
nativeDragComplete	사용자가 드래그 동작을 놓을 때 드래그 시작 객체 InteractiveObject에 의해 전달됩니다.	InteractiveObject
nativeDragDrop	드래그한 객체가 이 객체에 드롭되고 드롭이 DragManager.acceptDragDrop()에 대한 호출을 통해 허용될 때 대상 InteractiveObject에 의해 전달됩니다.	InteractiveObject
nativeDragEnter	드래그 동작이 이 객체의 경계에 들어갈 때 InteractiveObject에 의해 전달됩니다.	InteractiveObject
nativeDragExit	드래그 동작이 이 객체의 경계를 벗어날 때 InteractiveObject에 의해 전달됩니다.	InteractiveObject
nativeDragOver	드래그 동작이 이 객체의 경계에 있는 동안에는 계속 InteractiveObject에 의해 전달됩니다.	InteractiveObject
nativeDragStart	DragManager.doDrag() 호출에서 드래그 시작 객체로 지정되는 InteractiveObject에 의해 드래그 작업이 시작될 때 전달됩니다.	InteractiveObject
nativeDragUpdate	DragManager.doDrag() 호출에서 드래그 시작 객체로 지정되는 InteractiveObject에 의해 드래그 작업 중에 전달됩니다.	InteractiveObject
paste	사용자가 붙여넣기 작업에 대해 플랫폼 관련 액셀러레이터 키 조합을 활성화하거나 텍스트 컨텍스트 메뉴에서 '붙여넣기'를 선택할 때 전달됩니다.	InteractiveObject
proximityBegin	사용자가 화면의 근접 감지 임계값을 지나서 활성 스타일러스를 놓았을 때 전달됩니다.	InteractiveObject
proximityEnd	사용자가 화면의 근접 감지 임계값 위에서 활성 스타일러스를 떼어낼 때 전달됩니다.	InteractiveObject
proximityMove	사용자가 근접 감지 임계값 내에 있으면서 화면 위로 활성 스타일러스를 이동할 때 전달됩니다.	InteractiveObject
proximityOut	사용자가 화면의 근접 감지 임계값 내에 있으면서 이 InteractiveObject에서 벗어나 활성 스타일러스를 이동할 때 전달됩니다.	InteractiveObject
proximityOver	사용자가 화면의 근접 감지 임계값 내에 있으면서 이 InteractiveObject 바로 위로 활성 스타일러스를 이동할 때 전달됩니다.	InteractiveObject
proximityRollOut	사용자가 화면의 근접 감지 임계값 내에 있으면서 이 InteractiveObject 및 해당 자식에서 벗어나 활성 스타일러스를 이동할 때 전달됩니다.	InteractiveObject
proximityRollOver	사용자가 화면의 근접 감지 임계값 내에 있으면서 활성 스타일러스를 표시 목록에 있는 객체의 자손 트리에서 이 InteractiveObject 위로 이동할 때 전달됩니다.	InteractiveObject
releaseOutside	사용자가 먼저 InteractiveObject 인스턴스 위에서 단추를 누른 다음 InteractiveObject 인스턴스에서 벗어나 포인팅 장치를 이동한 후 포인팅 장치의 버튼을 해제할 때 전달됩니다.	InteractiveObject
removed	표시 객체를 표시 목록에서 제거하려고 할 때 전달됩니다.	DisplayObject
removedFromStage	표시 객체를 직접 또는 해당 표시 객체가 포함된 하위 트리 제거를 통해 표시 목록에서 제거하려고 할 때 전달됩니다.	DisplayObject
render	[브로드캐스트 이벤트] 표시 목록이 업데이트 및 렌더링되기 직전에 전달됩니다.	DisplayObject
rightClick	사용자가 동일한 InteractiveObject 위에서 포인팅 장치의 오른쪽 버튼을 눌렀다 놓을 때 전달됩니다.	InteractiveObject
rightMouseDown	InteractiveObject 인스턴스 위에 포인팅 장치를 놓고 버튼을 누를 때 전달됩니다.	InteractiveObject
rightMouseUp	InteractiveObject 인스턴스 위에 포인팅 장치를 놓고 버튼을 놓을 때 전달됩니다.	InteractiveObject
rollOut	포인팅 장치를 InteractiveObject 인스턴스에서 멀리 하면 전달됩니다.	InteractiveObject
rollOver	포인팅 장치를 InteractiveObject 인스턴스 위로 옮길 때 전달됩니다.	InteractiveObject
scroll	HTMLLoader 객체가 scrollH 또는 scrollV 속성을 변경했음을 알립니다.	HTMLLoader
selectAll	사용자가 전체 선택 작업에 대해 플랫폼 관련 액셀러레이터 키 조합을 활성화하거나 텍스트 컨텍스트 메뉴에서 '전체 선택'을 선택할 때 전달됩니다.	InteractiveObject
softKeyboardActivate	소프트 키보드를 놓은 직후에 전달됩니다.	InteractiveObject
softKeyboardActivating	소프트 키보드를 놓기 직전에 전달됩니다.	InteractiveObject
softKeyboardDeactivate	소프트 키보드가 눌린 직후에 전달됩니다.	InteractiveObject
tabChildrenChange	객체의 tabChildren 플래그 값이 변경될 때 전달됩니다.	InteractiveObject
tabEnabledChange	객체의 tabEnabled 플래그가 변경될 때 전달됩니다.	InteractiveObject
tabIndexChange	객체의 tabIndex 속성 값이 변경될 때 전달됩니다.	InteractiveObject
textInput	사용자가 하나 이상의 텍스트 문자를 입력할 때 전달됩니다.	InteractiveObject
touchBegin	사용자가 처음으로 터치 지원 장치를 접촉할 때 전달됩니다(터치 스크린이 있는 휴대 전화 또는 타블렛을 손가락으로 접촉하는 경우 등).	InteractiveObject
touchEnd	사용자가 터치 지원 장치에서 접촉을 제거할 때 전달됩니다(터치 스크린이 있는 휴대 전화 또는 타블렛에서 손가락을 떼는 경우 등).	InteractiveObject
touchMove	사용자가 장치를 터치할 때 전달되고, 접점이 제거될 때까지 계속 전달됩니다.	InteractiveObject
touchOut	사용자가 터치 지원 장치에서 InteractiveObject 인스턴스 접점을 인스턴스 외부로 멀리 이동할 때 전달됩니다(터치 스크린이 있는 휴대 전화 또는 타블렛에서 하나의 표시 객체에서 다른 표시 객체로 손가락 한 개를 드래그하는 경우 등).	InteractiveObject
touchOver	사용자가 터치 지원 장치에서 InteractiveObject 인스턴스로 접점을 이동할 때 전달됩니다(터치 스크린이 있는 휴대 전화 또는 타블렛에서 표시 객체 외부의 한 지점에서 표시 객체 위의 한 지점으로 손가락 한 개를 드래그하는 경우 등).	InteractiveObject
touchRollOut	사용자가 터치 지원 장치에서 InteractiveObject 인스턴스 접점을 인스턴스로부터 멀리 이동할 때 전달됩니다(예: 터치 스크린이 있는 휴대 전화 또는 타블렛에서 표시 객체로부터 표시 객체 외부의 한 지점으로 손가락 하나를 드래그하는 경우).	InteractiveObject
touchRollOver	사용자가 터치 지원 장치에서 InteractiveObject 인스턴스로 접점을 이동할 때 전달됩니다(터치 스크린이 있는 휴대 전화 또는 타블렛에서 표시 객체 외부의 한 지점에서 표시 객체 위의 한 지점으로 손가락 한 개를 드래그하는 경우 등).	InteractiveObject
touchTap	사용자가 터치 지원 장치에서 접촉이 처음 발생하는 동일한 InteractiveObject 인스턴스로부터 접촉을 제거할 때 전달됩니다(터치 스크린이 있는 휴대 전화 또는 타블렛의 표시 객체 위 단일 지점을 손가락 한 개로 눌렀다가 놓는 경우 등).	InteractiveObject
uncaughtScriptException	HTMLLoader 객체에 catch되지 않는 JavaScript 예외가 발생했음을 알립니다.	HTMLLoader

속성 세부 정보

authenticate

속성

authenticate:Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 객체에 의해 실행된 HTTP 요청에 대한 인증 요청을 처리할지(true) 아니면 처리하지 않을지(false)를 지정합니다. false인 경우 인증 문제로 HTTP 오류가 반환됩니다.

기본값: initialized from URLRequestDefaults.authenticate.

구현
public function get authenticate():Boolean
public function set authenticate(value:Boolean):void

cacheResponse

속성

cacheResponse:Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 객체에 의해 실행된 HTTP 요청에 대해 성공한 응답 데이터를 캐시할지 여부를 지정합니다. true로 설정되면 HTMLLoader 객체는 운영 체제의 HTTP 캐시를 사용합니다.

기본값: initialized from URLRequestDefaults.cacheResponse.

구현
public function get cacheResponse():Boolean
public function set cacheResponse(value:Boolean):void

contentHeight

속성

contentHeight:Number [읽기 전용]

런타임 버전:

AIR 1.0

HTML 내용의 높이(픽셀 단위)입니다. 이 속성은 HTMLLoader 객체의 치수가 변경되면 변경될 수 있습니다. 예를 들어 HTML 페이지는 HTMLLoader 객체의 전체 높이를 사용하는 경우가 많은데 사용자가 HTMLLoader 객체의 높이를 변경하면 contentHeight 속성이 변경될 수 있습니다.

구현
public function get contentHeight():Number

contentWidth

속성

contentWidth:Number [읽기 전용]

런타임 버전:

AIR 1.0

HTML 내용의 폭(픽셀 단위)입니다. 이 속성은 HTMLLoader 객체의 치수가 변경되면 변경될 수 있습니다. 예를 들어 HTML 페이지는 HTMLLoader 객체의 전체 폭을 사용하는 경우가 많은데 사용자가 HTMLLoader 객체의 폭을 변경하면 contentWidth 속성이 변경될 수 있습니다.

구현
public function get contentWidth():Number

hasFocusableContent

속성

hasFocusableContent:Boolean [읽기 전용]

런타임 버전:

AIR 1.0

HTMLLoader 객체의 내용이 포커스를 가질 수 있는지 여부를 나타냅니다.

구현
public function get hasFocusableContent():Boolean

height

속성

height:Number[재정의]

런타임 버전:

AIR 1.0

렌더링되는 HTML 캔바스의 직사각형 높이를 지정합니다. 이 속성 값은 HTMLLoader 표시 객체의 높이(픽셀 단위)이며 최대 height 값은 4095픽셀입니다. 이 속성을 변경하면 HTMLLoader 객체가 HTML 문서를 다시 렌더링하게 됩니다. 이 속성 변경에 대한 응답으로 htmlBoundsChanged 이벤트가 전달될 수 있습니다.

HTMLLoader 객체의 width 또는 height 속성을 설정하면 객체의 경계는 변경되지만 내용의 크기는 조절되지 않습니다(다른 유형의 표시 객체에서는 크기가 조절됨).

구현
override public function get height():Number
override public function set height(value:Number):void

historyLength

속성

historyLength:uint [읽기 전용]

런타임 버전:

AIR 1.0

앞뒤 항목을 비롯한 기록 목록의 전체 길이입니다. 이 속성은 HTML 페이지의 window.history.length JavaScript 속성과 같은 값을 가집니다.

구현
public function get historyLength():uint

관련 API 요소

historyPosition

속성

historyPosition:uint

런타임 버전:

AIR 1.0

기록 목록에서의 현재 위치입니다. 기록 목록은 HTML 페이지의 window.history 객체에 해당됩니다. 현재 위치보다 적은 항목은 "뒤로" 목록이고 큰 항목은 "앞으로" 목록입니다. 끝을 넘어가는 위치를 설정하려고 하면 끝으로 설정됩니다.

구현
public function get historyPosition():uint
public function set historyPosition(value:uint):void

htmlHost

속성

htmlHost:flash.html:HTMLHost

런타임 버전:

AIR 1.0

특정 사용자 인터페이스 요소에 대한 변경 내용을 처리하는 데 사용되는 HTMLHost 객체입니다(예: HTMLLoader 객체의 window.document.title 속성). HTMLLoader 객체의 기본 비헤이비어를 재정의하려면 HTMLHost 클래스의 하위 클래스를 만들고 해당 멤버 함수를 재정의하여 HTML 내용의 다양한 사용자 인터페이스 변경 사항을 처리하십시오.

구현
public function get htmlHost():flash.html:HTMLHost
public function set htmlHost(value:flash.html:HTMLHost):void

관련 API 요소

HTMLHost 클래스

idleTimeout

속성

idleTimeout:Number

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2

이 객체가 보낸 HTTP 요청에 대해 유휴 시간 초과 값(밀리초 단위)을 지정합니다.

유휴 제한 시간은 클라이언트가 연결이 설정된 후 요청을 포기할 때까지 서버 응답을 기다리는 시간 간격(밀리초)입니다.

기본값: initialized from URLRequestDefaults.idleTimeout.

구현
public function get idleTimeout():Number
public function set idleTimeout(value:Number):void

관련 API 요소

URLRequestDefaults.idleTimeout

isSupported

속성

isSupported:Boolean [읽기 전용]

런타임 버전:

AIR 2

클라이언트 시스템에서 HTMLLoader 클래스를 지원하는지 여부를 나타냅니다.

구현
public static function get isSupported():Boolean

loaded

속성

loaded:Boolean [읽기 전용]

런타임 버전:

AIR 1.0

이전 load() 또는 loadString() 메서드 호출에 해당하는 JavaScript load 이벤트가 HTMLLoader 객체의 HTML DOM으로 전달되었는지 여부를 나타냅니다. 이 속성은 complete 이벤트가 전달되기 전에 true가 됩니다. 이 속성이 true가 되지 않을 수 있습니다. complete 이벤트가 전달되지 않는 경우에 이러한 상황이 발생합니다.

구현
public function get loaded():Boolean

location

속성

location:String [읽기 전용]

런타임 버전:

AIR 1.0

HTMLLoader 객체에 로드되는 내용의 URL입니다.

구현
public function get location():String

manageCookies

속성

manageCookies:Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

HTTP 프로토콜 스택이 이 객체의 쿠키를 관리하는지 여부를 지정합니다. true이면 쿠키가 요청에 추가되고 응답 쿠키가 기억됩니다. false이면 쿠키가 요청에 추가되지 않고 응답 쿠키가 기억되지 않습니다.

기본값: initialized from URLRequestDefaults.manageCookies.

구현
public function get manageCookies():Boolean
public function set manageCookies(value:Boolean):void

navigateInSystemBrowser

속성

navigateInSystemBrowser:Boolean

런타임 버전:

AIR 1.0

HTML 내용에 있는 루트 프레임의 탐색(예: 사용자가 링크를 클릭하거나 window.location 속성이 설정되거나 window.open()을 호출한 경우)이 HTMLLoader 객체에서 탐색될지(false) 아니면 기본 시스템 웹 브라우저에서 탐색될지(true)를 지정합니다. 시스템 웹 브라우저에서 모든 탐색이 발생하게 하려면(HTMLLoader 객체에서는 발생하지 않음) 이 속성을 true로 설정합니다.

기본값: false.

구현
public function get navigateInSystemBrowser():Boolean
public function set navigateInSystemBrowser(value:Boolean):void

paintsDefaultBackground

속성

paintsDefaultBackground:Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

HTMLLoader 문서의 배경을 불투명한 흰색으로 설정할지(true) 아니면 설정하지 않을지(false)를 지정합니다. 이 속성이 false로 설정되면 HTMLLoader 객체는 표시 객체 컨테이너를 HTML의 배경으로 사용하고 표시 객체 컨테이너의 불투명도(alpha 값)를 HTML 배경으로 사용합니다. 그러나 HTML 문서의 body 요소나 기타 다른 요소가 불투명 배경색(style="background-color:gray"로 지정됨)을 가지는 경우 렌더링되는 해당 HTML 부분은 지정된 불투명 배경색을 사용합니다.

구현
public function get paintsDefaultBackground():Boolean
public function set paintsDefaultBackground(value:Boolean):void

pdfCapability

속성

pdfCapability:int [읽기 전용]

런타임 버전:

AIR 1.0

사용자 시스템에 대한 PDF 지원 유형으로, 정수 코드 값으로 정의됩니다. 이 속성이 PDFCapability.STATUS_OK로 평가된 경우만 HTMLLoader 객체가 PDF 내용을 표시할 수 있습니다. PDFCapability 클래스는 다음과 같이 pdfCapability 속성에 지정할 수 있는 값의 상수를 정의합니다.

PDFCapability 상수	의미
`STATUS_OK`	Acrobat 또는 Adobe Reader의 최신 버전(8.1 이상)이 검색되었으므로 PDF 내용을 HTMLLoader 객체로 로드할 수 있습니다. 참고: Windows의 경우 사용자의 시스템에서 현재 Acrobat 또는 Adobe Reader 버전 7.x 이상이 실행 중이면 HTMLLoader 객체에 로드된 PDF 로딩을 지원하는 최신 버전이 설치된 경우에도 해당 버전이 사용됩니다. 이 경우 `pdfCapability` 속성 값이 `PDFCapability.STATUS_OK`이면 AIR 응용 프로그램에서 PDF 내용을 로드하려고 할 때 이전 버전의 Acrobat 또는 Adobe Reader에서 경고를 표시합니다(AIR 런타임에서는 오류 메시지를 표시하지 않음). 사용자가 이에 해당하는 경우 응용 프로그램을 실행할 때 Acrobat 또는 Adobe Reader를 닫도록 알려주는 것이 좋습니다. 허용되는 시간 내에 PDF 내용이 로드되지 않는 경우 이러한 내용의 지침을 표시하는 것이 좋습니다.
`ERROR_INSTALLED_READER_NOT_FOUND`	검색된 Acrobat 또는 Adobe Reader 버전이 없습니다. HTMLLoader 객체가 PDF 내용을 표시할 수 없습니다.
`ERROR_INSTALLED_READER_TOO_OLD`	Acrobat 또는 Adobe Reader가 검색되었지만 너무 오래된 버전입니다. HTMLLoader 객체가 PDF 내용을 표시할 수 없습니다.
`ERROR_PREFERED_READER_TOO_OLD`	Acrobat 또는 Adobe Reader의 최신 버전(8.1 이상)이 검색되었지만 PDF 내용을 처리하도록 설정된 버전이 8.1보다 이전 버전입니다. HTMLLoader 객체가 PDF 내용을 표시할 수 없습니다.

구현
public static function get pdfCapability():int

관련 API 요소

HTMLPDFCapability 클래스

placeLoadStringContentInApplicationSandbox

속성

placeLoadStringContentInApplicationSandbox:Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.5

loadString() 메서드를 통해 로드된 내용이 응용 프로그램 샌드박스(true)에 배치되는지 비응용 프로그램 샌드박스(false)에 배치되는지 지정합니다.

이 속성을 false로 설정하면 loadString() 메서드를 통해 로드된 내용이 비응용 프로그램 샌드박스에 배치되며 다음 특성을 갖게 됩니다.

파일 시스템이 아니라 네트워크에서 내용을 로드할 수 있게 됩니다.
XMLHttpRequest를 사용하여 데이터를 로드할 수 없습니다.
window.location 속성이 "about:blank"로 설정됩니다.
내용이 모든 비응용 프로그램 샌드박스의 내용과 마찬가지로 window.runtime 속성에 액세스할 수 없습니다.

이 속성을 true로 설정하면 loadString() 메서드를 통해 로드된 내용이 응용 프로그램 샌드박스에 배치되며 window.runtime 속성 및 모든 AIR API에 액세스할 수 있게 됩니다. loadString() 메서드 호출에 사용된 문자열의 데이터 소스를 신뢰할 수 있는지 확인해야 합니다. 이 속성을 true로 설정하면 HTML 문자열의 코드 문이 전체 응용 프로그램 권한으로 실행됩니다. 문자열에 유해한 코드가 포함되어 있지 않은 경우에만 이 속성을 true로 설정해야 합니다.

AIR 1.0 또는 AIR 1.1 SDK로 컴파일된 응용 프로그램에서는 loadString() 메서드를 통해 로드된 내용이 응용 프로그램 샌드박스에 배치됩니다.

기본값: false.

구현
public function get placeLoadStringContentInApplicationSandbox():Boolean
public function set placeLoadStringContentInApplicationSandbox(value:Boolean):void

관련 API 요소

loadString()

runtimeApplicationDomain

속성

runtimeApplicationDomain:ApplicationDomain

런타임 버전:

AIR 1.0

HTML 페이지의 JavaScript에서 window.runtime 객체가 사용하는 응용 프로그램 도메인입니다.

null인 경우 또는 HTML 내용이 HTMLLoader 객체를 포함하는 SWF 내용이 아닌 다른 보안 도메인에서 가져온 것일 경우 기본 응용 프로그램 도메인이 페이지의 도메인으로 사용됩니다.

구현
public function get runtimeApplicationDomain():ApplicationDomain
public function set runtimeApplicationDomain(value:ApplicationDomain):void

오류

SecurityError — ApplicationDomain 객체가 호출자의 보안 도메인에 없는 경우입니다.

scrollH

속성

scrollH:Number

런타임 버전:

AIR 1.0

HTMLLoader 객체에 있는 HTML 내용의 가로 스크롤 위치입니다.

구현
public function get scrollH():Number
public function set scrollH(value:Number):void

scrollV

속성

scrollV:Number

런타임 버전:

AIR 1.0

HTMLLoader 객체에 있는 HTML 내용의 세로 스크롤 위치입니다.

구현
public function get scrollV():Number
public function set scrollV(value:Number):void

swfCapability

속성

swfCapability:int [읽기 전용]

런타임 버전:

AIR 2

사용자 시스템에 대한 SWF 지원 유형으로, 정수 코드 값으로 정의됩니다. 이 속성이 HTMLSWFCapability.STATUS_OK로 평가된 경우만 HTMLLoader 객체가 SWF 내용을 표시할 수 있습니다. HTMLSWFCapability 클래스는 다음과 같이 swfCapability 속성에 지정할 수 있는 값의 상수를 정의합니다.

HTMLSWFCapability 상수	의미
`STATUS_OK`	적절한 버전의 Adobe Flash Player가 검색되었으므로 SWF 내용을 HTMLLoader 객체로 로드할 수 있습니다.
`ERROR_INSTALLED_PLAYER_NOT_FOUND`	검색된 Adobe Flash Player 버전이 없습니다. HTMLLoader 객체가 SWF 내용을 표시할 수 없습니다.
`ERROR_INSTALLED_PLAYER_TOO_OLD`	Adobe Flash Player가 검색되었지만 너무 오래된 버전입니다. HTMLLoader 객체가 SWF 내용을 표시할 수 없습니다.

구현
public static function get swfCapability():int

관련 API 요소

HTMLSWFCapability 클래스

textEncodingFallback

속성

textEncodingFallback:String

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

HTML 페이지에 문자 인코딩이 지정되지 않은 경우 HTMLLoader 내용에 사용되는 문자 인코딩입니다. HTML 페이지는 다음과 같이 meta 태그로 문자 인코딩을 지정합니다.

<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">

값은 유효한 문자 세트의 IANA 목록에 정의되어 있습니다.

HTML 페이지, textEncodingFallback 속성 또는 textEncodingOverride 속성에 의해 지정된 인코딩이 없는 경우 HTML 내용은 ISO-8859-1 인코딩을 사용합니다.

구현
public function get textEncodingFallback():String
public function set textEncodingFallback(value:String):void

관련 API 요소

textEncodingOverride

속성

textEncodingOverride:String

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

HTML 페이지의 모든 설정을 재정의하여 HTMLLoader 내용에 사용되는 문자 인코딩입니다. HTML 페이지는 다음과 같이 meta 태그로 문자 인코딩을 지정합니다.

<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">

또한 이 설정은 textEncodingFallback 속성의 모든 설정을 재정의합니다.

값은 유효한 문자 세트의 IANA 목록에 정의되어 있습니다.

HTML 내용이 로드되어 AIR가 지정된 인코딩을 사용하여 HTML 내용을 새로 고친 후 textEncodingOverride 속성을 설정합니다. 일단 HTMLLoader가 새 페이지로 이동하고 난 후 새 페이지에서 특정 인코딩을 사용하려면 사용자가 속성을 다시 설정해야 합니다.

HTML 페이지, textEncodingFallback 속성 또는 textEncodingOverride 속성에 의해 지정된 인코딩이 없는 경우 HTML 내용은 ISO-8859-1 인코딩을 사용합니다.

textEncodingOverride 속성을 null로 설정하면 기본 비헤이비어가 복원됩니다.

구현
public function get textEncodingOverride():String
public function set textEncodingOverride(value:String):void

관련 API 요소

textEncodingFallback

useCache

속성

useCache:Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

이 객체에 의해 실행된 HTTP 요청에 따라 데이터를 페치하기 전에 로컬 캐시를 참조할지 여부를 지정합니다.

기본값: initialized from URLRequestDefaults.useCache.

구현
public function get useCache():Boolean
public function set useCache(value:Boolean):void

userAgent

속성

userAgent:String

런타임 버전:

AIR 1.0

이 HTMLLoader 객체에서 예정되어 있는 내용 요청에 사용할 사용자 에이전트 문자열입니다.

사용자 에이전트 문자열을 설정하려면 load() 메서드를 호출하기 전에 HTMLLoader 객체의 userAgent 속성을 설정하십시오. load() 메서드에 전달된 URLRequest의 userAgent 속성은 사용되지 않습니다.

URLRequestDefaults.userAgent 속성을 설정하여 응용 프로그램 도메인에 있는 모든 HTMLLoader 객체가 사용하는 기본 사용자 에이전트 문자열을 설정할 수 있습니다. HTMLLoader 객체의 userAgent 속성에 설정된 값이 없거나 값이 null로 설정되면 사용자 에이전트 문자열은 정적 URLRequestDefaults.userAgent 속성의 값으로 설정됩니다.

HTMLLoader의 userAgent 속성 및 URLRequestDefaults.userAgent에 값이 설정되지 않으면 기본값이 사용자 에이전트 문자열로 사용됩니다. 이 기본값은 다음 예제와 같이 런타임 운영 체제(예: Mac OS, Linux 또는 Windows), 런타임 언어 및 런타임 버전에 따라 다릅니다.

"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (Gecko와 같은 KHTML) AdobeAIR/1.5"
"Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (Gecko와 같은 KHTML) AdobeAIR/1.5"
"Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (Gecko와 같은 KHTML) AdobeAIR/1.5"

구현
public function get userAgent():String
public function set userAgent(value:String):void

width

속성

width:Number[재정의]

런타임 버전:

AIR 1.0

렌더링되는 HTML 캔바스의 직사각형 폭을 지정합니다. 이는 HTMLLoader 표시 객체의 폭(픽셀 단위)입니다. 최대 width 값은 4095픽셀입니다. 이 속성을 변경하면 HTMLLoader 객체가 HTML 문서를 다시 렌더링하게 됩니다. 이 속성 변경에 대한 응답으로 htmlBoundsChange 이벤트가 전달될 수 있습니다. HTMLLoader 객체의 width 및 height 속성을 설정하면 객체의 경계는 변경되지만 내용의 크기는 조절되지 않습니다(다른 유형의 표시 객체에서는 크기가 조절됨).

구현
override public function get width():Number
override public function set width(value:Number):void

window

속성

window:Object [읽기 전용]

런타임 버전:

AIR 1.0

HTML 컨트롤에 로드되는 내용의 전역 JavaScript 객체입니다.

구현
public function get window():Object

생성자 세부 정보

()

생성자

public function HTMLLoader()

런타임 버전:

AIR 1.0

HTMLLoader 객체를 만듭니다.

메서드 세부 정보

cancelLoad

()

메서드

public function cancelLoad():void

런타임 버전:

AIR 1.0

진행 중인 로드 작업을 취소합니다.

createRootWindow

()

메서드

 public static function createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader

런타임 버전:

AIR 1.0

HTMLLoader 객체를 포함하는 새 NativeWindow 객체를 만듭니다. 이 메서드로 반환된 HTMLLoader 객체를 사용하여 HTML 내용을 로드합니다.

이 메서드를 호출할 때 매개 변수를 설정하지 않으면 기본적으로 새 윈도우는 표준 시스템 크롬을 사용하고 내용의 스크롤 막대 컨트롤을 포함합니다. 매개 변수를 설정하여 새 윈도우의 속성을 변경할 수 있습니다.

윈도우가 내용을 로드하고 스타일시트를 적용할 때 사소한 그래픽 변화가 발생할 수 있습니다. 이러한 현상이 나타나지 않도록 하려면 visible 매개 변수를 false로 설정합니다. 윈도우가 로드되고 내용이 배치되면 window.nativeWindow.visible 속성을 true로 설정하여 내용을 표시하거나 window.nativeWindow.activate() 메서드를 호출합니다.

매개 변수

	`visible:Boolean` (default = `true`) — 윈도우가 표시될지 여부를 지정합니다.

	`windowInitOptions:NativeWindowInitOptions` (default = `null`) — 윈도우 초기화 옵션을 지정합니다. `null`인 경우 기본 `NativeWindowInitOptions` 값을 사용합니다.

	`scrollBarsVisible:Boolean` (default = `true`) — 윈도우가 스크롤 막대를 제공하는지 여부를 지정합니다.

	`bounds:Rectangle` (default = `null`) — `null`이 아닌 경우 윈도우 경계를 지정합니다. `x`, `y`, `width` 또는 `height`가 `NaN`인 경우 윈도우의 해당 치수는 해당 기본값으로 유지됩니다.

반환값

flash.html:HTMLLoader — 새 NativeWindow 객체의 스테이지에 있는 새 HTMLLoader 객체입니다.

getHistoryAt

()

메서드

public function getHistoryAt(position:uint):flash.html:HTMLHistoryItem

런타임 버전:

AIR 1.0

지정된 위치의 기록 항목을 반환합니다.

매개 변수

position:uint — 기록 목록에서의 위치입니다.

반환값

flash.html:HTMLHistoryItem — 지정된 위치의 기록 항목에 대한 URLRequest 객체입니다.

관련 API 요소

historyPosition

historyBack

()

메서드

public function historyBack():void

런타임 버전:

AIR 1.0

가능한 경우 브라우저 기록에서 뒤로 이동합니다.

HTMLLoader 객체의 이 메서드를 호출하면 HTML 페이지의 JavaScript에서 window.history 속성의 back() 메서드를 호출하는 것과 동일한 효과가 있습니다.

이 함수는 오류가 발생하지 않습니다.

관련 API 요소

historyPosition

historyForward

()

메서드

public function historyForward():void

런타임 버전:

AIR 1.0

가능한 경우 브라우저 기록에서 앞으로 이동합니다.

HTMLLoader 객체의 이 메서드를 호출하면 HTML 페이지의 JavaScript에서 window.history 속성의 forward() 메서드를 호출하는 것과 동일한 효과가 있습니다.

이 함수는 오류가 발생하지 않습니다.

관련 API 요소

historyPosition

historyGo

()

메서드

public function historyGo(steps:int):void

런타임 버전:

AIR 1.0

브라우저 기록에서 지정된 단계 수만큼 이동합니다. 양수이면 앞으로 이동하고 음수이면 뒤로 이동합니다. 0만큼 이동하면 현재 내용이 다시 로드됩니다.

이 메서드는 HTML 페이지의 JavaScript에서 window.history 속성의 go() 메서드를 호출하는 것과 같습니다.

이 함수는 오류가 발생하지 않습니다.

매개 변수

steps:int — 기록 목록에서 앞으로(양수) 또는 뒤로(음수) 이동할 단계 수입니다.

관련 API 요소

historyPosition

load

()

메서드

public function load(urlRequestToLoad:URLRequest):void

런타임 버전:

AIR 1.0

urlRequestToLoad 매개 변수로 지정된 사이트에서 데이터와 함께 HTMLLoader 객체를 로드합니다. 이 메서드를 호출하면 loaded 속성이 일단 false로 설정됩니다. 이 메서드는 항상 비동기적으로 완료되는 작업을 시작합니다.

이 메서드에 대한 호출은 이 메서드 또는 loadString() 메서드로 시작되는 보류 중인 이전 로드 작업을 암시적으로 취소합니다. 이전 로드 작업의 complete 이벤트는 전달되지 않습니다.

complete 이벤트는 전달되지 않을 수 있습니다. HTMLLoader 객체에 로드되는 HTML 내용 중 하나라도 완전히 다운로드되지 않을 경우 이러한 상황이 발생합니다. 이는 HTML 내용이 내용을 무한정 반복해서 생산하는 CGI 스크립트에 대한 URL을 참조하는 경우 발생할 수 있습니다.

매개 변수

urlRequestToLoad:URLRequest — 로드할 URL에 대한 정보를 포함하는 URLRequest 객체입니다. URLRequest 객체에는 로드할 URL 외에도 HTTP 양식 제출 메서드(GET 또는 POST), 요청과 함께 전송될 데이터 및 요청 헤더를 정의하는 속성이 포함되어 있습니다.

관련 API 요소

flash.net.URLRequest

loadString

()

메서드

public function loadString(htmlContent:String):void

런타임 버전:

AIR 1.0

HTML 문자열에 포함된 HTML 내용과 함께 HTMLLoader 객체를 로드합니다. 문자열에서 HTML 렌더링이 완료될 때 complete 이벤트가 전달됩니다. complete 이벤트는 항상 비동기적으로 전달됩니다.

이 메서드에 대한 호출은 이 메서드 또는 load() 메서드로 시작되는 보류 중인 이전 로드 작업을 암시적으로 취소합니다. 이전 로드 작업의 complete 이벤트는 전달되지 않습니다.

문자열에 지정된 HTML에 외부 리소스에 대한 참조가 없는 경우 이 메서드는 동기적으로 HTML을 렌더링합니다. 그러나 complete 이벤트는 여전히 비동기적으로 전달됩니다. 이 클래스의 loaded 속성이 이 함수에 대한 호출 직후에 true로 설정되면 htmlContent 인수에 지정된 HTML 내용이 동기적으로 렌더링된 것입니다.

loadString() 메서드를 통해 로드된 내용은 placeLoadStringContentInApplicationSandbox 속성이 true로 설정된 경우에만 응용 프로그램 보안 샌드박스에 배치됩니다.

매개 변수

htmlContent:String — HTMLLoader 객체에 로드되는 HTML 내용을 포함하는 문자열입니다.

reload

()

메서드

public function reload():void

런타임 버전:

AIR 1.0

현재 위치에서 페이지를 다시 로드합니다.

이벤트 세부 정보

complete

이벤트

이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.COMPLETE

런타임 버전:

AIR 1.0

loadString 또는 load 메서드에서 요청한 마지막 로드 작업이 완료되었음을 알립니다. JavaScript load 이벤트가 HTMLLoader 객체의 HTML DOM에서 호출된 후에 이벤트가 전달됩니다. 이 이벤트는 항상 비동기적으로 전달됩니다. 이 이벤트의 이벤트 핸들러가 메서드를 호출하거나 HTMLLoader 객체의 속성에 액세스할 수 있습니다.

Event.COMPLETE 상수는 complete 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`target`	로드가 완료된 네트워크 객체입니다.

관련 API 요소

loadString()
load()

htmlBoundsChange

이벤트

이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.HTML_BOUNDS_CHANGE

런타임 버전:

AIR 1.0

HTMLLoader 객체의 contentWidth 및 contentHeight 속성 중 하나 또는 둘 다 변경되었음을 알립니다. 예를 들어 새 이미지 또는 다른 내용이 로드될 때 이러한 상황이 발생할 수 있습니다. 이벤트 핸들러가 메서드를 호출하거나 HTMLLoader 객체의 속성에 액세스할 수 있습니다.

HTMLLoader 객체는 로드 작업이 시작된 후에는 객체에서 complete 이벤트를 전달한 후를 비롯해 언제든지 이 이벤트를 전달할 수 있습니다.

Event.HTML_BOUNDS_CHANGE 상수는 htmlBoundsChange 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	HTMLLoader 객체입니다.
`target`	HTMLLoader 객체입니다.

관련 API 요소

contentWidth
contentHeight

htmlDOMInitialize

이벤트

이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.HTML_DOM_INITIALIZE

런타임 버전:

AIR 1.0

로드 작업에 대한 응답으로 HTML DOM이 만들어졌음을 알립니다. 이 이벤트가 전달되는 동안 HTMLLoader 객체의 load() 및 loadString() 메서드는 예외를 발생시킵니다. 이 이벤트가 전달되는 동안 HTMLLoader 객체에 로드되는 URL을 제어하는 HTMLLoader 객체의 window 속성에서 액세스할 수 있는 JavaScript 객체의 속성 또는 메서드가 설정 또는 호출되는 경우 예외가 발생합니다. 예를 들어 HTMLLoader 객체의 window 속성을 통해 window.location을 설정하면 JavaScript 예외가 발생합니다.

Event.HTML_DOM_INITIALIZE 상수는 htmlDOMInitialize 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	HTMLLoader 객체입니다.
`target`	HTMLLoader 객체입니다.

관련 API 요소

loadString()
load()

htmlRender

이벤트

이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.HTML_RENDER

런타임 버전:

AIR 1.0

HTMLLoader 객체의 내용 렌더링이 최신 상태임을 알립니다. 이 이벤트는 HTML 내용의 렌더링이 변경될 때마다 매우 빈번하게 전달됩니다. 예를 들어 사용자가 링크를 클릭하거나 페이지의 JavaScript가 HTML을 렌더링하여 새 내용이 표시될 때 이 이벤트가 전달됩니다. 이벤트 리스너가 메서드를 호출하거나 HTMLLoader 객체의 속성에 액세스할 수 있습니다.

이 이벤트의 핸들러는 HTMLLoader 객체의 contentWidth 및 contentHeight 속성을 확인하여 HTMLLoader 객체와 연관된 스크롤 막대를 업데이트합니다.

HTMLLoader 객체는 로드 작업이 시작된 후에는 객체에서 complete 이벤트를 전달한 후를 비롯해 언제든지 이 이벤트를 전달할 수 있습니다.

Event.HTML_RENDER 상수는 htmlRender 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	HTMLLoader 객체입니다.
`target`	HTMLLoader 객체입니다.

locationChange

이벤트

이벤트 객체 유형: flash.events.LocationChangeEvent
속성 LocationChangeEvent.type = flash.events.LocationChangeEvent.LOCATION_CHANGE

런타임 버전:

AIR 2.7

HTMLLoader 객체의 location 속성이 변경되었음을 알립니다. 이 이벤트의 이벤트 핸들러가 메서드를 호출하거나 HTMLLoader 객체의 속성에 액세스할 수 있습니다.

AIR 네임스페이스 2.7 이상을 사용하는 응용 프로그램에서는 HTMLLoader가 LocationChangeEvent 유형의 locationChange 이벤트를 전달합니다. 이전 버전의 AIR에서는 전달되는 이벤트 객체가 Event 클래스의 인스턴스입니다.

모든 위치 변경 이후에 전달됩니다.

관련 API 요소

loadString()
load()

locationChange

이벤트

이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.LOCATION_CHANGE

런타임 버전:

AIR 1.0

2.7 이전의 AIR 네임스페이스를 사용하는 응용 프로그램에서는 HTMLLoader가 Event 유형의 locationChange 이벤트를 전달하지만, AIR 2.7 이상에서는 새로운 페이지 URL로 설정된 추가 location 속성을 제공하는 LocationChangeEvent 클래스의 인스턴스가 이벤트 객체입니다.

Event.LOCATION_CHANGE 상수는 locationChange 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	HTMLLoader 객체입니다.
`target`	HTMLLoader 객체입니다.

관련 API 요소

loadString()
load()

locationChanging

이벤트

이벤트 객체 유형: flash.events.LocationChangeEvent
속성 LocationChangeEvent.type = flash.events.LocationChangeEvent.LOCATION_CHANGING

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2.7

HTMLLoader 객체의 location 속성이 변경됨을 알립니다.

locationChanging 이벤트는 사용자가 링크를 클릭할 때처럼 사용자의 개입을 통해서나 클라이언트 측 리디렉션처럼 HTMLLoader 내에서 실행되는 코드를 통해 위치 변경이 시작되는 경우에만 전달됩니다. 기본적으로 새 위치는 이 HTMLLoader 객체에 표시됩니다. 이벤트 객체의 preventDefault() 메서드를 호출하여 기본 비헤이비어를 취소할 수 있습니다. 예를 들어 flash.net.navigateToURL() 함수를 사용하여 이벤트 객체의 location 속성을 기준으로 시스템 브라우저에서 페이지를 열 수 있습니다..

다음 메서드를 호출할 때는 locationChanging() 이벤트가 전달되지 않습니다.

load()
loadString()
reload()
historyBack()
historyForward()
historyGo()

또한 navigateInSystemBrowser 속성이 true이고 시스템 브라우저에서 대상 페이지를 열 때도 HTMLLoader 위치가 변경되지 않기 때문에 이 이벤트가 전달되지 않습니다.

LOCATION_CHANGING 상수는 페이지 위치가 변경되기 전에 전달된 LocationChangeEvent 객체의 type 속성 값을 정의합니다.
예제 ( 예제 사용 방법 )

다음 코드는 HTMLLoader 객체를 초기화하고, 해당 폭 및 높이를 구성하고, URL http://www.adobe.com을 로드하고, 객체를 표시 목록에 추가합니다. 사용자 또는 페이지의 JavaScript가 기본 URL로 시작하지 않는 URL을 탐색하려고 하면 탐색이 금지됩니다.

package{
    import flash.display.Sprite;
    import flash.html.HTMLLoader;
    import flash.net.URLRequest;
    
    public class LocationChanging extends Sprite
    {
        var htmlLoader:HTMLLoader = new HTMLLoader();
        public function LocationChanging()
        {
            htmlLoader.width = stage.stageWidth;
            htmlLoader.height = stage.stageHeight;        
            htmlLoader.addEventListener( LocationChangeEvent.LOCATION_CHANGING, onLocationChanging );
            htmlLoader.load( new URLRequest( "http://www.adobe.com" ) );
            this.addChild( htmlLoader );
        }
    
        private function onLocationChanging( event:LocationChangeEvent ):void
        {
            trace( "Location changing: " + event.location );
        
            if ( event.location.indexOf( "http://www.adobe.com" ) < 0 ) 
            {
                event.preventDefault();
            }
        }
    }
}

scroll

이벤트

이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.SCROLL

런타임 버전:

AIR 1.0

HTMLLoader 객체가 scrollH 또는 scrollV 속성을 변경했음을 알립니다. HTMLLoader 객체는 HTMLLoader 객체에서 실행 중인 JavaScript가 window 객체의 scrollTo() 메서드를 호출했는데 원하는 위치가 아직 표시되지 않은 경우 이 이벤트를 전달합니다. ActionScript 코드가 scrollH 또는 scrollV 속성을 변경하면 이벤트가 전달되지 않습니다. 이벤트 핸들러가 메서드를 호출하거나 HTMLLoader 객체의 속성에 액세스할 수 있습니다.

이 이벤트의 이벤트 핸들러는 scrollH 및 scrollV 속성을 확인하여 HTMLLoader 객체와 연관된 스크롤 막대를 업데이트합니다.

HTMLLoader 객체는 로드 작업이 시작된 후에는 객체에서 complete 이벤트를 전달한 후를 비롯해 언제든지 이 이벤트를 전달할 수 있습니다.

Event.SCROLL 상수는 scroll 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`target`	스크롤한 TextField 객체입니다. `target` 속성은 표시 목록에서 이벤트 리스너를 등록한 객체가 아닐 수도 있습니다. 표시 목록에서 현재 이벤트를 처리 중인 객체에 액세스하려면 `currentTarget` 속성을 사용합니다.

uncaughtScriptException

이벤트

이벤트 객체 유형: flash.events.HTMLUncaughtScriptExceptionEvent
속성 HTMLUncaughtScriptExceptionEvent.type = flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION

런타임 버전:

AIR 1.0

HTMLLoader 객체에 catch되지 않는 JavaScript 예외가 발생했음을 알립니다. 이벤트 핸들러가 메서드를 호출하거나 HTMLLoader 객체의 속성에 액세스할 수 있습니다. 이벤트는 취소할 수 있으며 AIR 디버그 시작 프로그램에서 실행 중인 경우 기본 비헤이비어는 추적 출력에 JavaScript 스택을 보내는 것입니다.

HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION 상수는 uncaughtScriptException 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`exceptionValue`	포착되지 않은 예외를 발생시킨 `throw` 문의 표현식을 평가한 결과입니다.
`stackTrace`	포착되지 않은 예외를 발생시킨 `throw` 문이 실행되었을 때 스택 추적을 나타내는 객체의 배열입니다.
`target`	HTMLLoader 객체입니다.

관련 API 요소

loadString()
load()

예제 예제 사용 방법

HTMLLoader.1.as

다음 코드는 HTMLLoader 객체를 초기화하고, 해당 폭 및 높이를 구성하고, URL http://www.adobe.com을 로드하고, 객체를 표시 목록에 추가합니다.

package {
    import flash.display.Sprite;
    import flash.html.HTMLLoader;
    import flash.net.URLRequest;

    public class HTMLLoaderExample extends Sprite
    {
        public function HTMLLoaderExample()
        {
            var html:HTMLLoader = new HTMLLoader();
            var urlReq:URLRequest = new URLRequest("http://www.adobe.com/");
            html.width = stage.stageWidth;
            html.height = stage.stageHeight;
            html.load(urlReq); 
            addChild(html);
        }
    }
}

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

HTMLLoader - AS3

패키지x

언어 요소

부록

패키지 flash.html

authenticate

cacheResponse

contentHeight

contentWidth

hasFocusableContent

height

historyLength

historyPosition

htmlHost

idleTimeout

isSupported

loaded

location

manageCookies

navigateInSystemBrowser

paintsDefaultBackground

pdfCapability

placeLoadStringContentInApplicationSandbox

runtimeApplicationDomain

scrollH

scrollV

swfCapability

textEncodingFallback

textEncodingOverride

useCache

userAgent

width

window

HTMLLoader

cancelLoad

createRootWindow

getHistoryAt

historyBack

historyForward

historyGo

load

loadString

reload

complete

htmlBoundsChange

htmlDOMInitialize

htmlRender

locationChange

locationChange

locationChanging

scroll

uncaughtScriptException