InteractiveObject  - AS3

Bieżąca implementacja dostępności (AccessibilityImplementation) dla tej instancji klasy InteractiveObject.

Powiązane elementy interfejsu API

Określa menu kontekstowe tego obiektu.

W przypadku treści działającej w programie Flash Player ta właściwość zawiera obiekt ContextMenu. W środowisku AIR klasa ContextMenu rozszerza klasę NativeMenu, jednak program Flash Player obsługuje tylko klasę ContextMenu, a nie klasę NativeMenu.

Uwaga: Menu kontekstowe obiektów TextField zawsze zawiera menu schowka. Menu schowka zawiera polecenia Wytnij, Kopiuj, Wklej, Wyczyść i Zaznacz wszystko. Tych poleceń nie można usunąć z menu kontekstowego obiektów TextField. W przypadku obiektów TextField wybieranie tych poleceń (za pomocą odpowiadających im klawiszy) nie powoduje wywoływania zdarzeń clear, copy, cut, paste ani selectAll.

var red_cmi:ContextMenuItem = new ContextMenuItem("red");
red_cmi.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, cmi_menuItemSelect);
 
var cm:ContextMenu = new ContextMenu();
cm.customItems.push(red_cmi);
cm.hideBuiltInItems();
 
var spr:Sprite = new Sprite();
spr.contextMenu = cm;
spr.graphics.beginFill(0x000000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
spr.x = 10;
spr.y = 10;
addChild(spr);
 
function cmi_menuItemSelect(evt:ContextMenuEvent):void {
    spr.graphics.clear();
    spr.graphics.beginFill(0xFF0000);
    spr.graphics.drawRect(0, 0, 120, 90);
    spr.graphics.endFill();
}

Określa, czy obiekt otrzymuje zdarzenia doubleClick. Domyślna wartość to false co oznacza, iż domyślnie instancja InteractiveObject nie otrzymuje zdarzeń doubleClick. Jeżeli właściwość doubleClickEnabled jest ustawiona na wartość true, wówczas instancja otrzymuje zdarzenia doubleClick wewnątrz swoich granic. Właściwość mouseEnabled instancji InteractiveObject również musi być ustawiona na wartość true, aby obiekt mógł otrzymywać zdarzenia doubleClick.

Ustawienie tej właściwości nie powoduje wywołania żadnego zdarzenia. Konieczne jest zastosowanie metody addEventListener() w celu dodania detektora zdarzeń dla zdarzenia doubleClick.

Powiązane elementy interfejsu API

Określa, czy z tym obiektem skojarzono ramkę aktywności. Może mieć jedną z trzech wartości: true, false lub null. Wartości true i false działają zgodnie z oczekiwaniami; określają one, czy pojawia się prostokąt oznaczający aktywność obiektu. Wartość null oznacza, że ten obiekt jest zgodny z właściwością stageFocusRect stołu montażowego.

Określa, czy ten obiekt odbiera komunikaty z myszy lub innego urządzenia wejściowego użytkownika. Domyślna wartość to true, co oznacza, że domyślnie każda instancja klasy InteractiveObject znajdująca się na liście wyświetlania odbiera zdarzenia myszy lub innego urządzenia wejściowego. Jeśli dla właściwości mouseEnabled jest ustawiona wartość false, wystąpienie nie odbiera zdarzeń myszy (ani innych zdarzeń związanych z interakcją ze strony użytkownika, na przykład zdarzeń klawiatury). Nie ma to wypływu na żaden z obiektów podrzędnych instancji z listy wyświetlania. W celu zmiany zachowania mouseEnabled dla wszystkich obiektów podrzędnych z listy wyświetlania należy zastosować funkcję flash.display.DisplayObjectContainer.mouseChildren.

Ustawienie tej właściwości nie powoduje wywołania żadnego zdarzenia. Konieczne jest zastosowanie metody addEventListener() w celu utworzenia interaktywnej funkcjonalności.

Powiązane elementy interfejsu API

Określa, czy klawiatura wirtualna (klawiatura programowa wyświetlana na ekranie) powinna być wyświetlana, gdy to wystąpienie klasy InteractiveObject staje się aktywne.

Wartością domyślną jest false, a uaktywnienie wystąpienia klasy InteractiveObject nie powoduje uniesienia klawiatury programowej. Jeśli dla właściwości needsSoftKeyboard zostanie ustawiona wartość true, to gdy wystąpienie klasy InteractiveObject będzie gotowe na przyjęcie danych wejściowych użytkownika, środowisko wykonawcze uniesie klawiaturę programową. Wystąpienie klasy InteractiveObject jest gotowe na przyjęcie danych wejściowych użytkownika po wywołaniu programowym ustawiającym właściwość focus obiektu Stage lub po oddziaływaniu ze strony użytkownika, takim jak dotknięcie. Jeśli w systemie klienta jest dostępna klawiatura sprzętowa lub ten system nie obsługuje klawiatur wirtualnych, wówczas klawiatura programowa nie zostanie uniesiona.

Gdy klawiatura programowa jest unoszona i opuszczana, wystąpienie klasy InteractiveObject wywołuje zdarzenia softKeyboardActivating, softKeyboardActivate i softKeyboardDeactivate.

Uwaga: Ta właściwość nie jest obsługiwana w aplikacjach AIR w systemie iOS.

Powiązane elementy interfejsu API

Steruje wyglądem klawiatury programowej.

Urządzenia z klawiaturą programową pozwalają dostosowywać jej przyciski do oczekiwanego typu wprowadzanych danych. Jeśli na przykład będą wprowadzane dane liczbowe, urządzenie może użyć wartości SoftKeyboardType.NUMBER w celu wyświetlania wyłącznie cyfr na klawiaturze programowej. Poprawne wartości są zdefiniowane jako stałe w klasie SoftKeyboardType:

• default
• punctuation
• url
• number
• contact
• email
• phone
• decimalpad

Te wartości stanowią wskazówki dla urządzenia ułatwiające wyświetlenie najlepszej klawiatury dla bieżącej operacji.

Wartością domyślną jest SoftKeyboardType.DEFAULT.

Powiązane elementy interfejsu API

Definiuje obszar, który powinien pozostać na ekranie po wyświetleniu klawiatury programowej (niedostępna w systemie iOS).

Jeśli właściwość needsSoftKeyboard tego obiektu InteractiveObject ma wartość true, wówczas podczas gdy użytkownik pisze, środowisko wykonawcze zgodnie z wymaganiami dostosowuje zawartość ekranu, aby obiekt był widoczny. Zwykle środowisko wykonawcze używa obwiedni obiektu uzyskanej z metody DisplayObject.getBounds(). Za pomocą właściwości softKeyboardInputAreaOfInterest można określić inny obszar.

Wartość właściwości softKeyboardInputAreaOfInterest należy określić za pomocą współrzędnych na stole montażowym.

Uwaga: W systemie Android w orientacjach poziomych właściwość softKeyboardInputAreaOfInterest nie jest przestrzegana.

Uwaga: Zmienna softKeyboardInputAreaOfInterest nie jest obsługiwana w systemie iOS.

Powiązane elementy interfejsu API

Określa, czy ten obiekt można osiągnąć za pomocą klawisza Tab. Wartość true, jeżeli obiekt ten można osiągnąć za pomocą klawisza Tab; w innym przypadku wartość false. Domyślnie wartość to false, z wyjątkiem sytuacji wymienionych poniżej:

• Wartość true dla obiektu SimpleButton.
• Wartość true dla obiektu TextField z właściwością type = "input".
• Wartość true dla obiektu Sprite lub obiektu MovieClip z właściwością buttonMode = true.

Określa kolejność uaktywniania obiektów (z pliku SWF) za pomocą klawisza Tab. Właściwość tabIndex ma domyślnie wartość -1, co oznacza iż nie jest ustawiony indeks tabulacji dla tego obiektu.

Jeżeli dowolny z obecnie wyświetlanych obiektów w pliku SWF zawiera właściwość tabIndex, wówczas automatyczna kolejność uaktywniania dla klawisza Tab jest wyłączone, zaś kolejność jest określana przez właściwości tabIndex obiektów w pliku SWF. Do własnej kolejności uaktywniania dla klawisza Tab można włączyć tylko obiekty posiadające właściwości tabIndex.

Wartością właściwości tabIndex może być nie ujemna liczba całkowita. Obiekty są porządkowane zgodnie z właściwościami tabIndex w kolejności rosnącej. Obiekt z wartością właściwości tabIndex równą 1 ma pierwszeństwo względem obiektu z wartością właściwości tabIndex równą 2. Nie należy używać tej samej wartości tabIndex dla wielu obiektów.

Własna kolejność uaktywniania definiowana przez właściwość tabIndex to flat. Oznacza to, iż nie zwraca się uwagi na stosunki hierarchiczne obiektów w pliku SWF. Wszystkie obiekty w pliku SWF z właściwościami tabIndex są układane zgodnie z kolejnością aktywacji klawiszem Tab, która jest określane przez wartości właściwości tabIndex.

Uwaga: Aby ustawić kolejność aktywacji klawiszem Tab dla instancji TLFTextField, należy wykonać rzutowanie obiektu podrzędnego obiektu wyświetlanego TLFTextField na klasę InteractiveObject, a następnie ustawić właściwość tabIndex. Na przykład:

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

Wywołanie do konstruktora new InteractiveObject() powoduje zgłoszenie wyjątku ArgumentError. Jednakże możliwe jest wywołanie konstruktorów następujących podklas obiektu InteractiveObject.

• new SimpleButton()
• new TextField()
• new Loader()
• new Sprite()
• new MovieClip()

Powoduje uniesienie klawiatury wirtualnej.

Wywołanie tej metody powoduje uaktywnienie wystąpienia klasy InteractiveObject i, w razie konieczności, uniesienie klawiatury programowej. Właściwość needsSoftKeyboard również musi mieć wartość true. Klawiatura nie zostaje uniesiona, jeśli jest dostępna klawiatura sprzętowa lub system klienta nie obsługuje klawiatur wirtualnych.

Uwaga: Ta metoda nie jest obsługiwana w aplikacjach AIR w systemie iOS.

Powiązane elementy interfejsu API

Wywoływane, gdy użytkownik wybierz opcje „Wyczyść” (lub „Usuń”) z menu kontekstowego dla tekstu. Zdarzenie jest wywoływane dla obiektu, który obecnie jest aktywny. Jeśli obiektem aktualnie aktywnym jest pole TextField, domyślnie działanie tego zdarzenia powoduje usunięcie całego tekstu zaznaczonego w polu tekstowym.

To zdarzenie ma następujące właściwości:

Uwaga: Obiekty TextField nie wywołują zdarzeń clear, copy, cut, paste ani selectAll. Dla obiektów TextField polecenia Wytnij, Kopiuj, Wklej, Usuń i Zaznacz wszystko są zawsze dostępne w menu kontekstowym. Tych poleceń nie można usunąć z menu kontekstowego obiektów TextField. W przypadku obiektów TextField wybieranie tych poleceń (za pomocą odpowiadających im klawiszy) nie powoduje wywoływania zdarzeń clear, copy, cut, paste ani selectAll. Jednak inne klasy rozszerzające klasę InteractiveObject, łączenie z elementami zbudowanymi za pomocą mechanizmu Flash Text Engine (FTE), spowodują wywołanie tych zdarzeń w odpowiedzi na działania użytkownika takie jak używanie skrótów klawiaturowych i menu kontekstowych.

Wywoływane w momencie naciśnięcia i zwolnienia głównego przycisku urządzenia wskazującego przez użytkownika na tej samej instancji InteractiveObject. Wystąpienie zdarzenia kliknięcia jest możliwe tylko po wystąpieniu zdarzeń w tej kolejności: zdarzenie mouseDown, a następnie MouseUp. Obiekt docelowy musi być identyczny w dla obu tych zdarzeń. W innym przypadku zdarzenie click nie występuje. Dowolna liczba innych zdarzeń myszy może wystąpić w dowolnym momencie pomiędzy zdarzeniami mouseDown i mouseUp; mimo tego zdarzenie click wciąż występuje.

To zdarzenie ma następujące właściwości:

Wywoływane, gdy w wyniku gestu użytkownika zostanie uaktywnione menu kontekstowe skojarzone z tym obiektem interaktywnym w aplikacji AIR.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Wywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację kopiowania lub wybiera polecenie Kopiuj z menu kontekstowego dla tekstu. Zdarzenie jest wywoływane dla obiektu, który obecnie jest aktywny. Jeśli obiektem aktualnie aktywnym jest pole TextField, domyślnie działanie tego zdarzenia powoduje skopiowanie do schowka całego tekstu zaznaczonego w polu tekstowym.

To zdarzenie ma następujące właściwości:

Uwaga: Obiekty TextField nie wywołują zdarzeń clear, copy, cut, paste ani selectAll. Dla obiektów TextField polecenia Wytnij, Kopiuj, Wklej, Usuń i Zaznacz wszystko są zawsze dostępne w menu kontekstowym. Tych poleceń nie można usunąć z menu kontekstowego obiektów TextField. W przypadku obiektów TextField wybieranie tych poleceń (za pomocą odpowiadających im klawiszy) nie powoduje wywoływania zdarzeń clear, copy, cut, paste ani selectAll. Jednak inne klasy rozszerzające klasę InteractiveObject, łączenie z elementami zbudowanymi za pomocą mechanizmu Flash Text Engine (FTE), spowodują wywołanie tych zdarzeń w odpowiedzi na działania użytkownika takie jak używanie skrótów klawiaturowych i menu kontekstowych.

Wywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację wycięcia lub wybiera polecenie Wytnij z menu kontekstowego dla tekstu. Zdarzenie jest wywoływane dla obiektu, który obecnie jest aktywny. Jeśli obiektem aktualnie aktywnym jest pole TextField, domyślnie działanie tego zdarzenia powoduje wycięcie do schowka całego tekstu zaznaczonego w polu tekstowym.

To zdarzenie ma następujące właściwości:

Uwaga: Obiekty TextField nie wywołują zdarzeń clear, copy, cut, paste ani selectAll. Dla obiektów TextField polecenia Wytnij, Kopiuj, Wklej, Usuń i Zaznacz wszystko są zawsze dostępne w menu kontekstowym. Tych poleceń nie można usunąć z menu kontekstowego obiektów TextField. W przypadku obiektów TextField wybieranie tych poleceń (za pomocą odpowiadających im klawiszy) nie powoduje wywoływania zdarzeń clear, copy, cut, paste ani selectAll. Jednak inne klasy rozszerzające klasę InteractiveObject, łączenie z elementami zbudowanymi za pomocą mechanizmu Flash Text Engine (FTE), spowodują wywołanie tych zdarzeń w odpowiedzi na działania użytkownika takie jak używanie skrótów klawiaturowych i menu kontekstowych.

Wywoływane w momencie, gdy użytkownik naciska i zwalnia główny przycisk urządzenia wskazującego dwukrotnie w krótkim odstępie czasu nad tym samym obiektem InteractiveObject, podczas gdy flaga doubleClickEnabled obiektu jest ustawiona na wartość true. Wystąpienie zdarzenia doubleClick jest możliwe tylko po wystąpieniu zdarzeń w tej kolejności: mouseDown, mouseUp, click, mouseDown, mouseUp. Wszystkie te zdarzenia muszą mieć ten sam cel co zdarzenie doubleClick. Drugie kliknięcie, reprezentowane przez drugie zdarzenia mouseDown i mouseUp, musi wystąpić w określonym okresie czasu po zdarzeniu click. Dozwolona długość tego okresu czasu jest zmienna w zależności od systemu operacyjnego, a często może być również konfigurowana przez użytkownika. Jeżeli celem jest pole tekstowe możliwe do wybrania, wówczas słowo znajdujące się pod wskaźnikiem jest wybierane jako zachowanie domyślne. Jeżeli docelowy obiekt InteractiveObject nie posiada flagi doubleClickEnabled ustawionej na wartość true, wówczas otrzymuje dwa zdarzenia click.

Domyślnie właściwość doubleClickEnabled ma wartość false.

Zachowanie wyboru tekstu przez dwukrotne kliknięcie myszą obiektu TextField nie jest związane ze zdarzeniem doubleClick. Należy wykorzystać właściwość TextField.doubleClickEnabled w celu kontrolowania sposobu wybierania w obiektach TextField.

To zdarzenie ma następujące właściwości:

Powiązane elementy interfejsu API

Wywoływane po uzyskaniu aktywności przez obiekt wyświetlany. Dzieje się to w momencie podświetlenia obiektu przez użytkownika przy użyciu urządzenia wskazującego lub nawigacji klawiaturą. Obiekt, który stał się aktywny, jest nazywany obiektem docelowym tego zdarzenia, podczas gdy odpowiednia instancja InteractiveObject, która utraciła aktywność, jest nazwana obiektem powiązanym. Odwołanie do obiektu związanego jest przechowywane we właściwości relatedObject obiektu uzyskującego. Właściwość shiftKey nie jest stosowana. Zdarzenie to następuje po wywołaniu poprzedniego zdarzenia focusOut.

To zdarzenie ma następujące właściwości:

Wywoływane po utracie aktywności przez obiekt wyświetlany. Dzieje się to w momencie podświetlenia innego obiektu przez użytkownika przy użyciu urządzenia wskazującego lub nawigacji klawiaturą. Obiekt, który utracił aktywność, jest nazwany obiektem docelowym tego zdarzenia, podczas gdy odpowiednia instancja InteractiveObject, która stała się aktywna, jest nazwana obiektem powiązanym. Odwołanie do obiektu związanego jest przechowywane we właściwości relatedObject obiektu docelowego. Właściwość shiftKey nie jest stosowana. Zdarzenie to uprzedza wywołanie zdarzenia focusIn przez obiekt związany.

To zdarzenie ma następujące właściwości:

Zostaje rozesłane, gdy użytkownik utworzy punkt styku wzdłuż krawędzi powierzchni dotykowej z instancją obiektu InteractiveObject (np. dotknięcie wzdłuż krawędzi powierzchni dotykowej pilota Siri Remote do telewizora firmy Apple). Niektóre urządzenia mogą również interpretować taki styk, jako kombinację różnych zdarzeń dotykowych.

W szczególności, jeśli użytkownik dotknie jednym palcem obiekt InteractiveObject, a następnie dodatkowo odsunie palce, instancja InteractiveObject może rozesłać zdarzenie touchBegin i zdarzenie touchEnd (między innymi), a nie tylko zdarzenie gestureDirectionalTap, o ile bieżące środowisko obsługuje taki gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie touchBegin, wówczas ten sam podprogram obsługi zdarzenia będzie działał na urządzeniu dotykowym. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie gestureDirectionalTap, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia gestu, a inaczej na zdarzenia dotyku. Jednak to klasa flash.ui.Multitouch decyduje, czy uruchomione zostaje zdarzenie dotyku czy zdarzenie gestu.

Korzystając z właściwości obiektu zdarzenia, należy zwrócić uwagę, że właściwości localX i localY określają podstawowy punkt kontaktu (w przypadku telewizora firmy Apple jest to środek ekranu). Właściwości offsetX i offsetY odpowiadają kierunkowi gestu.

Uwaga: ten interfejs API obsługuje wyłącznie dotknięcia kierunkowe jednym palcem.

Wywołany obiekt TransformGestureEvent ma następujące właściwości:

Powiązane elementy interfejsu API

Wywoływane, gdy użytkownik naciśnie na dwa punkty kontaktu nad tą samą instancją klasy InteractiveObject na urządzeniu dotykowym (np. naciśnie dwoma palcami i zwolni obiekt wyświetlany na ekranie dotykowym telefonu komórkowego lub tabletu). Niektóre urządzenia mogą też zinterpretować ten kontakt jako zdarzenie doubleClick.

W szczególności, jeśli użytkownik stuknie dwoma palcami w instancję klasy InteractiveObject, instancja ta może wywołać zdarzenie doubleClick i/lub zdarzenie gestureTwoFingerTap, o ile bieżące środowisko obsługuje ten gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie doubleClick, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie gestureTwoFingerTap, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.

Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.

Powiązane elementy interfejsu API

Wywoływane, gdy użytkownik przesuwa punkt kontaktu nad wystąpieniem klasy InteractiveObject na urządzeniu dotykowym (na przykład przez przesuwanie palców z lewej strony na prawą nad obiektem ekranowym na telefonie komórkowym lub tablecie z ekranem dotykowym). Niektóre urządzenia mogą zinterpretować ten kontakt jako zdarzenie mouseOver i jako zdarzenie touchOver.

W szczególności, jeśli użytkownik przesunie palec nad obiekt InteractiveObject, instancja InteractiveObject może wywołać zdarzenie mouseOver, touchOver, gesturePan lub wszystkie te zdarzenia, o ile bieżące środowisko obsługuje taki gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie mouseOver, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie gesturePan, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.

Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.

Wywołany obiekt TransformGestureEvent ma następujące właściwości:

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onPan(evt:TransformGestureEvent):void {

    evt.target.localX++;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Powiązane elementy interfejsu API

Wywoływane, gdy użytkownik wykona gest obrotu w punkcie kontaktu z instancją klasy InteractiveObject (np. dotknie obiektu wyświetlanego dwoma palcami i obróci palce na ekranie dotykowym telefonu komórkowego lub tabletu). Obrót dwóch palców jest typowym gestem obracania, jednak każde urządzenie i każdy system operacyjny może mieć własne wymagania co do sposobu aktywacji obrotu. Niektóre urządzenia mogą zinterpretować taki gest jako kombinację kilku zdarzeń myszy.

W szczególności, jeśli użytkownik przesunie palec nad obiekt InteractiveObject, instancja InteractiveObject może wywołać zdarzenie mouseOver i zdarzenie click (między innymi), a nie tylko zdarzenie gestureRotate, o ile bieżące środowisko obsługuje ten gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie mouseOver, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie gestureRotate, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.

Korzystając z właściwości obiektu zdarzenia, należy zwrócić uwagę, że właściwości localX i localY określają podstawowy punkt kontaktu. Właściwości offsetX i offsetY to odległość od punktu kontaktu, w której zakończył się gest obrotu.

Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.

W czasie tego zdarzenia właściwość rotation zawiera wartość kąta obrotu. Wartości obrotu są następujące:

• Od 0 do 180 stopni dla obrotów w prawo.
• Od –180 do 0 stopni dla obrotów w lewo.

Wywołany obiekt TransformGestureEvent ma następujące właściwości:

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onRotate(evt:TransformGestureEvent):void {

    evt.target.rotation -= 45;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Powiązane elementy interfejsu API

Wywoływane, gdy użytkownik wykona gest machnięcia w punkcie kontaktu na instancji obiektu InteractiveObject (np. dotknięcie trzema złączonymi palcami ekranu, a następnie szybkie przesunięcie ich nad obiektem wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). Przesunięcie kilku złączonych palców jest typowym gestem machnięcia, jednak każde urządzenie i system operacyjny może wymagać innego sposobu realizacji tego gestu. Niektóre urządzenia mogą zinterpretować taki gest jako kombinację kilku zdarzeń myszy.

W szczególności, jeśli użytkownik przesunie jeden palec nad obiektem InteractiveObject, a następnie złączy palce, instancja InteractiveObject może wywołać zdarzenie rollOver i zdarzenie rollOut (między innymi), a nie tylko zdarzenie gestureSwipe, o ile bieżące środowisko obsługuje taki gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Jeśli kod użytkownika będzie obsługiwał zdarzenie rollOver, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie gestureSwipe, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.

Korzystając z właściwości obiektu zdarzenia, należy zwrócić uwagę, że właściwości localX i localY określają podstawowy punkt kontaktu. Właściwości offsetX i offsetY to odległość od punktu kontaktu, w której zakończył się gest machnięcia.

Uwaga: Wprawdzie niektóre urządzenia z systemem operacyjnym Mac OS mogą prawidłowo interpretować machnięcie czterema palcami, ten interfejs API obsługuje tylko machnięcie trzema palcami.

Wywołany obiekt TransformGestureEvent ma następujące właściwości:

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onSwipe(evt:TransformGestureEvent):void {

    if (evt.offsetX == 1 ) {
    myTextField.text = "right";
    }
    if (evt.offsetY == -1) {
    myTextField.text = "up";
    }
    myTextField.text = evt.phase;

}

Powiązane elementy interfejsu API

Wywoływane, gdy użytkownik utworzy punkt kontaktu z instancją obiektu InteractiveObject, a następnie stuknie w urządzenie dotykowe (np. przyłoży kilka palców do obiektu wyświetlanego w celu otwarcia menu, a następnie stuknie jednym palcem, aby wybrać element menu na ekranie dotykowym telefonu komórkowego lub tabletu). Niektóre urządzenia mogą zinterpretować taki gest jako kombinację kilku zdarzeń myszy.

W szczególności, jeśli użytkownik przesunie jeden palec nad obiekt InteractiveObject, a następnie dodatkowo stuknie, instancja InteractiveObject może wywołać zdarzenie mouseOver i zdarzenie click (między innymi), a nie tylko zdarzenie gesturePressAndTap, o ile bieżące środowisko obsługuje taki gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie mouseOver, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie gesturePressAndTap, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.

Korzystając z właściwości obiektu zdarzenia, należy zwrócić uwagę, że właściwości localX i localY określają podstawowy punkt kontaktu („przyłożenia”). Właściwości offsetX i offsetY to odległości do dodatkowego punktu kontaktu („stuknięcia”).

Powiązane elementy interfejsu API

Wywoływane, gdy użytkownik wykona gest powiększenia w punkcie kontaktu na instancji obiektu InteractiveObject (np. dotknięcie dwoma palcami ekranu, a następnie szybkie rozsunięcie palców nad obiektem wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). Rozsunięcie palców jest typowym gestem powiększenia, jednak każde urządzenie i każdy system operacyjny może mieć własne wymagania co do sposobu aktywacji powiększenia. Niektóre urządzenia mogą zinterpretować taki gest jako kombinację kilku zdarzeń myszy.

W szczególności, jeśli użytkownik przesunie jeden palec nad obiekt InteractiveObject, a następnie rozsunie palce, instancja InteractiveObject może wywołać zdarzenie mouseOver i zdarzenie click (między innymi), a nie tylko zdarzenie gestureZoom, o ile bieżące środowisko obsługuje taki gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie mouseOver, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie gestureZoom, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.

Korzystając z właściwości obiektu zdarzenia, należy zwrócić uwagę, że właściwości localX i localY określają podstawowy punkt kontaktu. Właściwości offsetX i offsetY to odległość od punktu kontaktu, w której zakończył się gest powiększania.

Uwaga: Informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.

Wywołany obiekt TransformGestureEvent ma następujące właściwości:

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onZoom(evt:TransformGestureEvent):void {

    evt.target.scaleX++;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Powiązane elementy interfejsu API

To zdarzenie jest wywoływane w każdej aplikacji klienckiej, która obsługuje lokalne wprowadzanie znaków za pomocą edytora IME.

Wywoływane, gdy użytkownik naciśnie klawisz. Mapowanie pomiędzy klawiszami a określonymi znakami zmienia się w zależności od urządzenia i systemu operacyjnego. To zdarzenie jest generowane po mapowaniu tego typu, ale przed przetwarzaniem edytora metody wprowadzania (IME). Edytory IME są wykorzystywane w celu wprowadzania znaków, jak na przykład chińskich ideogramów, których wygenerowanie przy pomocy standardowej klawiatury QWERTY jest utrudnione. Zdarzenie to występuje przed zdarzeniem keyUp.

W środowisku AIR anulowanie tego zdarzenia uniemożliwia wprowadzenie znaku w polu tekstowym.

To zdarzenie ma następujące właściwości:

Wywoływane, gdy użytkownik próbuje uaktywnić inny element za pomocą klawiatury. Domyślnym zachowaniem tego zdarzenia jest zmiana aktywnego elementu i wywołanie odpowiednich zdarzeń focusIn i focusOut.

Zdarzenie jest wywoływane dla obiektu, który obecnie jest aktywny. Obiektem związanym z tym zdarzeniem jest instancja InteractiveObject, która staje się aktywna, jeżeli użytkownik nie zapobiegnie zachowaniu domyślnemu. Można zapobiec przenoszeniu aktywności poprzez wywołanie metody preventDefault() w detektorze zdarzeń, który jest poprawnie zarejestrowany dla obiektu docelowego. Stan aktywacji ulega zmianie i domyślnie wywoływane są zdarzenia focusIn i focusOut.

To zdarzenie ma następujące właściwości:

Wywoływane, gdy użytkownik zwolni klawisz. Mapowanie pomiędzy klawiszami a określonymi znakami zmienia się w zależności od urządzenia i systemu operacyjnego. To zdarzenie jest generowane po mapowaniu tego typu, ale przed przetwarzaniem edytora metody wprowadzania (IME). Edytory IME są wykorzystywane w celu wprowadzania znaków, jak na przykład chińskich ideogramów, których wygenerowanie przy pomocy standardowej klawiatury QWERTY jest utrudnione. Zdarzenie to występuje po zdarzeniu keyDown i posiada niżej wymienione cechy:

To zdarzenie ma następujące właściwości:

Wywoływane, gdy użytkownik naciśnie i zwolni środkowy przycisk urządzenia wskazującego nad tą samą instancją klasy InteractiveObject. Aby zaszło zdarzenie middleClick, wcześniej muszą wystąpić kolejno zdarzenia middleMouseDown i middleMouseUp. Obiekt docelowy musi być identyczny w dla obu tych zdarzeń. W innym przypadku zdarzenie middleClick nie występuje. Dowolna liczba innych zdarzeń myszy może wystąpić w dowolnym momencie pomiędzy zdarzeniami middleMouseDown i middleMouseUp; mimo tego zdarzenie middleClick wciąż występuje.

To zdarzenie ma następujące właściwości:

Wywoływane, gdy użytkownik naciśnie środkowy przycisk urządzenia wskazującego nad instancją klasy InteractiveObject.

To zdarzenie ma następujące właściwości:

Wywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject.

To zdarzenie ma następujące właściwości:

Wywoływane, gdy użytkownik naciśnie przycisk urządzenia wskazującego nad instancją klasy InteractiveObject. Jeżeli celem jest instancja SimpleButton, wówczas instancja ta wyświetla obiekt wyświetlany downState jako zachowanie domyślne. Jeżeli celem jest pole tekstowe możliwe do wybrania, wówczas pole tekstowe rozpoczyna wybór jako zachowanie domyślne.

To zdarzenie ma następujące właściwości:

Wywoływane, gdy użytkownik próbuje uaktywnić inny element za pomocą urządzenia wskazującego. Domyślnym zachowaniem tego zdarzenia jest zmiana aktywnego elementu i wywołanie odpowiednich zdarzeń focusIn i focusOut.

Zdarzenie jest wywoływane dla obiektu, który obecnie jest aktywny. Obiektem związanym z tym zdarzeniem jest instancja InteractiveObject, która staje się aktywna, jeżeli użytkownik nie zapobiegnie zachowaniu domyślnemu. Można zapobiec zmianie aktywności poprzez wywołanie metody preventDefault() w detektorze zdarzeń, który jest poprawnie zarejestrowany dla obiektu docelowego. Właściwość shiftKey nie jest stosowana. Stan aktywacji ulega zmianie i domyślnie wywoływane są zdarzenia focusIn i focusOut.

To zdarzenie ma następujące właściwości:

Wywoływane, gdy użytkownik ustawi kursor nad instancją obiektu InteractiveObject i poruszy urządzenie wskazujące. Jeżeli celem jest pole tekstowe wybierane przez użytkownika, wówczas wybór jest aktualizowany jako zachowanie domyślne.

To zdarzenie ma następujące właściwości:

Wywoływane, gdy użytkownik przesunie kursor poza instancję obiektu InteractiveObject (za pomocą urządzenia wskazującego). Celem zdarzenia jest obiekt znajdujący się uprzednio pod urządzeniem wskazującym lub obiekt macierzysty tego obiektu. Obiekt relatedObject jest obiektem, na który zostało przesunięte urządzenie wskazujące. Jeżeli celem jest instancja SimpleButton, wówczas przycisk wyświetla obiekt wyświetlany upState jako zachowanie domyślne.

Zdarzenie mouseOut jest wywoływane za każdym razem, gdy mysz opuszcza obszar dowolnego obiektu podrzędnego kontenera obiektów wyświetlanych, nawet gdy mysz pozostaje nad innym obiektem podrzędnym kontenera. Jest to zachowanie inne niż w przypadku zdarzenia rollOut, którego celem jest uproszczenie kodowania zachowań typu rollover dla kontenerów obiektów wyświetlanych z obiektami podrzędnymi. W momencie opuszczenia przez mysz obszaru obiektu wyświetlanego lub obszar któregoś z jego obiektów podrzędnych w celu przejścia do obiektu innego niż podrzędny, wówczas obiekt wyświetlany wywołuje zdarzenie rollOut. Zdarzenia rollOut są wywoływane kolejno w górę nadrzędnego łańcucha obiektu, zaczynając od wybranego obiektu, a kończąc na najwyższym obiektem nadrzędnym, który nie jest elementem głównym lub obiektem przodka obiektu relatedObject.

To zdarzenie ma następujące właściwości:

Dysponowana, gdy użytkownik przesunie kursor nad instancję obiektu InteractiveObject (za pomocą urządzenia wskazującego). Obiekt relatedObject jest obiektem, który poprzednio znajdował się pod urządzeniem wskazującym. Jeżeli celem jest instancja SimpleButton, obiekt wyświetla obiekt wyświetlany overState lub upState, w zależności od tego czy przycisk myszy jest naciśnięty, jako zachowanie domyślne.

Zdarzenie mouseOver jest wywoływane za każdym razem, gdy mysz znajduje się na obszarze dowolnego obiektu podrzędnego kontenera obiektów wyświetlanych, nawet gdy mysz znajdowała się już nad innym obiektem podrzędnym kontenera. Jest to zachowanie inne niż w przypadku zdarzenia rollOver, którego celem jest uproszczenie kodowania zachowań typu rollout dla kontenerów obiektów wyświetlanych z obiektami podrzędnymi. W chwili wprowadzenia myszy na obszar obiektu ekranowego lub obszar któregoś z jego obiektów potomnych z obiektu innego niż potomny obiekt ekranowy wywołuje zdarzenie rollOver. Zdarzenia rollover są wywoływane kolejno w dół łańcucha obiektów macierzystych, zaczynając od obiektu macierzystego najwyższego poziomu, który nie jest obiektem głównym ani przodkiem obiektu relatedObject, a na wybranym obiekcie kończąc.

To zdarzenie ma następujące właściwości:

Wywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad instancją klasy InteractiveObject. Jeżeli celem jest instancja SimpleButton, wówczas obiekt wyświetla obiekt wyświetlany upState. Jeżeli celem jest pole tekstowe możliwe do wybrania, wówczas pole tekstowe zakańcza wybór jako zachowanie domyślne.

To zdarzenie ma następujące właściwości:

Wywoływane, gdy kółko myszy zostanie obrócone nad instancją klasy InteractiveObject. Jeżeli celem jest pole tekstowe, wówczas tekst jest przewijany zgodnie z domyślnym zachowaniem. Dostępna tylko w systemach operacyjnych Microsoft Windows.

To zdarzenie ma następujące właściwości:

Wywoływane przez obiekt InteractiveObject inicjujący przeciąganie, gdy użytkownik zwolni przycisk podczas przeciągania.

Właściwość dropAction określa czynność zdefiniowaną przez obiekt docelowy przeciągania; wartość "none" (DragActions.NONE) oznacza, że upuszczenie zostało anulowane lub nie zostało zaakceptowane.

Moduł obsługi zdarzeń nativeDragComplete jest dogodnym miejscem do aktualizacji stanu inicjującego obiektu ekranowego, na przykład przez usunięcie pozycji z listy (w odpowiedzi na operację przeciągania „move”) lub zmianę właściwości wizualnych.

To zdarzenie ma następujące właściwości:

Wywoływane przez docelowy obiekt InteractiveObject, gdy przeciągany obiekt zostanie na niego upuszczony i upuszczenie zostanie zaakceptowane wywołaniem DragManager.acceptDragDrop().

Dostęp do upuszczonych danych jest możliwy za pośrednictwem właściwości clipboard obiektu zdarzenia.

Procedura obsługi tego zdarzenia powinna ustawiać właściwość DragManager.dropAction, aby poinformować obiekt inicjujący o rodzaju podjętej czynności przeciągania. Jeśli nie zostanie ustawiona żadna wartość, obiekt DragManager wybierze wartość domyślną z listy dozwolonych czynności.

To zdarzenie ma następujące właściwości: