パッケージfl.controls
クラスpublic class TextArea
継承TextArea Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
実装 IFocusManagerComponent

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

TextArea コンポーネントは複数行のテキストフィールドで、境界線とオプションのスクロールバーが含まれます。TextArea コンポーネントは、Adobe Flash Player の HTML レンダリング機能をサポートします。

例を表示

関連項目

TextInput


パブリック プロパティ
 プロパティ定義元
 InheritedaccessibilityProperties : AccessibilityProperties
この表示オブジェクトの現在のアクセシビリティオプションです。
DisplayObject
 Inheritedalpha : Number
指定されたオブジェクトのアルファ透明度値を示します。
DisplayObject
  alwaysShowSelection : Boolean
テキストフィールドにフォーカスがないときにテキストフィールドの選択範囲を強調表示するかどうかを示すブール値を取得または設定します。
TextArea
 InheritedblendMode : String
使用するブレンドモードを指定する BlendMode クラスの値です。
DisplayObject
 InheritedbuttonMode : Boolean
このスプライトのボタンモードを指定します。
Sprite
 InheritedcacheAsBitmap : Boolean
true に設定されている場合、表示オブジェクトの内部ビットマップ表現が Flash Player にキャッシュされます。
DisplayObject
  condenseWhite : Boolean
HTML テキストを含む TextArea コンポーネントから余分な空白を削除するかどうかを示すブール値を取得または設定します。
TextArea
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 InheritedcontextMenu : ContextMenu
このオブジェクトに関連付けられたコンテキストメニューを指定します。
InteractiveObject
  displayAsPassword : Boolean
TextArea コンポーネントインスタンスがパスワードテキストフィールドであるかどうかを示すブール値を取得または設定します。
TextArea
 InheriteddoubleClickEnabled : Boolean
オブジェクトが doubleClick イベントを受け取るかどうかを指定します。
InteractiveObject
 InheriteddropTarget : DisplayObject
[read-only] スプライトのドラッグ先またはスプライトがドロップされた先の表示オブジェクトを指定します。
Sprite
  editable : Boolean
コンポーネントのテキストをユーザーが編集できるかどうかを示すブール値を取得または設定します。
TextArea
  enabled : Boolean
コンポーネントがユーザーの操作を受け付けるかどうかを示す値を取得または設定します。
TextArea
 Inheritedfilters : Array
表示オブジェクトに現在関連付けられている各フィルタオブジェクトが格納されているインデックス付きの配列です。
DisplayObject
 InheritedfocusEnabled : Boolean
ユーザーがコンポーネントをクリックしたときに、コンポーネントがフォーカスを受け取ることが可能かどうかを示すブール値を取得または設定します。
UIComponent
 InheritedfocusManager : IFocusManager
このコンポーネントとそのピアーに対するフォーカスを制御する FocusManager を取得または設定します。
UIComponent
 InheritedfocusRect : Object
このオブジェクトがフォーカス矩形を表示するかどうかを指定します。
InteractiveObject
 Inheritedgraphics : Graphics
[read-only] ベクターの描画コマンドが発生する、このスプライトに属する Graphics オブジェクトを指定します。
Sprite
 Inheritedheight : Number
コンポーネントの高さを取得または設定します (ピクセル単位)。
UIComponent
 InheritedhitArea : Sprite
スプライトのヒット領域となる別のスプライトを指定します。
Sprite
  horizontalScrollBar : UIScrollBar
[read-only] 水平スクロールバーへの参照を取得します。
TextArea
  horizontalScrollPolicy : String
水平スクロールバーのスクロールポリシーを取得または設定します。
TextArea
  horizontalScrollPosition : Number
ユーザーがテキストフィールドを水平方向にスクロールした後のスクロールバーサムの位置の変更 (ピクセル単位) を取得または設定します。
TextArea
  htmlText : String
テキストフィールドが含むストリングの HTML 表現を取得または設定します。
TextArea
  imeMode : String
入力メソッドエディタ (IME) のモードを取得または設定します。
TextArea
  length : Number
[read-only] TextArea コンポーネントに含まれる文字の数を取得します。
TextArea
 InheritedloaderInfo : LoaderInfo
[read-only] この表示オブジェクトが属するファイルのロード情報を含む LoaderInfo オブジェクトを返します。
DisplayObject
 Inheritedmask : DisplayObject
呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。
DisplayObject
  maxChars : int
テキストフィールドにユーザーが入力できる最大の文字数を取得または設定します。
TextArea
  maxHorizontalScrollPosition : int
[read-only] horizontalScrollPosition プロパティの最大値を取得します。
TextArea
  maxVerticalScrollPosition : int
[read-only] verticalScrollPosition プロパティの最大値を取得します。
TextArea
 InheritedmouseChildren : Boolean
オブジェクトの子に対してマウスが有効かどうかを調べます。
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
このオブジェクトがマウスメッセージを受け取るかどうかを指定します。
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
ユーザーがコンポーネントをクリックしたときに、コンポーネントがフォーカスを受け取ることが可能かどうかを示す値を取得または設定します。
UIComponent
 InheritedmouseX : Number
[read-only] マウス位置の x 座標を示します (ピクセル単位)。
DisplayObject
 InheritedmouseY : Number
[read-only] マウス位置の y 座標を示します (ピクセル単位)。
DisplayObject
 Inheritedname : String
DisplayObject のインスタンス名を示します。
DisplayObject
 InheritednumChildren : int
[read-only] このオブジェクトの子の数を返します。
DisplayObjectContainer
 InheritedopaqueBackground : Object
表示オブジェクトが特定の背景色で不透明であるかどうかを指定します。
DisplayObject
 Inheritedparent : DisplayObjectContainer
[read-only] この表示オブジェクトを含む DisplayObjectContainer オブジェクトを示します。
DisplayObject
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  restrict : String
テキストフィールドがユーザーから受け取る文字のストリングを取得または設定します。
TextArea
 Inheritedroot : DisplayObject
[read-only] ロードされた SWF ファイル内の表示オブジェクトの場合、root プロパティはその SWF ファイルが表す表示リストのツリー構造部分の一番上にある表示オブジェクトとなります。
DisplayObject
 Inheritedrotation : Number
DisplayObject インスタンスの元の位置からの回転角を度単位で示します。
DisplayObject
 Inheritedscale9Grid : Rectangle
現在有効な拡大 / 縮小グリッドです。
DisplayObject
 InheritedscaleX : Number
コンポーネントの現在の幅に縮尺率を乗算します。
UIComponent
 InheritedscaleY : Number
コンポーネントの現在の高さに縮尺率を乗算します。
UIComponent
 InheritedscrollRect : Rectangle
表示オブジェクトのスクロール矩形の境界です。
DisplayObject
  selectionBeginIndex : int
[read-only] 1 つまたは複数の文字の選択範囲から最初に選択される文字のインデックス位置を取得します。
TextArea
  selectionEndIndex : int
[read-only] 1 つまたは複数の文字の選択範囲から最後に選択される文字のインデックス位置を取得します。
TextArea
 InheritedsoundTransform : SoundTransform
このスプライト内のサウンドを制御します。
Sprite
 Inheritedstage : Stage
[read-only] 表示オブジェクトのステージです。
DisplayObject
 InheritedtabChildren : Boolean
オブジェクトの子に対してタブが有効かどうかを調べます。
DisplayObjectContainer
 InheritedtabEnabled : Boolean
このオブジェクトがタブ順序に含まれるかどうかを指定します。
InteractiveObject
 InheritedtabIndex : int
SWF ファイル内のオブジェクトのタブ順序を指定します。
InteractiveObject
  text : String
現在 TextInput コンポーネントにあるテキストを含むストリングを取得または設定します。
TextArea
  textField : TextField
TextArea コンポーネントの内部テキストフィールドへの参照です。
TextArea
  textHeight : Number
[read-only] テキストの高さ (ピクセル単位) を取得します。
TextArea
 InheritedtextSnapshot : TextSnapshot
[read-only] この DisplayObjectContainer インスタンスの TextSnapshot オブジェクトを返します。
DisplayObjectContainer
  textWidth : Number
[read-only] テキストの幅 (ピクセル単位) を取得します。
TextArea
 Inheritedtransform : Transform
表示オブジェクトのマトリックス、カラー変換、ピクセル境界に関係するプロパティを持つオブジェクトです。
DisplayObject
 InheriteduseHandCursor : Boolean
buttonMode プロパティが true に設定されたスプライト上にマウスが移動したときに、指差しハンドポインタ (ハンドカーソル) を表示するかどうかを示すブール値です。
Sprite
 Inheritedversion : String = "3.0.0.15"
コンポーネントのバージョン番号。
UIComponent
  verticalScrollBar : UIScrollBar
[read-only] 垂直スクロールバーへの参照を取得します。
TextArea
  verticalScrollPolicy : String
垂直スクロールバーのスクロールポリシーを取得または設定します。
TextArea
  verticalScrollPosition : Number
ユーザーがテキストフィールドを垂直方向にスクロールした後のスクロールバーサムの位置の変更 (ピクセル単位) を取得または設定します。
TextArea
 Inheritedvisible : Boolean
現在のコンポーネントのインスタンスが可視かどうかを示す値を取得または設定します。
UIComponent
 Inheritedwidth : Number
コンポーネントの幅を取得または設定します (ピクセル単位)。
UIComponent
  wordWrap : Boolean
テキストが行の最後で折り返すかどうかを示すブール値を取得または設定します。
TextArea
 Inheritedx : Number
親コンテナ内での x 軸に沿ったコンポーネントの位置を表す x 座標を取得または設定します。
UIComponent
 Inheritedy : Number
親コンテナ内での y 軸に沿ったコンポーネントの位置を表す y 座標を取得または設定します。
UIComponent
パブリック メソッド
 メソッド定義元
  
TextArea コンポーネントの新しいインスタンスを作成します。
TextArea
 Inherited
この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。
DisplayObjectContainer
 Inherited
この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
  
TextArea コンポーネントに含まれる最後の文字の後に指定されたストリングを追加します。
TextArea
 Inherited
特定の point ポイントを指定して呼び出した DisplayObjectContainer.getObjectsUnderPoint() メソッドから返されたリストに、セキュリティ上の制約のために省略される表示オブジェクトがあるかどうかを示します。
DisplayObjectContainer
 Inherited
このコンポーネントインスタンスからスタイルプロパティを削除します。
UIComponent
 Inherited
指定された表示オブジェクトが、DisplayObjectContainer インスタンスの子であるか、インスタンス自体であるかを指定します。
DisplayObjectContainer
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
  
このコンポーネントのフォーカスインジケータを表示または非表示にします。
TextArea
 Inherited
invalidateNow とは異なり、すべてを無効化せずに直ちに描画を開始します。
UIComponent
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
targetCoordinateSpace オブジェクトの座標系を基準にして、表示オブジェクトの領域を定義する矩形を返します。
DisplayObject
 Inherited
指定のインデックス位置にある子表示オブジェクトインスタンスを返します。
DisplayObjectContainer
 Inherited
指定された名前に一致する子表示オブジェクトを返します。
DisplayObjectContainer
 Inherited
子 DisplayObject インスタンスのインデックス位置を返します。
DisplayObjectContainer
 Inherited
現在フォーカスを持っているオブジェクトを取得します。
UIComponent
  
指定されたテキストの行に関する情報を取得します。
TextArea
 Inherited
指定されたポイントの下にあり、この DisplayObjectContainer インスタンスの子または孫などであるオブジェクトの配列を返します。
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
シェイプ上の線を除き、targetCoordinateSpace パラメータによって定義された座標系に基づいて、表示オブジェクトの境界を定義する矩形を返します。
DisplayObject
 Inherited
コンポーネントのスタイル参照チェーンに設定されているスタイルプロパティを取得します。
UIComponent
  
[static] 現在のコンポーネントのデフォルトスタイルマップを取得します。
TextArea
 Inherited
point オブジェクトをステージ (グローバル) 座標から表示オブジェクトの (ローカル) 座標に変換します。
DisplayObject
 Inherited
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
表示オブジェクトを評価して、obj 表示オブジェクトと重複または交差するかどうかを調べます。
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
表示オブジェクトを評価して、x および y パラメータで指定されたポイントと重複または交差するかどうかを調べます。
DisplayObject
 Inherited
invalidate(property:String, callLater:Boolean = true):void
プロパティが無効であることを示し、指定がない限り、コンポーネントを次のフレームに再描画します。
UIComponent
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
point オブジェクトを表示オブジェクトの (ローカル) 座標からステージ (グローバル) 座標に変換します。
DisplayObject
 Inherited
[static] 複数のクラスのスタイルを 1 つのオブジェクトに結合します。
UIComponent
 Inherited
親の内部の指定された位置にコンポーネントを移動します。
UIComponent
 Inherited
指定されたプロパティが存在し列挙できるかどうかを示します。
Object
 Inherited
DisplayObjectContainer インスタンスの子リストから指定の child DisplayObject インスタンスを削除します。
DisplayObjectContainer
 Inherited
DisplayObjectContainer の子リストの指定されたインデックス位置から子 DisplayObject を削除します。
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
表示オブジェクトコンテナの既存の子の位置を変更します。
DisplayObjectContainer
 Inherited
現在扱っているコンポーネントにフォーカスを設定します。
UIComponent
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  
setSelection(setSelection:int, endIndex:int):void
フォーカスを持つテキスト領域で行われた選択の範囲を設定します。
TextArea
 Inherited
setSize(width:Number, height:Number):void
コンポーネントのサイズを、指定した幅と高さに設定します。
UIComponent
 Inherited
setStyle(style:String, value:Object):void
このコンポーネントインスタンスのスタイルプロパティを設定します。
UIComponent
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
指定されたスプライトをユーザーがドラッグできるようにします。
Sprite
 Inherited
startDrag() メソッドを終了します。
Sprite
 Inherited
指定された 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
子リスト内の指定されたインデックス位置に該当する 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。
DisplayObjectContainer
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
必要に応じて、このオブジェクトのプロパティとレイアウトを検証および更新し、それを再描画します。
UIComponent
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント 概要 定義元
 Inherited Flash Player がオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited 表示オブジェクトが表示リストに追加されたときに送出されます。DisplayObject
 Inherited 表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの追加により、ステージ上の表示リストに追加されたときに送出されます。DisplayObject
   TextArea コンポーネント内のテキストが変更されたときに送出されます。TextArea
 Inherited ユーザーが InteractiveObject をポインティングデバイスのメインボタンでクリックしたときに送出されます。InteractiveObject
 Inherited Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
 Inherited オブジェクトの doubleClickEnabled フラグが true に設定されている場合にユーザーが InteractiveObject をポインティングデバイスのメインボタンで 2 回続けてすばやくクリックすると送出されます。InteractiveObject
   ユーザーがコンポーネントで Enter キーを押したときに送出されます。TextArea
 Inherited 再生ヘッドが新しいフレームに入るときに送出されます。DisplayObject
 Inherited 表示オブジェクトがフォーカスを取得したときに送出されます。InteractiveObject
 Inherited 表示オブジェクトがフォーカスを失ったときに送出されます。InteractiveObject
 Inherited コンポーネントの可視性が可視から不可視に変化した後に送出されます。UIComponent
 Inherited ユーザーがキーを押したときに送出されます。InteractiveObject
 Inherited ユーザーがキーボード操作によってフォーカスを変更しようとすると送出されます。InteractiveObject
 Inherited ユーザーがキーを離したときに送出されます。InteractiveObject
 Inherited Flash Player ウィンドウの InteractiveObject インスタンスの上でユーザーがポインティングデバイスのボタンを押すと送出されます。InteractiveObject
 Inherited ユーザーがポインティングデバイスでフォーカスを変更しようとすると送出されます。InteractiveObject
 Inherited ユーザーが InteractiveObject の上でポインティングデバイスを移動させたときに送出されます。InteractiveObject
 Inherited ユーザーが InteractiveObject インスタンスからポインティングデバイスを離したときに送出されます。InteractiveObject
 Inherited ユーザーが Flash Player ウィンドウの InteractiveObject インスタンスにポインティングデバイスを合わせたときに送出されます。InteractiveObject
 Inherited ユーザーが Flash Player ウィンドウの InteractiveObject インスタンスの上でポインティングデバイスのボタンを解放したときに送出されます。InteractiveObject
 Inherited Flash Player ウィンドウの InteractiveObject インスタンスの上でマウスホイールを回転させたときに送出されます。InteractiveObject
 Inherited コンポーネントが移動された後に送出されます。UIComponent
 Inherited 表示オブジェクトが表示リストから削除されようとしているときに送出されます。DisplayObject
 Inherited 表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの削除により、表示リストから削除されようとしているときに送出されます。DisplayObject
 Inherited 表示リストが更新およびレンダリングされようとしているときに送出されます。DisplayObject
 Inherited コンポーネントのサイズが変更された後に送出されます。UIComponent
 Inherited ユーザーが InteractiveObject インスタンスからポインティングデバイスを離したときに送出されます。InteractiveObject
 Inherited ユーザーが InteractiveObject インスタンスにポインティングデバイスを合わせたときに送出されます。InteractiveObject
   コンテンツがスクロールされたときに送出されます。TextArea
 Inherited コンポーネントの可視性が不可視から可視に変化した後に送出されます。UIComponent
 Inherited オブジェクトの tabChildren フラグの値が変更されたときに送出されます。InteractiveObject
 Inherited オブジェクトの tabEnabled フラグが変更されたときに送出されます。InteractiveObject
 Inherited オブジェクトの tabIndex プロパティの値が変更されたときに送出されます。InteractiveObject
   ユーザーがコンポーネントに対してテキストの入力、削除、またはペーストを実行したときに送出されます。TextArea
スタイル
 スタイル 説明 定義元
  
disabledSkin
データ型: Class
コンポーネントの enabled プロパティが false に設定されている場合に、TextArea コンポーネントの背景を指定するクラスです。 デフォルト値 : TextArea_disabledSkin.
TextArea
 Inherited データ型: flash.text.TextFormat
ボタンが無効な場合に、コンポーネントラベルのレンダリングに使用される TextFormat オブジェクトです。
UIComponent
  
embedFonts
データ型: Boolean
埋め込みフォントのアウトラインが、テキストフィールドのレンダリングに使用されるかどうかを示します。 値が true の場合、Flash Player は埋め込みフォントアウトラインを使用してテキストフィールドをレンダリングします。 値が false である場合は、デバイスフォントを使用してテキストフィールドをレンダリングします。

テキストフィールドの embedFonts プロパティを true に設定する場合、テキストフィールドに適用される TextFormat オブジェクトの font プロパティを使用して、そのテキストのフォントを指定する必要があります。 指定したフォントが SWF ファイルに埋め込まれていない場合、テキストは表示されません。

デフォルト値 : false.
TextArea
 Inherited データ型: Number   形式: Length
コンポーネント領域の外側とフォーカスインジケータ領域のエッジを区切るパディングです (ピクセル単位)。
UIComponent
 Inherited データ型: Class
フォーカスインジケータの表示に使用されるスキンです。
UIComponent
 Inherited データ型: flash.text.TextFormat
コンポーネントラベルのレンダリングに使用される TextFormat オブジェクトです。
UIComponent
  
textPadding
データ型: Number   形式: Length
コンポーネントの境界とテキストを区切るパディングです (ピクセル単位)。 デフォルト値 : 3.
TextArea
  
upSkin
データ型: Class
TextArea コンポーネントの背景を指定するクラスです。 デフォルト値 : TextArea_upSkin.
TextArea
プロパティの詳細
alwaysShowSelectionプロパティ
alwaysShowSelection:Boolean  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

テキストフィールドにフォーカスがないときにテキストフィールドの選択範囲を強調表示するかどうかを示すブール値を取得または設定します。この値が true に設定され、テキストフィールドにフォーカスがない場合、選択範囲は灰色で強調表示されます。この値が false に設定され、テキストフィールドにフォーカスがない場合、選択範囲は強調表示されません。

デフォルト値 : false.


実装
    public function get alwaysShowSelection():Boolean
    public function set alwaysShowSelection(value:Boolean):void

関連項目

condenseWhiteプロパティ 
condenseWhite:Boolean  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

HTML テキストを含む TextArea コンポーネントから余分な空白を削除するかどうかを示すブール値を取得または設定します。コンポーネント内の余分な空白の例として、スペースと改行があります。true の値は、余分な空白を削除することを示します。false の値は、余分な空白を削除しないことを示します。

このプロパティは、htmlText プロパティを使用して設定されるテキストだけに影響します。text プロパティを使用して設定されるテキストには影響しません。text プロパティを使用してテキストを設定する場合は、condenseWhite プロパティが無視されます。

condenseWhite プロパティを true に設定した場合は、テキストフィールド内で改行を指定するときに <br> や <p> などの標準の HTML コマンドを使用する必要があります。

デフォルト値 : false.


実装
    public function get condenseWhite():Boolean
    public function set condenseWhite(value:Boolean):void

関連項目




次の例では、CheckBox コンポーネントを使用して、TextArea コンポーネントの condenseWhite プロパティを切り替えます。

import fl.controls.CheckBox;
import fl.controls.ScrollPolicy;
import fl.controls.TextArea;

var str:String;

var plainTextArea:TextArea = new TextArea();
plainTextArea.verticalScrollPolicy = ScrollPolicy.ON;
plainTextArea.setSize(260, 360);
plainTextArea.move(10, 10);
addChild(plainTextArea);

var htmlTextArea:TextArea = new TextArea();
htmlTextArea.verticalScrollPolicy = ScrollPolicy.ON;
htmlTextArea.condenseWhite = true;
htmlTextArea.setSize(260, 360);
htmlTextArea.move(280, 10);
addChild(htmlTextArea);

var condenseCheckBox:CheckBox = new CheckBox();
condenseCheckBox.textField.autoSize = TextFieldAutoSize.LEFT;
condenseCheckBox.label = "condenseWhite:";
condenseCheckBox.selected = htmlTextArea.condenseWhite;
condenseCheckBox.move(htmlTextArea.x, htmlTextArea.y + htmlTextArea.height);
condenseCheckBox.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(condenseCheckBox);

var urlLdr:URLLoader = new URLLoader();
urlLdr.addEventListener(Event.COMPLETE, completeHandler);
urlLdr.dataFormat = URLLoaderDataFormat.TEXT;
urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/lorem.html"));

function completeHandler(event:Event):void {
    str = event.target.data as String;
    plainTextArea.text = str;
    htmlTextArea.htmlText = str;
}

function clickHandler(event:MouseEvent):void {
    var sel:Boolean = event.currentTarget.selected;
    htmlTextArea.condenseWhite = sel;
    htmlTextArea.htmlText = str;
}
displayAsPasswordプロパティ 
displayAsPassword:Boolean  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

TextArea コンポーネントインスタンスがパスワードテキストフィールドであるかどうかを示すブール値を取得または設定します。true の値は、現在のインスタンスがパスワードを含むために作成されたことを示します。false の値は、現在のインスタンスがパスワードのテキストフィールドでないことを示します。

このプロパティの値が true の場合、ユーザーがテキスト領域に入力する文字は参照できません。ユーザーが入力する各文字の代わりにアスタリスクが表示されます。また、ユーザーの不在時にパスワードが復元されるのを防止するために、[カット] コマンドと [コピー] コマンド、およびそれに対応するキーボードのショートカットが無効になります。

デフォルト値 : false.


実装
    public function get displayAsPassword():Boolean
    public function set displayAsPassword(value:Boolean):void
editableプロパティ 
editable:Boolean  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

コンポーネントのテキストをユーザーが編集できるかどうかを示すブール値を取得または設定します。true の値は、コンポーネントが含むテキストをユーザーが編集できることを示します。false の値は、ユーザーが編集できないことを示します。

デフォルト値 : true.


実装
    public function get editable():Boolean
    public function set editable(value:Boolean):void
enabledプロパティ 
enabled:Boolean  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

コンポーネントがユーザーの操作を受け付けるかどうかを示す値を取得または設定します。true の値は、コンポーネントがユーザーの操作を受け付けるかどうかを示します。この値が false の場合、コンポーネントはユーザーの操作を受け付けません。

enabled プロパティを false に設定した場合、コンテナの色はグレー表示になり、ユーザー入力がブロックされます (ただし、Label および ProgressBar コンポーネントは例外です)。


実装
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
horizontalScrollBarプロパティ 
horizontalScrollBar:UIScrollBar  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

水平スクロールバーへの参照を取得します。


実装
    public function get horizontalScrollBar():UIScrollBar

関連項目

horizontalScrollPolicyプロパティ 
horizontalScrollPolicy:String  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

水平スクロールバーのスクロールポリシーを取得または設定します。次の値が含まれます。

デフォルト値 : ScrollPolicy.AUTO.


実装
    public function get horizontalScrollPolicy():String
    public function set horizontalScrollPolicy(value:String):void

関連項目




次の例では、TextArea コンポーネントインスタンスを作成し、horizontalScrollPolicy プロパティを ScrollPolicy.ON に設定して、水平スクロールバーが現在のテキスト領域内のコンテンツに関係なく常に表示されるようにします。

import fl.controls.TextArea;
import fl.controls.ScrollPolicy;

var myTextArea:TextArea = new TextArea();
myTextArea.wordWrap = false;
myTextArea.horizontalScrollPolicy = ScrollPolicy.ON;
myTextArea.text = "The quick brown fox jumped over the lazy dog.";
myTextArea.setSize(320, 120);
myTextArea.move(10, 10);
addChild(myTextArea);
horizontalScrollPositionプロパティ 
horizontalScrollPosition:Number  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ユーザーがテキストフィールドを水平方向にスクロールした後のスクロールバーサムの位置の変更 (ピクセル単位) を取得または設定します。この値が 0 の場合、テキストフィールドは水平方向にスクロールされません。

デフォルト値 : 0.


実装
    public function get horizontalScrollPosition():Number
    public function set horizontalScrollPosition(value:Number):void

関連項目

htmlTextプロパティ 
htmlText:String  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

テキストフィールドが含むストリングの HTML 表現を取得または設定します。

デフォルト値 : "".


実装
    public function get htmlText():String
    public function set htmlText(value:String):void

関連項目




次の例では、TextArea コンポーネントインスタンスを作成し、各種 HTML タグを使用してテキストのスタイルを設定します。

import fl.controls.TextArea;

var myText:String = "";
myText += "<p>You can use the <b> tag to create <b>bold</b> text.</p>";
myText += "<p>You can use the <i> tag to create <i>italic</i> text.</p>";
myText += "<p>You can use the <u> tag to create <u>underlined</a> text.</p>";
myText += "<p>You can use the <a> tag to create <a href='http://www.adobe.com'>links to other sites</a>.</p>";
myText += "<p>You can use the <br> tag to create<br>new lines of text<br>whenever you want.</p>";
myText += "<p>You can use the <font> tag to specificy different font <font color='#FF0000'>colors</font>, <font size='16'>sizes</font>, or <font face='Times New Roman'>faces</font>.</p>";
myText += "<p>You can use the <img> tag to load images or SWF files:<br><img src='http://www.helpexamples.com/flash/images/logo.png'>.</p>";

var myTextArea:TextArea = new TextArea();
myTextArea.htmlText = myText;
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
addChild(myTextArea);

次の例では、TextArea コンポーネントインスタンスを作成し、HTML アンカータグを使用してリンクを作成します。

import fl.controls.TextArea;

var str:String = "<p>Check out the following links:</p>";
str += "<li><a href=\"event:flash\"><u>Flash</u></a></li>";
str += "<li><a href=\"event:flex\"><u>Flex</u></a></li>";
str += "<li><a href=\"event:devnet\"><u>Developer Center</u></a></li>";

var myTextArea:TextArea = new TextArea();
myTextArea.htmlText += str;
myTextArea.setSize(320, 120);
myTextArea.move(10, 10);
myTextArea.addEventListener(TextEvent.LINK, linkHandler);
addChild(myTextArea);

function linkHandler(event:TextEvent):void {
    var url:String = "http://www.adobe.com/go/" + event.text;
    var urlReq:URLRequest = new URLRequest(url);
    navigateToURL(urlReq);
}
imeModeプロパティ 
imeMode:String  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

入力メソッドエディタ (IME) のモードを取得または設定します。IME を使用すると、ユーザーは QWERTY キーボードを使用して、中国語、日本語、および韓国語の文字セットから文字を入力することができます。

コンポーネントがフォーカスを取得したときに Flash は IME を指定されたモードに設定し、コンポーネントがフォーカスを失った後は元の値に復元します。

flash.system.IMEConversionMode クラスで、このプロパティの有効な値の定数を定義します。このプロパティを null に設定すると、IME がコンポーネントで使用されません。


実装
    public function get imeMode():String
    public function set imeMode(value:String):void

関連項目

lengthプロパティ 
length:Number  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

TextArea コンポーネントに含まれる文字の数を取得します。

デフォルト値 : 0.


実装
    public function get length():Number

関連項目

maxCharsプロパティ 
maxChars:int  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

テキストフィールドにユーザーが入力できる最大の文字数を取得または設定します。

デフォルト値 : 0.


実装
    public function get maxChars():int
    public function set maxChars(value:int):void

関連項目




次の例では、TextArea コンポーネントインスタンスを作成し、maxChars プロパティを設定してテキスト領域に入力できる文字数を制限します。

import fl.controls.Label;
import fl.controls.TextArea;

var myTextArea:TextArea = new TextArea();
myTextArea.maxChars = 500;
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(TextEvent.TEXT_INPUT, textInputHandler);
addChild(myTextArea);

var charCountLabel:Label = new Label();
charCountLabel.autoSize = TextFieldAutoSize.LEFT;
charCountLabel.move(myTextArea.x, myTextArea.y + myTextArea.height);
addChild(charCountLabel);

charCountLabel.text = myTextArea.length + " of " + myTextArea.maxChars;

function textInputHandler(event:TextEvent):void {
    updateCount();
}

function updateCount():void {
    charCountLabel.text = myTextArea.length + " of " + myTextArea.maxChars;
}
maxHorizontalScrollPositionプロパティ 
maxHorizontalScrollPosition:int  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

horizontalScrollPosition プロパティの最大値を取得します。

デフォルト値 : 0.


実装
    public function get maxHorizontalScrollPosition():int

関連項目

maxVerticalScrollPositionプロパティ 
maxVerticalScrollPosition:int  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

verticalScrollPosition プロパティの最大値を取得します。

デフォルト値 : 1.


実装
    public function get maxVerticalScrollPosition():int

関連項目

restrictプロパティ 
restrict:String  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

テキストフィールドがユーザーから受け取る文字のストリングを取得または設定します。

文字をプログラムで入力する場合は、このストリングに含まれない文字がテキストフィールドに入力されます。

ストリング内の文字は、左から右に読み取られます。ハイフン (-) 文字を使用して、文字の範囲を指定できます。

このプロパティの値が null の場合、テキストフィールドはすべての文字を受け入れます。このプロパティが空のストリング ("") に設定されている場合、テキストフィールドは文字を受け入れません。

ストリングがキャレット (^) 文字で始まる場合、そのストリングに含まれる文字を除いて、すべての文字を入力できます。ストリングがキャレット (^) 文字以外で始まる場合は、そのストリングに含まれる文字のみを入力できます。

デフォルト値 : null.


実装
    public function get restrict():String
    public function set restrict(value:String):void

関連項目

selectionBeginIndexプロパティ 
selectionBeginIndex:int  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

1 つまたは複数の文字の選択範囲から最初に選択される文字のインデックス位置を取得します。

選択される文字のインデックス位置はゼロから始まり、テキスト領域に表示される最初の文字から計算されます。選択されていない場合、この値はキャレットの位置に設定されます。

デフォルト値 : 0.


実装
    public function get selectionBeginIndex():int

関連項目

selectionEndIndexプロパティ 
selectionEndIndex:int  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

1 つまたは複数の文字の選択範囲から最後に選択される文字のインデックス位置を取得します。

選択される文字のインデックス位置はゼロから始まり、テキスト領域に表示される最初の文字から計算されます。選択されていない場合、この値はキャレットの位置に設定されます。

デフォルト値 : 0.


実装
    public function get selectionEndIndex():int

関連項目

textプロパティ 
text:String  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

現在 TextInput コンポーネントにあるテキストを含むストリングを取得または設定します。このプロパティは、フォーマットされていない、HTML タグのないテキストを含みます。HTML としてフォーマットされているこのテキストを取得するには、htmlText プロパティを使用します。

デフォルト値 : "".


実装
    public function get text():String
    public function set text(value:String):void

関連項目

textFieldプロパティ 
public var textField:TextField

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

TextArea コンポーネントの内部テキストフィールドへの参照です。

textHeightプロパティ 
textHeight:Number  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

テキストの高さ (ピクセル単位) を取得します。

デフォルト値 : 0.


実装
    public function get textHeight():Number

関連項目




次の例では、TextArea コンポーネントインスタンスを作成し、textWidth プロパティと textHeight プロパティを、change イベントが送出されたときに表示します。

import fl.controls.Label;
import fl.controls.TextArea;

var myTextArea:TextArea = new TextArea()
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextArea);

var widthLabel:Label = new Label();
widthLabel.autoSize = TextFieldAutoSize.LEFT;
widthLabel.text = "textWidth: " + myTextArea.textWidth;
widthLabel.move(340, 10);
addChild(widthLabel);

var heightLabel:Label = new Label();
heightLabel.autoSize = TextFieldAutoSize.LEFT;
heightLabel.text = "textHeight: " + myTextArea.textHeight;
heightLabel.move(340, 30);
addChild(heightLabel);

function changeHandler(event:Event):void {
    widthLabel.text = "textWidth: " + myTextArea.textWidth;
    heightLabel.text = "textHeight: " + myTextArea.textHeight;
}
textWidthプロパティ 
textWidth:Number  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

テキストの幅 (ピクセル単位) を取得します。

デフォルト値 : 0.


実装
    public function get textWidth():Number

関連項目




次の例では、TextArea コンポーネントインスタンスを作成し、textWidth プロパティと textHeight プロパティを、change イベントが送出されたときに表示します。

import fl.controls.Label;
import fl.controls.TextArea;

var myTextArea:TextArea = new TextArea()
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextArea);

var widthLabel:Label = new Label();
widthLabel.autoSize = TextFieldAutoSize.LEFT;
widthLabel.text = "textWidth: " + myTextArea.textWidth;
widthLabel.move(340, 10);
addChild(widthLabel);

var heightLabel:Label = new Label();
heightLabel.autoSize = TextFieldAutoSize.LEFT;
heightLabel.text = "textHeight: " + myTextArea.textHeight;
heightLabel.move(340, 30);
addChild(heightLabel);

function changeHandler(event:Event):void {
    widthLabel.text = "textWidth: " + myTextArea.textWidth;
    heightLabel.text = "textHeight: " + myTextArea.textHeight;
}
verticalScrollBarプロパティ 
verticalScrollBar:UIScrollBar  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

垂直スクロールバーへの参照を取得します。


実装
    public function get verticalScrollBar():UIScrollBar

関連項目




次の例では、TextArea コンポーネントインスタンスを作成し、コンポーネントの垂直スクロールバーに pageSize プロパティを設定します。

import fl.controls.TextArea;
import fl.events.ScrollEvent;

var myTextArea:TextArea = new TextArea();
myTextArea.setSize(160, 120);
myTextArea.move(10, 10);
myTextArea.verticalScrollBar.pageSize = 1;
myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myTextArea);

var myURLLoader:URLLoader = new URLLoader();
myURLLoader.addEventListener(Event.COMPLETE, completeHandler);
myURLLoader.load(new URLRequest("http://www.helpexamples.com/flash/lorem.txt"));

function scrollHandler(event:ScrollEvent):void {
    trace("scroll: " + myTextArea.verticalScrollPosition + " of " + myTextArea.maxVerticalScrollPosition);
}

function completeHandler(event:Event):void {
    var txt:String = URLLoader(event.currentTarget).data as String;
    myTextArea.text = txt;
}
verticalScrollPolicyプロパティ 
verticalScrollPolicy:String  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

垂直スクロールバーのスクロールポリシーを取得または設定します。次の値が含まれます。

デフォルト値 : ScrollPolicy.AUTO.


実装
    public function get verticalScrollPolicy():String
    public function set verticalScrollPolicy(value:String):void

関連項目




次の例では、TextArea コンポーネントインスタンスを作成し、verticalScrollPolicy プロパティを ScrollPolicy.ON に設定して、垂直スクロールバーが現在のテキスト領域内のコンテンツに関係なく常に表示されるようにします。

import fl.controls.TextArea;
import fl.controls.ScrollPolicy;

var myTextArea:TextArea = new TextArea();
myTextArea.verticalScrollPolicy = ScrollPolicy.ON;
myTextArea.text = "The quick brown fox jumped over the lazy dog.";
myTextArea.setSize(160, 120);
myTextArea.move(10, 10);
addChild(myTextArea);
verticalScrollPositionプロパティ 
verticalScrollPosition:Number  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ユーザーがテキストフィールドを垂直方向にスクロールした後のスクロールバーサムの位置の変更 (ピクセル単位) を取得または設定します。この値が 1 の場合、テキストフィールドは垂直方向にスクロールされません。

デフォルト値 : 1.


実装
    public function get verticalScrollPosition():Number
    public function set verticalScrollPosition(value:Number):void

関連項目




次の例では、Slider コンポーネントを使用して、TextArea コンポーネントのコンテンツをスクロールします。

import fl.controls.ScrollPolicy;
import fl.controls.Slider;
import fl.controls.SliderDirection
import fl.controls.TextArea;
import fl.events.ScrollEvent;
import fl.events.SliderEvent;

var myTextArea:TextArea = new TextArea();
myTextArea.horizontalScrollPolicy = ScrollPolicy.OFF;
myTextArea.verticalScrollPolicy = ScrollPolicy.OFF;
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myTextArea)

var mySlider:Slider = new Slider();
mySlider.liveDragging = true;
mySlider.snapInterval = 1;
mySlider.tickInterval = 1;
mySlider.width = myTextArea.width;
mySlider.move(myTextArea.x, myTextArea.y + myTextArea.height + 10);

var urlLdr:URLLoader = new URLLoader();
urlLdr.addEventListener(Event.COMPLETE, completeHandler);
urlLdr.dataFormat = URLLoaderDataFormat.TEXT;
urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/text/lorem.txt"));

function completeHandler(event:Event):void {
    var txt:String = event.target.data as String;
    myTextArea.text = txt;
    myTextArea.drawNow();

    mySlider.minimum = myTextArea.verticalScrollPosition;
    mySlider.maximum = myTextArea.maxVerticalScrollPosition;
    mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
    addChild(mySlider);
}

function scrollHandler(event:ScrollEvent):void {
    trace("scrolled:");
    mySlider.value = event.position;
}

function changeHandler(event:SliderEvent):void {
    trace("changed:");
    myTextArea.verticalScrollPosition = event.value;
}
wordWrapプロパティ 
wordWrap:Boolean  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

テキストが行の最後で折り返すかどうかを示すブール値を取得または設定します。true の値は、テキストが折り返すことを示します。false の値は、テキストが折り返さないことを示します。

デフォルト値 : true.


実装
    public function get wordWrap():Boolean
    public function set wordWrap(value:Boolean):void

関連項目

コンストラクタの詳細
TextArea()コンストラクタ
public function TextArea()

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

TextArea コンポーネントの新しいインスタンスを作成します。

メソッドの詳細
appendText()メソッド
public function appendText(text:String):void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

TextArea コンポーネントに含まれる最後の文字の後に指定されたストリングを追加します。このメソッドは、たとえば、myTextArea.text += moreText のように、加算後代入演算子を使用して text プロパティに 2 つのストリングを連結するよりも効率的です。このメソッドは特に、TextArea コンポーネントが大量の内容を含む場合に便利です。

パラメータ

text:String — 既存のテキストに追加されるストリングです。

drawFocus()メソッド 
public override function drawFocus(focused:Boolean):void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

このコンポーネントのフォーカスインジケータを表示または非表示にします。

UIComponent クラスは、focusSkin スタイルで指定されたクラスのインスタンスを作成し、適切に配置することによって、このメソッドを実装します。

パラメータ

focused:Boolean — フォーカスインジケータを表示するかどうかを示します。この値が true の場合、フォーカスインジケータは表示されます。この値が false の場合、フォーカスインジケータは非表示になります。

getLineMetrics()メソッド 
public function getLineMetrics(lineIndex:int):TextLineMetrics

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

指定されたテキストの行に関する情報を取得します。

パラメータ

lineIndex:int — 取得する情報に対応する行番号です。

戻り値
TextLineMetrics
getStyleDefinition()メソッド 
public static function getStyleDefinition():Object

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

現在のコンポーネントのデフォルトスタイルマップを取得します。スタイルマップには、使用されているスタイルに基づき、コンポーネントの適切な型が保持されます。たとえば、disabledTextFormat スタイルには、null または TextFormat オブジェクトの値が保持されます。現在のコンポーネントに対し、これらのスタイルを使用して、setStyle() を呼び出すことができます。次のコードでは、指定したコンポーネントのデフォルトの disabledTextFormat スタイルがオーバーライドされます。

componentInstance.setStyle("disabledTextFormat", new TextFormat());

戻り値
Object — デフォルトスタイルのオブジェクトです。

関連項目




次の例では、複数のコンポーネントクラス用のスタイルブラウザを作成します。
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}
setSelection()メソッド 
public function setSelection(setSelection:int, endIndex:int):void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

フォーカスを持つテキスト領域で行われた選択の範囲を設定します。選択範囲は、開始パラメータで指定されたインデックスから開始し、終了パラメータで指定されたインデックスで終了します。選択されたテキストは、最初の選択された文字がインデックス 0 の位置にあり、次の文字がインデックス 1 の位置にあるようなゼロから始まる文字のストリングとして処理されます。

テキストフィールドがフォーカスを持たない場合でも、このメソッドには影響ありません。

パラメータ

setSelection:int — 選択範囲の最初の文字のインデックス位置です。
 
endIndex:int — 選択範囲の最後の文字のインデックス位置です。

イベントの詳細
change イベント
イベントオブジェクトの型: flash.events.Event
Event.type property = flash.events.Event.CHANGE

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

TextArea コンポーネント内のテキストが変更されたときに送出されます。

type プロパティ (change イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblestrue
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
target値が変更されたオブジェクトです。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。
enter イベント  
イベントオブジェクトの型: fl.events.ComponentEvent
ComponentEvent.type property = fl.events.ComponentEvent.ENTER

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ユーザーがコンポーネントで Enter キーを押したときに送出されます。

type プロパティ (enter イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
currentTargetイベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
targetイベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。
scroll イベント  
イベントオブジェクトの型: fl.events.ScrollEvent
ScrollEvent.type property = fl.events.ScrollEvent.SCROLL

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

コンテンツがスクロールされたときに送出されます。

type プロパティ (scroll イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
currentTargetイベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
delta1。実行されたスクロールの量を示す値です。
directionvertical。ScrollBar の方向です。
position0。ScrollBar サムの移動後の位置です。
targetイベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。



次の例では、TextArea コンポーネントにテキストをロードし、ユーザーが TextArea をスクロールしたときに、スクロール方向、スクロール位置、および最大スクロール位置をトレースします。

import fl.controls.ScrollBarDirection;
import fl.controls.TextArea;
import fl.events.ScrollEvent;

var myTextArea:TextArea = new TextArea();
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myTextArea);

var urlLdr:URLLoader = new URLLoader();
urlLdr.addEventListener(Event.COMPLETE, completeHandler);
urlLdr.dataFormat = URLLoaderDataFormat.TEXT;
urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/text/lorem.txt"));

function completeHandler(event:Event):void {
    var txt:String = event.target.data as String;
    myTextArea.text = txt;
}

function scrollHandler(event:ScrollEvent):void {
    var myTA:TextArea = event.currentTarget as TextArea;
    var pos:Number = event.position;
    var maxPos:Number;
    
    if (event.direction == ScrollBarDirection.VERTICAL) {
        maxPos = myTA.maxVerticalScrollPosition;
    } else {
        maxPos = myTA.maxHorizontalScrollPosition;
    }
    trace("scroll: " + event.direction + " (" + pos.toFixed(2) + " of " + maxPos + ")");
}
textInput イベント  
イベントオブジェクトの型: flash.events.TextEvent
TextEvent.type property = flash.events.TextEvent.TEXT_INPUT

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ユーザーがコンポーネントに対してテキストの入力、削除、またはペーストを実行したときに送出されます。

type プロパティ (textInput イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblestrue
cancelabletrue は、preventDefault() メソッドを呼び出して、デフォルトの動作をキャンセルします。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
target文字が入力されるテキストフィールドです。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。
textユーザーが入力した文字または文字の連続です。
例の使用法
TextAreaExample.as

この例は、TextArea クラスのインスタンスのイベントを監視する方法を示します。

例を実行するには、次の手順に従います。

  1. TextArea コンポーネントをステージまでドラッグし、ta1 という名前を付けます。
  2. TextArea コンポーネントをステージまでドラッグし、ta2 という名前を付けます。
  3. このコードを TextAreaExample.as として FLA ファイルと同じディレクトリに保存します。
  4. FLA ファイルのドキュメントクラスを TextAreaExample に設定します。
package
{
    import fl.controls.TextArea;
    import fl.events.ComponentEvent;
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.events.TextEvent;
    import flash.text.TextField;
    
    public class TextAreaExample extends Sprite
    {
        private var testString:String         = 'Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Vivamus quis nisl vel tortor nonummy vulputate. Quisque sit amet eros sed purus euismod tempor. Morbi tempor. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos hymenaeos. Curabitur diam. Suspendisse at purus in ipsum volutpat viverra. Nulla pellentesque libero id libero. Proin pretium suscipit lectus. Donec in sapien vel nulla egestas semper. Mauris massa. In aliquet sem ac libero. In eget orci. Sed feugiat. Vestibulum vel felis in lectus imperdiet scelerisque. Vestibulum vestibulum neque at est. Etiam purus quam, laoreet quis, accumsan sed, porttitor ut, erat. Proin volutpat. In facilisis dolor gravida felis. Curabitur nisi lacus, euismod non, pharetra et, mollis a, tellus. Donec lectus orci, viverra at, luctus ac, sodales id, quam. Phasellus faucibus lacus ut est. Curabitur id diam eu massa bibendum lobortis. Vivamus quis elit. Donec mi justo, dictum vitae, cursus sit amet, lacinia consectetuer, d ut, vulputate sed, molestie et, arcu. Nullam mi.';
        private var testStringHTML:String     = 'This is <font color="#FF0000">HTML text</font> in a <b>TextArea control</b>. Use the <u>htmlText property</u> of the <font color="#008800">TextArea control</font> to include basic HTML markup in your text.';
        
        public function TextAreaExample() {
            ta1.text = testString;
            ta2.htmlText = testStringHTML;
            configureListeners(ta1);
            configureListeners(ta2);
        }
        private function configureListeners(ta:TextArea):void {
            ta.addEventListener(TextEvent.TEXT_INPUT,announceEvent);
            ta.addEventListener(Event.CHANGE,announceEvent);
            ta.addEventListener(ComponentEvent.ENTER,announceEvent);
            ta.addEventListener(Event.SCROLL,announceEvent);            
        }
        private function announceEvent(e:Event):void {
            trace(e.toString());    
        }
    }
}




 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flash/9.0_jp/ActionScriptLangRefV3/fl/controls/TextArea.html