IEditableText  - AS3 Flex

Bieżące opcje dostępności tego obiektu ekranowego. W przypadku modyfikacji właściwości accessibilityProperties lub jakichkolwiek pól wewnątrz właściwości accessibilityProperties konieczne jest wywołanie metody Accessibility.updateProperties() aby zmiany odniosły efekt.

Uwaga: Dla obiektu stworzonego w środowisku Flash wartość właściwości accessibilityProperties jest wstępnie zapełniana informacjami wprowadzonymi w panelu Dostępności dla tego obiektu.

Wskazuje, czy pole tekstowe jest polem hasła. Wartość true tej właściwości oznacza, że pole tekstowe jest traktowane jak pole hasła i ukrywa wpisywane znaki, wyświetlając w ich miejscu znaki gwiazdki. Wartość false oznacza, że pole tekstowe nie jest traktowane jak pole hasła. Włączony tryb hasła uniemożliwia korzystanie z poleceń Wytnij i Kopiuj, a odpowiadające im skróty klawiaturowe nie będą aktywne. Ten mechanizm zabezpieczający uniemożliwia nieuprawnionemu użytkownikowi korzystanie ze skrótów w celu odkrycia hasła do komputera pozostawionego bez nadzoru.

Flag that indicates whether the text is editable.

Wartością domyślną jest false.

Whether the component can accept user interaction. After setting the enabled property to false, some components still respond to mouse interactions such as mouseOver. As a result, to fully disable UIComponents, you should also set the value of the mouseEnabled property to false. If you set the enabled property to false for a container, Flex dims the color of the container and of all of its children, and blocks user input to the container and to all of its children.

Indicates whether the component can receive focus when tabbed to. You can set focusEnabled to false when a UIComponent is used as a subcomponent of another component so that the outer component becomes the focusable entity. If this property is false, focus is transferred to the first parent that has focusEnable set to true.

The default value is true, except for the spark.components.Scroller component. For that component, the default value is false.

The horizontal scroll position of the text.

Controls word wrapping within the text. This property corresponds to the lineBreak style.

Powiązane elementy interfejsu API

Maksymalna liczba znaków, które użytkownik może wprowadzić w polu tekstowym. Za pomocą skryptu można wstawić więcej tekstu niż pozwala właściwość maxChars; właściwość maxChars oznacza maksymalną ilości tekstu wpisanego przez użytkownika. Jeśli wartość tej właściwości wynosi 0, użytkownik może wpisać nieograniczoną ilość tekstu.

Określa, czy pole tekstowe jest polem wielowierszowym. Wartość true wskazuje, że pole tekstowe jest polem wielowierszowym; wartość false wskazuje, że pole tekstowe jest polem jednowierszowym. W przypadku pola typu TextFieldType.INPUT wartość multiline określa, czy naciśnięcie klawisza Enter powoduje utworzenie nowego wiersza (false powoduje, że naciśnięcie klawisza Enter jest ignorowane). Jeśli tekst zostanie wklejony do pola TextField z wartością multiline równą false, nowe wiersze znajdują się poza tekstem.

Oznacza zestaw znaków, które użytkownik może wprowadzać w polu tekstowym. Jeśli wartością właściwości restrict jest wartość null, użytkownik może wprowadzić dowolny znak. Jeśli wartością właściwości restrict jest pusty ciąg znaków, użytkownik nie może wprowadzić żadnego znaku. Jeśli wartością właściwości restrict jest ciąg znaków, użytkownik może wprowadzić do pola tekstowego tylko znaki z tego ciągu. Ciąg znaków jest przeszukiwany od lewej do prawej. Zakres można zdefiniować za pomocą znaku myślnika (-). Ograniczone są tylko interakcje użytkownika; skrypt może umieścić w polu tekstowym dowolny tekst. Tej właściwości nie można zsynchronizować z opcjami osadzania czcionki w inspektorze właściwości.

Jeśli ciąg znaków rozpoczyna się od znaku karetki (^), wszystkie znaki są początkowo akceptowane, a następujące po nich znaki w ciągu są wykluczane ze zbioru znaków akceptowanych. Jeśli ciąg znaków nie rozpoczyna się od znaku karetki (^), żadne znaki nie są początkowo akceptowane, a następujące po nich znaki w ciągu zostają zawarte w zbiorze znaków akceptowanych.

W poniższym przykładzie do pola tekstowego można wprowadzić tylko znaki dużej litery, spacje oraz liczby.

     my_txt.restrict = "A-Z 0-9";
     

Poniższy przykład ilustruje włączenie wszystkich znaków z wyjątkiem tych pisanych małą literą:

     my_txt.restrict = "^a-z";
     

Aby wprowadzić znaczenie znaku karetki (^) lub kreski (-) można użyć ukośnika odwrotnego. Akceptowalne sekwencje zawierające ukośnik odwrotny to: \-, \^ lub \\. Ukośnik odwrotny musi stanowić rzeczywisty znak w ciągu znaków, dlatego w języku ActionScript należy użyć podwójnego znaku ukośnika odwrotnego. Na przykład poniższy kod zawiera tylko znak kreski (-) i karetki z (^):

     my_txt.restrict = "\\-\\^";
     

Znaku ^ można użyć w dowolnym miejscu ciągu znaków — umożliwia włączanie i wykluczanie znaków. Poniższy kod włącza tylko znaki dużych liter, ale wyłącza literę Q:

     my_txt.restrict = "A-Z^Q";
     

Za pomocą sekwencji zmiany znaczenia \u można budować zastrzeżone ciągi znaków. Poniższy kod zawiera tylko znaki ASCII od numeru 32 (spacja) do 126 (tylda).

     my_txt.restrict = "\u0020-\u007E";
     

Wartość typu Boolean wskazująca, czy dane pole tekstowe można zaznaczać. Wartość true oznacza, że tekst można zaznaczać. Właściwość selectable udostępnia sterowanie możliwością zaznaczenia, a nie edycji pola tekstowego. Dynamiczne pole tekstowe można zaznaczać nawet, gdy nie można go wyedytować. Jeśli dynamiczne pole tekstowe nie ma możliwości zaznaczenia, użytkownik nie może zaznaczyć w nim tekstu.

Jeśli właściwość selectable jest ustawiona na wartość false, tekst w polu tekstowym nie będzie reagował na polecenia zaznaczenia lub ich skróty klawiszowe i nie będzie go można skopiować za pomocą polecenia Kopiuj. Jeśli właściwość selectable jest ustawiona na wartość true, tekst w polu tekstowym można zaznaczyć za pomocą myszy lub klawiszy klawiatury i skopiować za pomocą polecenia Kopiuj. W ten sposób można zaznaczyć tekst, nawet jeśli pole tekstowe to dynamiczne, a nie wejściowe pole tekstowe.

The active, or last clicked position, of the selection. If the implementation does not support selection anchor this is the last character of the selection.

The anchor, or first clicked position, of the selection. If the implementation does not support selection anchor this is the first character of the selection.

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;
	 

The vertical scroll position of the text.

Appends the specified text to the end of the text component, as if you had clicked at the end and typed.

An insertion point is then set after the new text. If necessary, the text will scroll to ensure that the insertion point is visible.

Parametry

Inserts the specified text into the text component as if you had typed it.

If a range was selected, the new text replaces the selected text. If there was an insertion point, the new text is inserted there.

An insertion point is then set after the new text. If necessary, the text will scroll to ensure that the insertion point is visible.

Parametry

Scroll so the specified range is in view.

Parametry

Selects all of the text.

Selects a specified range of characters.

If either position is negative, it will deselect the text range.

Parametry

Set focus to this text field.