Właściwości wyświetlania obiektów HTMLLoader

Podstawowe właściwości wyświetlania obiektu HTMLLoader umożliwiają umieszczenie obiektu sterowania w jego nadrzędnym obiekcie wyświetlanym w celu ustawienia wielkości oraz w celu wyświetlenia lub ukrycia elementu sterowania. Tych właściwości nie należy zmieniać dla obiektu HTMLLoader okna HTML.

Do właściwości podstawowych należą:

Poza oknem HTML właściwości width i height obiektu HTMLLoader mają domyślnie wartość 0. Właściwości width i height należy zmienić zanim załadowana treść HTML zostanie wyświetlona. Treść HTML zostanie narysowana zgodnie z rozmiarem HTMLLoader i wyświetlona zgodnie z właściwościami HTML i CSS treści. Zmiana wielkości obiektu HTMLLoader powoduje ponowne ułożenie jego zawartości.

Podczas ładowania treści do nowego obiektu HTMLLoader (z właściwością width równą 0) kuszące może być ustawienie wartości width i height wyświetlanego obiektu HTMLLoader za pomocą właściwości contentWidth i contentHeight . Ta technika działa dla stron, które mają odpowiednią minimalną szerokość po wyświetleniu zgodnie z regułami strumienia HTML i CSS. Jeśli jednak dla obiektu HTMLLoader nie określono odpowiedniej szerokości, wówczas niektóre strony są wyświetlane jako stosunkowo długie i wąskie.

Właściwość paintsDefaultBackground obiektu HTMLLoader, która ma domyślnie wartość true , określa, czy obiekt HTMLLoader jest rysowany z nieprzezroczystym tłem. Jeśli właściwość paintsDefaultBackground ma wartość false , wówczas tło jest przezroczyste. Kontener obiektu wyświetlanego lub inne obiekty wyświetlane poniżej obiektu HTMLLoader są widoczne za elementami widocznymi na pierwszym planie treści HTML.

Jeśli element body lub inny element treści HTML określa kolor tła (np. za pomocą style="background-color:gray" ), wówczas tło tej części HTML jest nieprzezroczyste i wyświetlane w określonym kolorze. Jeśli właściwość opaqueBackground obiektu HTMLLoader oraz obiektu paintsDefaultBackground ma wartość false , wówczas kolor ustawiony dla właściwości opaqueBackground będzie widoczny.

Nie należy zmieniać skali obiektu HTMLLoader powyżej wartości współczynnika 1.0. Tekst w treści HTMLLoader jest renderowana z określoną rozdzielczością i po zwiększeniu skali widoczne będą poszczególne piksele obiektu HTMLLoader. Aby zapobiec skalowaniu obiektu HTMLLoader oraz jego treści podczas zmiany wielkości okna, należy ustawić właściwość scaleMode stołu montażowego na StageScaleMode.NO_SCALE .

Treść SWF i PDF wczytana do obiektu HTMLLoader nie jest wyświetlana w następujących okolicznościach:

• W przypadku zmiany skali obiektu HTMLLoader na współczynnik inny niż 1.0.

• Jeśli właściwość alpha obiektu HTMLLoader zostanie ustawiona na wartość inną niż 1.0.

• W przypadku obrócenia treści obiektu HTMLLoader.

Treść pojawia się ponownie po usunięciu niezgodnego ustawienia właściwości i usunięciu filtrów aktywnych.

Ponadto środowisko wykonawcze nie może wyświetlać treści PDF w oknach przezroczystych. W środowisku wykonawczym treść SWF osadzona na stronie HTML jest wyświetlana tylko wówczas, gdy parametr wmode obiektu lub osadzony znacznik ma wartość opaque lub transparent . Ponieważ wartość domyślna parametru wmode to window , treść SWF nie jest wyświetlana w oknach przezroczystych, chyba że zostanie jawnie ustawiony parametr wmode.

Więcej informacji na temat ładowania tych typów nośników do obiektu HTMLLoader zawiera sekcja Osadzanie treści SWF w kodzie HTML oraz Dodawanie treści PDF w środowisku AIR .

Klasa HTMLLoader dziedziczy kilka metod, które mogą być używane w celu tworzenia efektów specjalnych. W ogólnym wypadku dla tych efektów obowiązują ograniczenia, gdy są używane z wyświetlanymi obiektami HTMLLoader, ale mogą być użyteczne dla przejść lub innych tymczasowych efektów. Na przykład: jeśli wyświetlane jest okno dialogowe w celu gromadzenia danych wprowadzonych przez użytkownika można zmniejszyć ostrość wyświetlania okna głównego do czasu zamknięcia okna dialogowego. I podobnie — można również spowodować znikanie podczas zamykania okna.

Do zaawansowanych właściwości wyświetlania należą:

Poniższy przykład ilustruje sposób ustawiania tablicy filters w celu zmniejszenia ostrości całego wyświetlanego obszaru HTML:

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;