| Pakiet | flash.html |
| Klasa | public class HTMLHost |
| Dziedziczenie | HTMLHost  Object |
| Wersje środowiska wykonawczego: | AIR 1.0 |
window strony HTML. Te metody i właściwości to:
-
window.blur() -
window.focus() -
window.moveBy() -
window.moveTo() -
window.location -
window.close() -
window.open() -
window.resizeBy() -
window.resizeTo() -
window.status -
window.document.title
Metody w klasie HTMLHost udostępniają sposoby obsługi zmian w przypadku tych ustawień window. Aby korzystać z tej klasy, należy utworzyć nową klasę (podklasę) rozszerzającą klasę HTMLHost i przysłaniającą metody, dla których definiowane będą zachowania. Metody klasy HTMLHost obsługują właściwości i metody JavaScript w następujący sposób:
| Właściwość lub metoda JavaScript | Metoda HTMLHost |
|---|---|
window.blur()
|
windowBlur()
|
window.focus()
|
windowFocus
|
window.location
|
updateLocation
|
window.close()
|
windowClose
|
window.open()
|
createWindow
|
window.status
|
updateStatus
|
window.document.title
|
updateTitle
|
Aby reagować na zmiany w metodzie window.moveBy(), window.moveTo(), window.resizeBy() oraz window.resizeTo(), należy przesłonić·metodę set windowRect() w podklasie HTMLHost.
Każdy obiekt HTMLHost można skojarzyć maksymalnie z jednym obiektem HTMLLoader. Relację tę tworzy przypisanie instancji HTMLHost do właściwości htmlHost obiektu HTMLLoader. HTMLHost zostaje usunięty z pierwszego obiektu HTMLLoader poprzez przypisanie wartości null do właściwości htmlHost obiektu HTMLLoader lub ustawienie obiektu HTMLHost jako właściwość htmlHost innego obiektu HTMLLoader.
Powiązane elementy interfejsu API
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| htmlLoader : flash.html:HTMLLoader [tylko do odczytu]
Obiekt HTMLLoader, do którego stosuje się ten obiekt HostControl. | HTMLHost | ||
| windowRect : Rectangle
Właściwość zmieniana podczas wywoływania metody window.moveBy(), window.moveTo(), window.resizeBy() lub window.resizeTo() za pomocą kodu JavaScript w obiekcie HTMLLoader. | HTMLHost | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
Tworzy obiekt HTMLHost. | HTMLHost | ||
Funkcja zostaje wywołana podczas wywoływania metody window.open() przez kod JavaScript w obiekcie HTMLLoader. | HTMLHost | ||
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
|
Zwraca ciąg reprezentujący określony obiekt. | Object | |
Funkcja zostaje wywołana podczas ustawiania właściwości window.location za pomocą kodu JavaScript w obiekcie HTMLLoader. | HTMLHost | ||
Funkcja zostaje wywołana podczas ustawiania właściwości window.status za pomocą kodu JavaScript w obiekcie HTMLLoader. | HTMLHost | ||
Funkcja zostaje wywołana podczas ustawiania właściwości window.document.title za pomocą kodu JavaScript w obiekcie HTMLLoader lub podczas zmiany elementu title poprzez standardy DOM lub w wyniku ładowania nowej strony. | HTMLHost | ||
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
Funkcja zostaje wywołana podczas wywoływania metody window.blur() za pomocą kodu JavaScript w obiekcie HTMLLoader. | HTMLHost | ||
Funkcja zostaje wywołana podczas wywoływania metody window.close() za pomocą kodu JavaScript w obiekcie HTMLLoader. | HTMLHost | ||
Funkcja zostaje wywołana podczas wywoływania metody window.focus() za pomocą kodu JavaScript w obiekcie HTMLLoader. | HTMLHost | ||
htmlLoader | właściwość |
htmlLoader:flash.html:HTMLLoader [tylko do odczytu] | Wersje środowiska wykonawczego: | AIR 1.0 |
Obiekt HTMLLoader, do którego stosuje się ten obiekt HostControl. Właściwość htmlHost obiektu HTMLLoader jest ustawiona dla tego obiektu HostControl.
Implementacja
public function get htmlLoader():flash.html:HTMLLoaderPowiązane elementy interfejsu API
windowRect | właściwość |
windowRect:Rectangle| Wersje środowiska wykonawczego: | AIR 1.0 |
Właściwość zmieniana podczas wywoływania metody window.moveBy(), window.moveTo(), window.resizeBy() lub window.resizeTo() za pomocą kodu JavaScript w obiekcie HTMLLoader.
W podklasie HTMLHost należy przesłonić metodę set windowRect(), aby w żądany sposób obsługiwać granice okna.
Implementacja
public function get windowRect():Rectangle public function set windowRect(value:Rectangle):void HTMLHost | () | Konstruktor |
createWindow | () | metoda |
public function createWindow(windowCreateOptions:flash.html:HTMLWindowCreateOptions):flash.html:HTMLLoader| Wersje środowiska wykonawczego: | AIR 1.0 |
Funkcja zostaje wywołana podczas wywoływania metody window.open() przez kod JavaScript w obiekcie HTMLLoader.
Domyślnie wywołanie za pomocą JavaScript metody window.open() na stronie HTML obiektu HTMLLoader nie otwiera nowego obiektu NativeWindow w środowisku wykonaczym. Nowy obiekt NativeWindow można otworzyć w środowisku wykonaczym przez utworzenie nowego obiektu NativeWindow za pomocą metody createWindow przesłoniętej w podklasie klasy HTMLHost.
Parametry
windowCreateOptions:flash.html:HTMLWindowCreateOptions — Obiekt zawierający właściwości w ciągu znaków przekazany jako parametr features wywołania do window.open().
|
flash.html:HTMLLoader — Obiekt HTMLLoader zawierający nową stronę HTML. Nowe obiekty HTMLLoader tworzy się zazwyczaj za pomocą tej metody, dodaje do stołu montażowego nowego obiektu NativeWindow, a następnia zwraca.
|
updateLocation | () | metoda |
public function updateLocation(locationURL:String):void| Wersje środowiska wykonawczego: | AIR 1.0 |
Funkcja zostaje wywołana podczas ustawiania właściwości window.location za pomocą kodu JavaScript w obiekcie HTMLLoader.
Parametry
locationURL:String — Wartość, na jaką zostaje ustawiona właściwość location właściwości window obiektu HTMLLoader.
|
updateStatus | () | metoda |
public function updateStatus(status:String):void| Wersje środowiska wykonawczego: | AIR 1.0 |
Funkcja zostaje wywołana podczas ustawiania właściwości window.status za pomocą kodu JavaScript w obiekcie HTMLLoader.
Parametry
status:String — Wartość, na jaką zostaje ustawiona właściwość status właściwości window obiektu HTMLLoader.
|
updateTitle | () | metoda |
public function updateTitle(title:String):void| Wersje środowiska wykonawczego: | AIR 1.0 |
Funkcja zostaje wywołana podczas ustawiania właściwości window.document.title za pomocą kodu JavaScript w obiekcie HTMLLoader lub podczas zmiany elementu title poprzez standardy DOM lub w wyniku ładowania nowej strony.
Parametry
title:String — Wartość, na jaką zostaje ustawiona właściwość window.document.title obiektu HTMLLoader.
|
windowBlur | () | metoda |
public function windowBlur():void| Wersje środowiska wykonawczego: | AIR 1.0 |
Funkcja zostaje wywołana podczas wywoływania metody window.blur() za pomocą kodu JavaScript w obiekcie HTMLLoader.
windowClose | () | metoda |
public function windowClose():void| Wersje środowiska wykonawczego: | AIR 1.0 |
Funkcja zostaje wywołana podczas wywoływania metody window.close() za pomocą kodu JavaScript w obiekcie HTMLLoader.
Domyślnie wywołanie za pomocą JavaScript metody window.close() na stronie HTML obiektu HTMLLoader zamyka okna zawierajace obiekt HTMLLoader.
windowFocus | () | metoda |
public function windowFocus():void| Wersje środowiska wykonawczego: | AIR 1.0 |
Funkcja zostaje wywołana podczas wywoływania metody window.focus() za pomocą kodu JavaScript w obiekcie HTMLLoader.
window:
package
{
import flash.html.HTMLHost;
import flash.html.HTMLLoader;
import flash.display.NativeWindow;
import flash.display.NativeWindowInitOptions;
import flash.display.StageScaleMode;
import flash.geom.Rectangle;
import flash.text.TextField;
public class CustomHost extends HTMLHost
{
import flash.html.*;
public var statusField:TextField;
public function CustomHost(defaultBehaviors:Boolean=true)
{
super(defaultBehaviors);
}
override public function windowClose():void
{
htmlLoader.stage.window.close();
}
override public function createWindow(windowCreateOptions:HTMLWindowCreateOptions):HTMLLoader
{
var initOptions:NativeWindowInitOptions = new NativeWindowInitOptions();
var window:NativeWindow = new NativeWindow(initOptions);
window.visible = true;
var htmlLoader2:HTMLLoader = new HTMLLoader();
htmlLoader2.width = window.width;
htmlLoader2.height = window.height;
window.stage.scaleMode = StageScaleMode.NO_SCALE;
window.stage.addChild(htmlLoader2);
return htmlLoader2;
}
override public function updateLocation(locationURL:String):void
{
trace(locationURL);
}
override public function set windowRect(value:Rectangle):void
{
htmlLoader.stage.nativeWindow.bounds = value;
}
override public function updateStatus(status:String):void
{
statusField.text = status;
}
override public function updateTitle(title:String):void
{
htmlLoader.stage.nativeWindow.title = title + "- Example Application";
}
override public function windowBlur():void
{
htmlLoader.alpha = 0.5;
}
override public function windowFocus():void
{
htmlLoader.alpha = 1;
}
}
}
statusBar. Obiekt HTMLLoader definiuje obiekt CustomHost jako we własnej właściwości htmlHost:
package
{
import flash.display.Sprite;
public class SimpleHTMLBox extends Sprite
{
import flash.html.HTMLHost;
import flash.html.HTMLLoader;
import flash.text.TextField;
import flash.net.URLRequest;
import CustomHost;
private var host:CustomHost;
private var statusField:TextField;
private var html:HTMLLoader;
public function SimpleHTMLBox()
{
html = new HTMLLoader();
var url:String = "Test.html";
var urlReq:URLRequest = new URLRequest(url);
html.load(urlReq);
host = new CustomHost();
html.htmlHost = host;
statusField = new TextField();
host.statusField = statusField;
configureUI();
}
private function configureUI():void
{
html.width = 400;
html.height = 200;
statusField.width = 400;
statusField.height = 24;
statusField.border = true;
statusField.y = 200;
addChild(html);
addChild(statusField);
}
}
}Zbuduj aplikację AIR, która dodaje obiekt zdefiniowany przez tę klasę do stołu montażowego głównego okna.
Utwórz stronę HTML o nazwie Test.html w katalogu zasobów aplikacji (katalogu, który zawiera plik deskryptora aplikacji) i dodaj do niej następującą treść:
<html>
<head>
<title>Test</title>
</head>
<body>
<a href="#" onclick="window.open('Test.html')">window.open('Test.html')</a>
<br/><a href="#" onclick="window.document.location = 'www.adobe.com'">window.document.location = 'www.adobe.com'</a>
<br/><a href="#" onclick="window.moveBy(6, 12)">moveBy(6, 12)</a>
<br/><a href="#" onclick="window.close()">window.close()</a>
<br/><a href="#" onclick="window.blur()">window.blur()</a>
<br/><a href="#" onclick="window.focus()">window.focus()</a>
<br/><a href="#" onclick="window.status = new Date().toString()">window.status = new Date().toString()</a>
</body>
</html>W czasie testowania aplikacji klasa CustomHost obsługuje na stronie HTML ustawienia JavaScript związane z interfejsem użytkownika.
Tue Jun 12 2018, 12:06 PM Z