IEditableText  - AS3 Flex

Текущие параметры специальных возможностей для данного экранного объекта. Если модифицируется свойство accessibilityProperties или любые поля в accessibilityProperties, необходимо вызвать метод Accessibility.updateProperties(), чтобы изменения вступили в силу.

Примечание. Для объектов, созданных в среде разработки Flash, значение accessibilityProperties предварительно заполняется информацией, введенной на панели «Специальные возможности» данного объекта.

Показывает, является ли текстовое поле полем пароля. Если это свойство имеет значение true, текстовое поле обрабатывается как поле ввода пароля и скрывает вводимые символы, показывая звездочки вместо действительных символов. При значении false текстовое поле не обрабатывается как поле пароля. В режиме пароля команды «Вырезать» и «Копировать», а также соответствующие им комбинации клавиш не работают. Этот механизм защиты не позволяет недобросовестным пользователям использовать комбинации клавиш с целью получения пароля на компьютере, оставленном без присмотра.

Флаг, обозначающий возможность редактирования текста.

Значением по умолчанию является false.

Возможность использования компонента пользователем. После установки свойства enabled на false некоторые компоненты по-прежнему отвечают на использование мыши, например на событие mouseOver. В результате для полного отключения UIComponents требуется установить значение свойства mouseEnabled на false. При установке свойства enabled на false для контейнера Flex затемняет цвет контейнера и всех его нижестоящих элементов, а также блокирует ввод данных пользователем в контейнер и во все нижестоящие элементы.

Указывает, может ли компонент получить фокус при выборе вкладки с ним. Можно установить focusEnabled на false, если UIComponent используется в качестве подчиненного компонента для другого компонента так, чтобы внешний компонент стал сущностью, которая может получить фокус. Если это свойство имеет значение false, фокус будет передан в первый вышестоящий элемент, в котором focusEnable установлено на true.

Значением по умолчанию является true, за исключением компонента spark.components.Scroller. Для этого компонента используется значение по умолчанию false.

Позиция горизонтальной прокрутки текста.

Управляет переносом слов в тексте. Это свойство соответствует стилю lineBreak.

Связанные элементы API

Введенное пользователем максимальное число символов, которое может содержать текстовое поле. Сценарий может вставить больше текста, чем допускает maxChars. Свойство maxChars указывает только количество символов, которые может ввести пользователь. Если это свойство имеет значение 0, пользователь может ввести любое количество символов.

Показывает, является ли текстовое поле многострочным. Если значение — true, текстовое поле многострочное, а если значение — false, то однострочное. В поле типа TextFieldType.INPUT значение multiline определяет, создает ли клавиша Enter новую строку (при значении false нажатие клавиши Enter игнорируется). Если вставить текст в поле TextField со свойством multiline в значении false, новые строки опускаются.

Определяет набор символов, которые могут быть введены пользователем в текстовом поле. Если свойству restrict присвоено значение null, можно ввести любой символ. Если в качестве значения свойства restrict установлена пустая строка, ввод символов невозможен. Если значение restrict — это строка, состоящая из символов, в текстовое поле можно вводить только символы из этой строки. Строка сканируется слева направо. Диапазон определяется с помощью символа (-). Ограничивается только взаимодействие пользователей; с помощью сценариев в текстовом поле можно ввести любой текст. Это свойство не синхронизируется с параметрами встраивания шрифтов в инспекторе свойств.

Если строка начинается с символа вставки (^), все символы изначально поддерживаются, а последующие символы в строке исключаются из набора поддерживаемых символов. Если строка не начинается с символа вставки (^), символы изначально не поддерживаются, а последующие символы в строке включаются в набор поддерживаемых символов.

В следующем примере в текстовое поле можно вводить только заглавные буквы, пробелы и цифры.

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

В следующем примере включены все символы, но исключены строчные буквы.

     my_txt.restrict = "^a-z";
     

Можно использовать обратную косую черту для ввода символа ^ или -. Допускаются следующие последовательности с обратной косой чертой: \-, \^ или \\. Обратная косая черта должна быть фактическим символом в строке, потому, когда она задана в коде ActionScript, необходимо использовать двойную обратную косую черту. Например, следующий код включает только дефис (-) и символ вставки (^).

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

Символ ^ может использоваться в любом месте строки для переключения между включенными и исключенными символами. Следующий код включает только заглавные буквы, но исключает заглавную букву Q.

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

Для создания строк restrict можно использовать управляющую последовательность \u. Следующий код включает только символы с ASCII 32 (пробел) до ASCII 126 (тильда).

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

Логическое значение, определяющее, можно ли выбрать текстовое поле. Значение true указывает на то, что текст можно выделить. Свойство selectable управляет возможностью выделения содержимого текстового поля, а не возможностью его редактирования. Динамическое текстовое поле может поддерживать выделение даже при отсутствии возможности редактирования. Если динамическое текстовое поле не поддерживает выделения, пользователь не может выделять его содержимое.

Если свойство selectable имеет значение false, содержимое текстового поля не реагирует на команды выделения мыши и клавиатуры, и его нельзя копировать с использованием команды «Копировать». Если свойство selectable имеет значение true, содержимое текстового поля можно выделить с помощью мыши и клавиатуры, и его можно копировать с использованием команды «Копировать». Таким образом можно выделить текст, даже если текстовое поле является динамическим, а не полем ввода.

Активная позиция или позиция последнего нажатия выбранного фрагмента. Если реализация не поддерживает привязку выбора, используется последний символ в выделенном фрагменте.

Привязка или позиция первого нажатия выбранного фрагмента. Если реализация не поддерживает привязку выбора, используется первый символ в выделенном фрагменте.

Задает последовательность перехода между объектами в SWF-файле. Свойство tabIndex по умолчанию имеет значение -1, то есть для объекта не задан индекс при переходе с помощью клавиши Tab.

Если какой-либо отображаемый в данный момент объект в SWF-файле имеет свойство tabIndex, автоматическая последовательность перехода с помощью клавиши Tab отключается, и последовательность перехода вычисляется по свойствам tabIndex объектов SWF-файла. Пользовательская последовательность перехода с помощью клавиши Tab включает только объекты, имеющие свойство tabIndex.

Свойство tabIndex может быть выражено неотрицательным числом. Последовательность перехода определяется в соответствии со свойствами tabIndex объектов в восходящем порядке. Объект со значением 1 свойства tabIndex предшествует объекту со значением 2 свойства tabIndex. Нельзя использовать одинаковое значение tabIndex для нескольких объектов.

Пользовательская последовательность перехода с помощью клавиши Tab, определяемая свойством tabIndex, является линейной. Это значит, что иерархические отношения объектов в SWF-файле не учитываются. Все объекты в SWF-файле со свойствами tabIndex помещаются в последовательность перехода с помощью клавиши Tab, которая определяется последовательностью значений tabIndex.

Примечание. Чтобы установить порядок табуляции для экземпляров TLFTextField, передайте дочерний объект экранного объекта TLFTextField как InteractiveObject, затем задайте свойство tabIndex. Например:

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

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

Позиция вертикальной прокрутки текста.

Присоединяет указанный текст к концу текстового компонента, как если бы пользователь щелкнул конечный фрагмент и ввел текст.

После нового текста устанавливается точка вставки. В случае необходимости текст будет прокручен для обеспечения видимости точки вставки.

Параметры

Присоединяет указанный текст к текстовому компоненту, как если бы пользователь ввел текст.

При выборе диапазона новый текст заменяет выбранный текст. При наличии точки вставки новый текст вставляется в этом месте.

После нового текста устанавливается точка вставки. В случае необходимости текст будет прокручен для обеспечения видимости точки вставки.

Параметры

Прокрутка до отображения указанного диапазона.

Параметры

Выделяет весь текст.

Выбирает указанный диапазон символов.

Если любая из позиций является отрицательной, выбор текстового диапазона отменяется.

Параметры

Установка фокуса в текстовом поле.