Использование компонента TextArea

Компонент TextArea можно включить или выключить в приложении. В отключенном состоянии TextArea не реагирует на мышь или клавиатуру. Включенный компонент следует тем же правилам получения фокуса, выделения и навигации, что и объект TextField в ActionScript. Когда экземпляр TextArea получает фокус, им можно управлять с помощью следующих клавиш.

Дополнительные сведения об управлении фокусом см. в описании класса FocusManager в справочнике ActionScript® 3.0 для Adobe® Flash® Professional CS5 и разделе « Работа с FocusManager ».

В Инспекторе свойств или Инспекторе компонентов можно задать следующие параметры разработки для каждого экземпляра компонента TextArea: condenseWhite , editable , hortizontalScrollPolicy , maxChars , restrict , text , verticalScrollPolicy и wordwrap . Каждый из этих параметров имеет соответствующее свойство ActionScript с тем же именем. Сведения о возможных значениях этих параметров см. в описании класса TextArea в справочнике ActionScript® 3.0 для Adobe® Flash® Professional CS5 .

Интерактивный просмотр каждого элемента TextArea отражает изменения, которые были внесены в параметры в Инспекторе свойств или Инспекторе компонентов во время разработки. Если требуется полоса прокрутки, она отображается в интерактивном просмотре, но не работает. В интерактивном просмотре текст не выделяется. Кроме того, нельзя вводить текст в экземпляре компонента в рабочей области.

Можно создать код ActionScript для управления этими и дополнительными параметрами компонента TextArea с помощью его свойств, методов и событий. Дополнительные сведения см. в описании класса TextArea в справочнике ActionScript® 3.0 для Adobe® Flash® Professional CS5 .

Ниже описывается процедура добавления компонента TextArea в приложение в ходе разработки. В примере создается обработчик события focusOut для экземпляра TextArea, который проверяет, сделал ли пользователь ввод в текстовую область, прежде чем перевести фокус на другой компонент интерфейса.

1. Создайте новый документ Flash (ActionScript 3.0).

2. Перетащите компонент TextArea с панели «Компоненты» в рабочую область и присвойте ему имя экземпляра aTa . Оставьте значения параметров, используемые по умолчанию.

3. Перетащите второй компонент TextArea с панели «Компоненты» в рабочую область, поместите его под первым и присвойте ему имя экземпляра bTa . Оставьте значения параметров, используемые по умолчанию.

4. Откройте панель «Действия», выберите «Кадр 1» на главной временной шкале и введите следующий код ActionScript.

   import flash.events.FocusEvent; 
    
   aTa.restrict = "a-z,'\" \""; 
   aTa.addEventListener(Event.CHANGE,changeHandler); 
   aTa.addEventListener(FocusEvent.KEY_FOCUS_CHANGE, k_m_fHandler); 
   aTa.addEventListener(FocusEvent.MOUSE_FOCUS_CHANGE, k_m_fHandler); 
    
   function changeHandler(ch_evt:Event):void { 
       bTa.text = aTa.text; 
   } 
   function k_m_fHandler(kmf_event:FocusEvent):void { 
       kmf_event.preventDefault(); 
   }

   В этом примере ограничиваются символы, которые можно ввести в текстовую область aTa : разрешается использовать только символы нижнего регистра, запятую, апостроф и пробелы. Также создаются обработчики для событий change , KEY_FOCUS_CHANGE и MOUSE_FOCUS_CHANGE для текстовой области aTa . Функция changeHandler() автоматически отображает текст, введенный в текстовой области aTa , в области bTa , присваивая свойство aTa.text в качестве значения для bTa.text при получении каждого события change . Функция k_m_fHandler() для событий KEY_FOCUS_CHANGE и MOUSE_FOCUS_CHANGE запрещает перевод фокуса в следующее поле при нажатии клавиши Tab, если не введен текст в текущее поле. Это достигается путем предотвращения поведения по умолчанию.

5. Выберите «Управление» > «Тестировать ролик».

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