Korzystanie ze składnika UILoader

Składnik UILoader jest kontenerem, w którym mogą być wyświetlane pliki SWF, JPEG, progresywne JPEG, PNG i GIF. Składnik UILoader może być używany zawsze, gdy wymagane jest pobranie treści z lokalizacji zdalnej i umieszczenie jej w aplikacji Flash. Przykład: składnik UILoader może służyć w celu dodania logo przedsiębiorstwa (plik JPEG) do formularza. Składnik UILoader może być również używany w aplikacji, która wyświetla zdjęcia. Użyj metody load() w celu załadowania treści, właściwości percentLoaded w celu określenia ilości treści załadowanej, a zdarzenia complete w celu ustalenia, czy ładowanie zostało zakończone.

Możliwe jest skalowanie treści składnika UILoader lub zmiana wielkości samego składnika UILoader w celu dostosowania jego wielkości do treści. Domyślnie skala treści umożliwia dopasowanie jej do składnika UILoader. Treść można również ładować w czasie wykonywania i monitorować postęp ładowania (jednak po załadowaniu treści do pamięci podręcznej postęp szybko wzrasta do 100%). Jeśli położenie zostanie określone podczas ładowania treści do składnika UILoader, należy określić położenie (współrzędne X i Y) jako 0, 0.

Posługiwanie się składnikiem UILoader

Składnik UILoader nie może być aktywowany. Jednak możliwe jest aktywowanie treści składnika UILoader i możliwa jest obsługa aktywnej treści. Więcej informacji na temat sterowania aktywnością zawiera opis klasy FocusManager w Skorowidzu języka ActionScript 3.0 dla programu Flash Professional oraz w sekcji Praca z klasą FocusManager .

Parametry składnika UILoader

Dla każdej instancji składnika UILoader można w Inspektorze właściwości lub w Inspektorze składników ustawić następujące parametry tworzenia treści: autoLoad , maintainAspectRatio , source i scaleContent . Każdy z parametrów posiada odpowiadającą mu właściwość ActionScript o tej samej nazwie.

Podgląd aktywny każdej instancji UILoader odzwierciedla zmiany dokonane w parametrach w Inspektorze właściwości oraz Inspektorze składników podczas tworzenia.

W kodzie ActionScript możliwe jest ustawienie dodatkowych opcji dla składnika UILoader z wykorzystaniem jego metod, właściwości i zdarzeń. Więcej informacji zawiera opis klasy UILoader w Skorowidzu języka ActionScript 3.0 dla programu Flash Professional .

Tworzenie aplikacji ze składnikiem UILoader

Poniższa procedura wyjaśnia jak podczas tworzenia dodać składnik UILoader do aplikacji. W tym przykładzie moduł ładowania ładuje obraz GIF logo.

  1. Utwórz nowy dokument Flash (ActionScript 3.0).

  2. Przeciągnij składnik UILoader z panelu Składniki na stół montażowy.

  3. W Inspektorze właściwości wprowadź dla instancji nazwę aUI .

  4. Wybierz moduł ładowania na stole montażowym oraz w Inspektorze składników, a następnie wprowadź wartość http://www.helpexamples.com/images/logo.gif dla parametru source .

Tworzenie instancji składnika UILoader przy użyciu kodu ActionScript

W tym przykładzie tworzony jest składnik UILoader za pomocą języka ActionScript i ładowany jest obraz JPEG kwiatka. Gdy wystąpi zdarzenie complete , następuje wyświetlenie liczby bajtów załadowanych na panelu Wyjście.

  1. Utwórz nowy dokument Flash (ActionScript 3.0).

  2. Przeciągnij składnik UILoader z panelu Składniki do panelu Biblioteka.

  3. Otwórz panel Operacje, zaznacz klatkę nr 1 na głównej osi czasu i wprowadź następujący kod ActionScript: 

    import fl.containers.UILoader; 
 
var aLoader:UILoader = new UILoader(); 
aLoader.source = "http://www.flash-mx.com/images/image1.jpg"; 
aLoader.scaleContent = false; 
addChild(aLoader); 
 
aLoader.addEventListener(Event.COMPLETE, completeHandler); 
function completeHandler(event:Event) { 
    trace("Number of bytes loaded: " + aLoader.bytesLoaded); 
}

  4. Wybierz polecenie Sterowanie > Testuj film.