HTMLLoader 객체의 표시 속성

Adobe AIR 1.0 이상

HTMLLoader 객체는 Adobe® Flash® Player Sprite 클래스의 표시 속성을 상속합니다. 예를 들어, 배경색의 크기 조절, 이동, 숨기기 및 변경을 수행할 수 있습니다. 또는 필터, 마스크, 크기 조절 및 회전과 같은 고급 효과를 적용할 수 있습니다. 효과를 적용할 때는 가독성에 미치는 영향을 고려해야 합니다. 일부 효과가 적용된 경우 HTML 페이지에 로드된 SWF 및 PDF 내용을 표시할 수 없습니다.

HTML 윈도우에는 HTML 내용을 렌더링하는 HTMLLoader 객체가 포함되어 있습니다. 이 객체는 윈도우의 영역 안으로 제한되므로 크기, 위치, 회전 또는 비율 인수를 변경할 때 항상 원하는 결과가 생성되지는 않습니다.

기본 표시 속성

HTMLLoader의 기본 표시 속성을 사용하면 부모 표시 객체 안에 컨트롤을 배치한 후 크기를 설정하고 표시하거나 숨길 수 있습니다. HTML 윈도우의 HTMLLoader 객체에 대한 이러한 속성은 변경하면 안 됩니다.

기본 속성은 다음과 같습니다.

속성

참고 사항

x , y

부모 컨테이너 안에 객체를 배치합니다.

width , height

표시 영역의 크기를 변경합니다.

visible

객체와 객체에 포함된 내용의 가시성을 제어합니다.

HTML 윈도우 밖에서 HTMLLoader 객체의 width height 속성에 대한 기본값은 0입니다. 로드된 HTML 내용을 표시하려면 폭과 높이를 설정해야 합니다. HTML 내용은 HTMLLoader 크기로 그려지며 내용의 HTML 및 CSS 속성에 따라 배치됩니다. HTMLLoader 크기를 변경하면 내용이 다시 전개됩니다.

width 가 여전히 0으로 설정된 상태로 내용을 새 HTMLLoader 객체에 로드하는 경우 contentWidth contentHeight 속성을 사용하여 HTMLLoader의 표시 높이 를 설정하기가 쉽습니다. 이 방법은 HTML 및 CSS 흐름 규칙에 따라 배치될 때 최소 폭이 적당한 페이지에는 효과가 있지만 일부 페이지는 HTMLLoader에서 제공하는 적당한 폭이 없으면 길고 좁은 레이아웃으로 전개됩니다.

참고: HTMLLoader 객체의 폭과 높이를 변경하면 대부분의 다른 표시 객체 유형에서 그렇듯이 scaleX 및 scaleY 값이 변경되지 않습니다.

HTMLLoader 내용의 투명도

기본적으로 true 인 HTMLLoader 객체의 paintsDefaultBackground 속성은 HTMLLoader 객체가 불투명한 배경을 그리는지 여부를 결정합니다. paintsDefaultBackground false 이면 배경이 지워집니다. HTMLLoader 객체 아래의 다른 표시 객체나 표시 객체 컨테이너는 HTML 내용의 전경 요소 뒤에 표시됩니다.

HTML 문서의 body 요소나 다른 요소가 style="background-color:gray" 등을 사용하여 배경색을 지정하는 경우 해당 HTML 부분의 배경은 불투명하며 지정된 배경색으로 렌더링됩니다. HTMLLoader 객체의 opaqueBackground 속성을 설정하고 paintsDefaultBackground false 인 경우 opaqueBackground 에 설정된 색상이 표시됩니다.

참고: 투명한 PNG 형식의 그래픽을 사용하여 HTML 문서의 요소에 알파 블렌딩된 배경을 제공할 수 있습니다. HTML 요소의 불투명도 스타일은 설정할 수 없습니다.

HTMLLoader 내용 크기 조절

HTMLLoader 객체의 크기를 비율 인수 1.0을 초과하게 조절하지 마십시오. HTMLLoader 내용의 텍스트는 특정 해상도로 렌더링되며 HTMLLoader 객체의 크기를 크게 조절하는 경우 픽셀화되어 나타납니다. 윈도우 크기가 조절될 때 HTMLLoader와 그 내용의 크기가 조절되지 않게 하려면 Stage의 scaleMode 속성을 StageScaleMode.NO_SCALE 로 설정합니다.

SWF 또는 PDF 내용을 HTML 페이지에 로드하는 경우의 고려 사항

HTMLLoader 객체에 로드된 SWF 및 PDF 내용은 다음과 같은 경우에 사라집니다.

  • HTMLLoader 객체의 크기를 1.0이 아닌 인수로 조절하는 경우

  • HTMLLoader 객체의 알파 속성을 1.0이 아닌 값으로 설정하는 경우

  • HTMLLoader 내용을 회전하는 경우

잘못된 속성 설정을 제거하고 활성 필터를 제거하면 내용이 다시 나타납니다.

또한 런타임은 투명 윈도우에 PDF 내용을 표시할 수 없습니다. 객체의 wmode 매개 변수나 embed 태그가 opaque 또는 transparent 로 설정된 경우에만 HTML 페이지에 포함된 SWF 내용이 표시됩니다. wmode 의 기본값은 window 이므로 wmode 매개 변수를 명시적으로 설정하지 않으면 투명 윈도우에 SWF 내용이 표시되지 않습니다.

참고: AIR 1.5.2 이전에는 어떤 wmode 값을 사용하더라도 HTML에 포함된 SWF를 표시할 수 없었습니다.

HTMLLoader에서 이러한 유형의 미디어를 로드하는 방법에 대한 자세한 내용은 HTML에 SWF 내용 포함 AIR에서 PDF 내용 추가 를 참조하십시오.

고급 표시 속성

HTMLLoader 클래스는 특수 효과에 사용할 수 있는 몇 가지 메서드를 상속합니다. 일반적으로 이러한 효과는 HTMLLoader 표시에서 사용될 때 제한이 따르지만 전환이나 다른 임시 효과에 유용할 수 있습니다. 예를 들어, 사용자 입력을 수집하기 위해 대화 상자 윈도우를 표시하는 경우 사용자가 대화 상자를 닫을 때까지 기본 윈도우의 표시를 흐리게 나타낼 수 있습니다. 이와 마찬가지로 윈도우를 닫을 때 표시를 점차 사라지게 할 수도 있습니다.

고급 표시 속성은 다음과 같습니다.

속성

제한

alpha

HTML 내용의 가독성을 줄일 수 있습니다.

filters

HTML 윈도우에서 외부 효과가 윈도우 가장자리로 잘립니다.

graphics

그래픽 명령으로 그려진 모양이 기본 배경을 비롯한 HTML 내용 아래에 나타납니다. 그려진 모양이 표시되려면 paintsDefaultBackground 속성이 false여야 합니다.

opaqueBackground

기본 배경색을 변경하지 않습니다. 이 색상 레이어가 표시되려면 paintsDefaultBackground 속성이 false여야 합니다.

rotation

사각형 HTMLLoader 영역의 모서리가 윈도우 가장자리로 잘릴 수 있습니다. HTML 내용에 로드된 SWF 및 PDF 내용이 표시되지 않습니다.

scaleX , scaleY

비율 인수가 1보다 크면 렌더링된 표시가 픽셀화되어 나타날 수 있습니다. HTML 내용에 로드된 SWF 및 PDF 내용이 표시되지 않습니다.

transform

HTML 내용의 가독성을 줄일 수 있습니다. HTML 표시가 윈도우 가장자리로 잘릴 수 있습니다. 변환에 회전, 크기 조절 또는 기울기가 포함된 경우 HTML 내용에 로드된 SWF 및 PDF 내용이 표시되지 않습니다.

다음 예제에서는 전체 HTML 표시를 흐리게 나타내도록 filters 배열을 설정하는 방법을 보여 줍니다.

var html:HTMLLoader = new HTMLLoader(); 
var urlReq:URLRequest = new URLRequest("http://www.adobe.com/"); 
html.load(urlReq); 
html.width = 800; 
html.height = 600; 
 
var blur:BlurFilter = new BlurFilter(8); 
var filters:Array = [blur]; 
html.filters = filters;