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

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

TextInput コンポーネントは、ネイティブの ActionScript TextField オブジェクトを含む単一行のテキストコンポーネントです。

アプリケーション内で TextInput コンポーネントを有効または無効にすることができます。TextInput コンポーネントが有効な場合は、マウスまたはキーボードからの入力を受け取れません。有効な TextInput コンポーネントは、ActionScript TextField オブジェクトのように、フォーカス、選択、およびナビゲーションを実装します。

TextInput コンポーネントをカスタマイズするには、スタイルを使用すると、たとえばコンポーネントが無効なときにその外観を変更できます。このコンポーネントに適用できる他のカスタマイズとして、HTML による書式設定、入力テキストを非表示にするパスワードフィールドの設定などがあります。

例を表示

関連項目

TextArea


パブリック プロパティ
 プロパティ定義元
 InheritedaccessibilityProperties : AccessibilityProperties
この表示オブジェクトの現在のアクセシビリティオプションです。
DisplayObject
 Inheritedalpha : Number
指定されたオブジェクトのアルファ透明度値を示します。
DisplayObject
  alwaysShowSelection : Boolean
テキストフィールドがフォーカスを持たないときの選択の表示方法を示すブール値を取得または設定します。
TextInput
 InheritedblendMode : String
使用するブレンドモードを指定する BlendMode クラスの値です。
DisplayObject
 InheritedbuttonMode : Boolean
このスプライトのボタンモードを指定します。
Sprite
 InheritedcacheAsBitmap : Boolean
true に設定されている場合、表示オブジェクトの内部ビットマップ表現が Flash Player にキャッシュされます。
DisplayObject
  condenseWhite : Boolean
HTML テキストを含む TextInput コンポーネントから余分な空白を削除するかどうかを示すブール値を取得または設定します。
TextInput
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 InheritedcontextMenu : ContextMenu
このオブジェクトに関連付けられたコンテキストメニューを指定します。
InteractiveObject
  displayAsPassword : Boolean
現在の TextInput コンポーネントインスタンスがパスワードとテキストのどちらを含むように作成されたものであるかを示すブール値を取得または設定します。
TextInput
 InheriteddoubleClickEnabled : Boolean
オブジェクトが doubleClick イベントを受け取るかどうかを指定します。
InteractiveObject
 InheriteddropTarget : DisplayObject
[read-only] スプライトのドラッグ先またはスプライトがドロップされた先の表示オブジェクトを指定します。
Sprite
  editable : Boolean
テキストフィールドをユーザーが編集できるかどうかを示すブール値を取得または設定します。
TextInput
  enabled : Boolean
コンポーネントがユーザーの操作を受け付けるかどうかを示す値を取得または設定します。
TextInput
 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
  horizontalScrollPosition : int
水平スクロールバーのサムの位置を取得または設定します。
TextInput
  htmlText : String
テキストフィールドに含まれるストリングの HTML 表現を含みます。
TextInput
  imeMode : String
入力メソッドエディタ (IME) のモードを取得または設定します。
TextInput
  length : int
[read-only] TextInput コンポーネント内の文字数を取得します。
TextInput
 InheritedloaderInfo : LoaderInfo
[read-only] この表示オブジェクトが属するファイルのロード情報を含む LoaderInfo オブジェクトを返します。
DisplayObject
 Inheritedmask : DisplayObject
呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。
DisplayObject
  maxChars : int
テキストフィールドにユーザーが入力できる最大の文字数を取得または設定します。
TextInput
  maxHorizontalScrollPosition : int
[read-only] テキストフィールドをスクロールできる右端の最も遠い位置を示す値を取得します。
TextInput
 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
テキストフィールドがユーザーから受け取る文字のストリングを取得または設定します。
TextInput
 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 つまたは複数の文字の選択範囲から最初に選択される文字のインデックス値を取得します。
TextInput
  selectionEndIndex : int
[read-only] 1 つまたは複数の文字の選択範囲から最後に選択される文字のインデックス位置を取得します。
TextInput
 InheritedsoundTransform : SoundTransform
このスプライト内のサウンドを制御します。
Sprite
 Inheritedstage : Stage
[read-only] 表示オブジェクトのステージです。
DisplayObject
 InheritedtabChildren : Boolean
オブジェクトの子に対してタブが有効かどうかを調べます。
DisplayObjectContainer
 InheritedtabEnabled : Boolean
このオブジェクトがタブ順序に含まれるかどうかを指定します。
InteractiveObject
 InheritedtabIndex : int
SWF ファイル内のオブジェクトのタブ順序を指定します。
InteractiveObject
  text : String
現在 TextInput コンポーネントにあるテキストを含むストリングを取得または設定します。
TextInput
  textField : TextField
TextInput コンポーネントの内部テキストフィールドへの参照です。
TextInput
  textHeight : Number
[read-only] テキストの高さです (ピクセル単位)。
TextInput
 InheritedtextSnapshot : TextSnapshot
[read-only] この DisplayObjectContainer インスタンスの TextSnapshot オブジェクトを返します。
DisplayObjectContainer
  textWidth : Number
[read-only] テキストの幅です (ピクセル単位)。
TextInput
 Inheritedtransform : Transform
表示オブジェクトのマトリックス、カラー変換、ピクセル境界に関係するプロパティを持つオブジェクトです。
DisplayObject
 InheriteduseHandCursor : Boolean
buttonMode プロパティが true に設定されたスプライト上にマウスが移動したときに、指差しハンドポインタ (ハンドカーソル) を表示するかどうかを示すブール値です。
Sprite
 Inheritedversion : String = "3.0.0.15"
コンポーネントのバージョン番号。
UIComponent
 Inheritedvisible : Boolean
現在のコンポーネントのインスタンスが可視かどうかを示す値を取得または設定します。
UIComponent
 Inheritedwidth : Number
コンポーネントの幅を取得または設定します (ピクセル単位)。
UIComponent
 Inheritedx : Number
親コンテナ内での x 軸に沿ったコンポーネントの位置を表す x 座標を取得または設定します。
UIComponent
 Inheritedy : Number
親コンテナ内での y 軸に沿ったコンポーネントの位置を表す y 座標を取得または設定します。
UIComponent
パブリック メソッド
 メソッド定義元
  
TextInput コンポーネントの新しいインスタンスを作成します。
TextInput
 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 が含む最後の文字の後に追加します。
TextInput
 Inherited
特定の point ポイントを指定して呼び出した DisplayObjectContainer.getObjectsUnderPoint() メソッドから返されたリストに、セキュリティ上の制約のために省略される表示オブジェクトがあるかどうかを示します。
DisplayObjectContainer
 Inherited
このコンポーネントインスタンスからスタイルプロパティを削除します。
UIComponent
 Inherited
指定された表示オブジェクトが、DisplayObjectContainer インスタンスの子であるか、インスタンス自体であるかを指定します。
DisplayObjectContainer
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
  
このコンポーネントのフォーカスインジケータを表示または非表示にします。
TextInput
 Inherited
invalidateNow とは異なり、すべてを無効化せずに直ちに描画を開始します。
UIComponent
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
targetCoordinateSpace オブジェクトの座標系を基準にして、表示オブジェクトの領域を定義する矩形を返します。
DisplayObject
 Inherited
指定のインデックス位置にある子表示オブジェクトインスタンスを返します。
DisplayObjectContainer
 Inherited
指定された名前に一致する子表示オブジェクトを返します。
DisplayObjectContainer
 Inherited
子 DisplayObject インスタンスのインデックス位置を返します。
DisplayObjectContainer
 Inherited
現在フォーカスを持っているオブジェクトを取得します。
UIComponent
  
指定されたテキストの行に関する情報を取得します。
TextInput
 Inherited
指定されたポイントの下にあり、この DisplayObjectContainer インスタンスの子または孫などであるオブジェクトの配列を返します。
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
シェイプ上の線を除き、targetCoordinateSpace パラメータによって定義された座標系に基づいて、表示オブジェクトの境界を定義する矩形を返します。
DisplayObject
 Inherited
コンポーネントのスタイル参照チェーンに設定されているスタイルプロパティを取得します。
UIComponent
  
[static] 現在のコンポーネントのデフォルトスタイルマップを取得します。
TextInput
 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(beginIndex:int, endIndex:int):void
フォーカスを持つテキスト領域で行われた選択の範囲を設定します。
TextInput
 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
   ユーザー入力が TextInput コンポーネントのテキストを変更したときに送出されます。TextInput
 Inherited ユーザーが InteractiveObject をポインティングデバイスのメインボタンでクリックしたときに送出されます。InteractiveObject
 Inherited Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
 Inherited オブジェクトの doubleClickEnabled フラグが true に設定されている場合にユーザーが InteractiveObject をポインティングデバイスのメインボタンで 2 回続けてすばやくクリックすると送出されます。InteractiveObject
   ユーザーが Enter キーを押したときに送出されます。TextInput
 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
 Inherited コンポーネントの可視性が不可視から可視に変化した後に送出されます。UIComponent
 Inherited オブジェクトの tabChildren フラグの値が変更されたときに送出されます。InteractiveObject
 Inherited オブジェクトの tabEnabled フラグが変更されたときに送出されます。InteractiveObject
 Inherited オブジェクトの tabIndex プロパティの値が変更されたときに送出されます。InteractiveObject
   ユーザーがテキストを入力したときに送出されます。TextInput
スタイル
 スタイル 説明 定義元
  
disabledSkin
データ型: Class
TextInput コンポーネントの enabled プロパティが false に設定されている場合に、TextInput コンポーネントの背景として使用されるクラスの名前です。 デフォルト値 : TextInput_disabledSkin.
TextInput
 Inherited データ型: flash.text.TextFormat
ボタンが無効な場合に、コンポーネントラベルのレンダリングに使用される TextFormat オブジェクトです。
UIComponent
  
embedFonts
データ型: Boolean
埋め込みフォントのアウトラインが、テキストフィールドのレンダリングに使用されるかどうかを示します。 値が true の場合、Flash Player は埋め込みフォントアウトラインを使用してテキストフィールドをレンダリングします。 値が false である場合は、デバイスフォントを使用してテキストフィールドをレンダリングします。

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

デフォルト値 : false.
TextInput
 Inherited データ型: Number   形式: Length
コンポーネント領域の外側とフォーカスインジケータ領域のエッジを区切るパディングです (ピクセル単位)。
UIComponent
 Inherited データ型: Class
フォーカスインジケータの表示に使用されるスキンです。
UIComponent
 Inherited データ型: flash.text.TextFormat
コンポーネントラベルのレンダリングに使用される TextFormat オブジェクトです。
UIComponent
  
textPadding
データ型: Number   形式: Length
コンポーネントの境界とテキストを区切るパディングです (ピクセル単位)。 デフォルト値 : 0.
TextInput
  
upSkin
データ型: Class
TextInput コンポーネントの背景として使用されるクラスの名前です。 デフォルト値 : TextInput_upSkin.
TextInput
プロパティの詳細
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



次の例では、TextInput コンポーネントを作成し、setSelection() メソッドを使用してテキストを選択します。

import fl.controls.TextInput;

var myTextInput:TextInput = new TextInput();
myTextInput.text = "The quick brown fox jumped over the lazy dog.";
myTextInput.alwaysShowSelection = true;
myTextInput.setSelection(16, 19);
myTextInput.move(10, 10);
addChild(myTextInput);
condenseWhiteプロパティ 
condenseWhite:Boolean  [read-write]

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

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

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

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

デフォルト値 : false.


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

関連項目

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

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

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

このプロパティが true に設定されている場合は、ユーザーがテキストフィールドに入力する各文字に対して、TextInput コンポーネントインスタンスはアスタリスクを表示します。さらに、[カット] コマンドと [コピー] コマンド、およびそれに対応するキーボードショートカットが無効になります。これらの対策は、ユーザーの不在時にパスワードが復元されるのを防止できます。

デフォルト値 : false.


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

関連項目




次の例では、TextInput コンポーネントのインスタンスを 2 つ作成します。1 つのインスタンスでは displayAsPassword プロパティを true に設定し、他の 1 つでは false に設定します。

import fl.controls.Label;
import fl.controls.TextInput;

var usernameLabel:Label = new Label();
usernameLabel.text = "User name:";
usernameLabel.move(10, 10);
addChild(usernameLabel);

var usernameTextInput:TextInput = new TextInput();
usernameTextInput.move(90, 10);
addChild(usernameTextInput);

var passwordLabel:Label = new Label();
passwordLabel.text = "Password:";
passwordLabel.move(10, 40);
addChild(passwordLabel);

var passwordTextInput:TextInput = new TextInput();
passwordTextInput.displayAsPassword = true;
passwordTextInput.move(90, 40);
addChild(passwordTextInput);
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
horizontalScrollPositionプロパティ 
horizontalScrollPosition:int  [read-write]

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

水平スクロールバーのサムの位置を取得または設定します。

デフォルト値 : 0.


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

関連項目




次の例では、TextInput コンポーネントインスタンスを作成し、horizontalScrollPosition プロパティと maxHorizontalScrollPosition プロパティの現在の値を表示します。

import fl.controls.Label;
import fl.controls.Slider;
import fl.controls.TextInput;
import fl.events.SliderEvent;

var myTextInput:TextInput = new TextInput();
myTextInput.text = "The quick brown fox jumped over the lazy dog.";
myTextInput.width = 120;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, textInputChangeHandler);
myTextInput.textField.addEventListener(Event.SCROLL, scrollHandler);
addChild(myTextInput);

var mySlider:Slider = new Slider();
mySlider.snapInterval = 1;
mySlider.tickInterval = 10;
mySlider.minimum = 0;
mySlider.maximum = myTextInput.maxHorizontalScrollPosition;
mySlider.value = myTextInput.horizontalScrollPosition;
mySlider.liveDragging = true;
mySlider.addEventListener(SliderEvent.CHANGE, sliderChangeHandler);
mySlider.width = 120;
mySlider.move(10, 40);
addChild(mySlider);

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 50);
addChild(myLabel);

getScrollPosition();

function getScrollPosition():void {
    myTextInput.drawNow();
    var scrollPos:uint = myTextInput.horizontalScrollPosition;
    var maxScrollPos:uint = myTextInput.maxHorizontalScrollPosition;
    myLabel.text = "scrollPosition: " + scrollPos + " of " + maxScrollPos;
    mySlider.value = scrollPos;
    mySlider.maximum = maxScrollPos;
}

function scrollHandler(event:Event):void {
    getScrollPosition();
}

function sliderChangeHandler(event:SliderEvent):void {
    myTextInput.horizontalScrollPosition = event.value;
    getScrollPosition();
}

function textInputChangeHandler(event:Event):void {
    getScrollPosition();
}
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

関連項目




次の例では、編集不能な TextInput コンポーネントを作成し、htmlText プロパティを設定してテキストフィールドのテキストに HTML フォーマットを適用します。

import fl.controls.TextInput;

var myTextInput:TextInput = new TextInput();
myTextInput.editable = false;
myTextInput.enabled = false;
myTextInput.htmlText = "(<i>auto assigned</i>)";
myTextInput.move(10, 10);
addChild(myTextInput);
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:int  [read-only]

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

TextInput コンポーネント内の文字数を取得します。

デフォルト値 : 0.


実装
    public function get length():int

関連項目




次の例では、TextInput コンポーネントを作成し、maxChars プロパティと restrict プロパティを設定して入力可能な文字数を制限します。

import fl.controls.Label;
import fl.controls.TextInput;

var myTextInput:TextInput = new TextInput();
myTextInput.restrict = "0-9A-F";
myTextInput.maxChars = 6;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextInput);

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
myLabel.move(10, 30);
addChild(myLabel);

function changeHandler(event:Event):void {
    myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
}
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

関連項目




次の例では、TextInput コンポーネントを作成し、maxChars プロパティと restrict プロパティを設定して入力可能な文字数を制限します。

import fl.controls.Label;
import fl.controls.TextInput;

var myTextInput:TextInput = new TextInput();
myTextInput.restrict = "0-9A-F";
myTextInput.maxChars = 6;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextInput);

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
myLabel.move(10, 30);
addChild(myLabel);

function changeHandler(event:Event):void {
    myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
}
maxHorizontalScrollPositionプロパティ 
maxHorizontalScrollPosition:int  [read-only]

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

テキストフィールドをスクロールできる右端の最も遠い位置を示す値を取得します。

デフォルト値 : 0.


実装
    public function get maxHorizontalScrollPosition():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

関連項目




次の例では、TextInput コンポーネントの selectionBeginIndex プロパティと selectionEndIndex プロパティを表示する Label コンポーネントを作成します。この例では、setSelection() メソッドを使用して、選択の開始インデックスと終了インデックスをプログラムで設定するための Slider コンポーネントインスタンスも 2 つ作成します。

import fl.controls.Label;
import fl.controls.Slider;
import fl.controls.TextInput;
import fl.events.SliderEvent;

var myTextInput:TextInput = new TextInput();
myTextInput.alwaysShowSelection = true;
myTextInput.text = "The quick brown fox jumped over the lazy dog.";
myTextInput.width = 120;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
myTextInput.addEventListener(FocusEvent.FOCUS_IN, focusInHandler);
myTextInput.addEventListener(FocusEvent.FOCUS_OUT, focusOutHandler);
addChild(myTextInput);

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 30);
addChild(myLabel);

var beginSlider:Slider = new Slider();
beginSlider.maximum = myTextInput.length;
beginSlider.snapInterval = 1;
beginSlider.liveDragging = true;
beginSlider.width = 120;
beginSlider.move(10, 65);
beginSlider.addEventListener(SliderEvent.CHANGE, beginChangeHandler);
addChild(beginSlider);

var endSlider:Slider = new Slider();
endSlider.maximum = myTextInput.length;
endSlider.snapInterval = 1;
endSlider.liveDragging = true;
endSlider.width = 120;
endSlider.move(10, 85);
endSlider.addEventListener(SliderEvent.CHANGE, endChangeHandler);
addChild(endSlider);

var t:Timer = new Timer(50);
t.addEventListener(TimerEvent.TIMER, timerHandler);

function changeHandler(event:Event):void {
    beginSlider.maximum = myTextInput.length;
    endSlider.maximum = myTextInput.length;
    updateUI();
}

function focusInHandler(event:FocusEvent):void {
    t.start();
}

function focusOutHandler(event:FocusEvent):void {
    t.stop();
}

function beginChangeHandler(event:SliderEvent):void {
    myTextInput.setSelection(event.value, myTextInput.selectionEndIndex);
    updateUI();
}

function endChangeHandler(event:SliderEvent):void {
    myTextInput.setSelection(myTextInput.selectionBeginIndex, event.value);
    updateUI();
}

function timerHandler(event:TimerEvent):void {
    updateUI();
}

function updateUI():void {
    myLabel.text = "selectionBeginIndex:" + myTextInput.selectionBeginIndex + "\n";
    myLabel.text += "selectionEndIndex:" + myTextInput.selectionEndIndex;
    beginSlider.value = myTextInput.selectionBeginIndex;
    endSlider.value = myTextInput.selectionEndIndex;
}
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

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




次の例では、TextInput コンポーネントインスタンスを作成し、textField プロパティを使用して基になるネイティブ ActionScript TextField オブジェクトにアクセスし、その replaceText() メソッドを呼び出します。

import fl.controls.TextInput;

var myTextInput:TextInput = new TextInput();
myTextInput.text = "The quick brown fox jumped over the lazy dog.";
myTextInput.textField.replaceText(41, 44, "fox");
myTextInput.textField.replaceText(16, 19, "dog");
addChild(myTextInput);
textHeightプロパティ 
textHeight:Number  [read-only]

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

テキストの高さです (ピクセル単位)。

デフォルト値 : 0.


実装
    public function get textHeight():Number

関連項目

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

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

テキストの幅です (ピクセル単位)。

デフォルト値 : 0.


実装
    public function get textWidth():Number

関連項目




次の例では、TextInput コンポーネントインスタンスを作成し、テキストフィールドの内容が変更されたとき、textWidth プロパティと textHeight プロパティをトレースします。

import fl.controls.TextInput;

var myTextInput:TextInput = new TextInput();
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextInput);

function changeHandler(event:Event):void {
    trace("textWidth:" + myTextInput.textWidth + ", textHeight:" + myTextInput.textHeight);
}
コンストラクタの詳細
TextInput()コンストラクタ
public function TextInput()

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

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

メソッドの詳細
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(index:int):TextLineMetrics

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

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

パラメータ

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

戻り値
TextLineMetrics



次の例は、ベースラインからの入力のアセントで赤の矩形を描き、ベースラインからの入力のディセントで青の矩形を描きます。
var format:TextFormat = new TextFormat();
format.size = 72;
format.font = "Georgia";

import fl.controls.TextInput;

var ti:TextInput = new TextInput();
addChild(ti);
ti.setSize(393,82);
ti.move(10,10);
ti.setStyle("textFormat",format);
ti.text = "Hello World";
ti.drawNow();

var metrics:TextLineMetrics = ti.getLineMetrics(0);

var ascenderColoring:Shape = new Shape();
var descenderColoring:Shape = new Shape();
ti.addChild(ascenderColoring);
ti.addChild(descenderColoring);

ascenderColoring.graphics.clear();
ascenderColoring.graphics.beginFill(0xFF0000,0.2);
ascenderColoring.graphics.drawRect(0, 0, metrics.width, metrics.ascent);
descenderColoring.graphics.clear();
descenderColoring.graphics.beginFill(0x0000FF,0.2);
descenderColoring.graphics.drawRect(0, metrics.ascent + 2, metrics.width, metrics.descent);
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(beginIndex:int, endIndex:int):void

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

フォーカスを持つテキスト領域で行われた選択の範囲を設定します。選択範囲は、開始パラメータで指定されたインデックスから開始し、終了パラメータで指定されたインデックスで終了します。選択範囲を指定するパラメータ値が同じ場合、このメソッドは caretIndex プロパティが行うのと同じ方法でテキスト挿入ポイントを設定します。

選択されたテキストは、最初の選択された文字がインデックス 0 の位置にあり、次の文字がインデックス 1 の位置にあるようなゼロから始まる文字のストリングとして処理されます。

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

パラメータ

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

関連項目




次の例では、TextInput インスタンスにテキストを入力し、2 つ目の単語を選択します。
import fl.controls.TextInput;

var ti:TextInput = new TextInput();
addChild(ti);
ti.text = "Hello World";
ti.setFocus();
ti.setSelection(6, 11);

次の例では、TextInput コンポーネントを作成し、setSelection() メソッドを使用してテキストを選択します。

import fl.controls.TextInput;

var myTextInput:TextInput = new TextInput();
myTextInput.text = "The quick brown fox jumped over the lazy dog.";
myTextInput.alwaysShowSelection = true;
myTextInput.setSelection(16, 19);
myTextInput.move(10, 10);
addChild(myTextInput);
イベントの詳細
change イベント
イベントオブジェクトの型: flash.events.Event
Event.type property = flash.events.Event.CHANGE

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

ユーザー入力が TextInput コンポーネントのテキストを変更したときに送出されます。

メモ : ActionScript を使用してテキストを変更した場合、このイベントは生成されません。

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 プロパティを使用します。
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ユーザーが入力した文字または文字の連続です。
例の使用法
TextInputExample.as

この例は、TextInput コンポーネントを使用して基本的なログインシステムを作成する方法を示します。

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

  1. ライブラリに TextInput、Label、および Button コンポーネントを追加します。
  2. このコードを TextInputExample.as として FLA ファイルと同じディレクトリに保存します。
  3. FLA ファイルのドキュメントクラスを TextInputExample に設定します。
package 
{
    import fl.controls.Button;
    import fl.controls.Label;
    import fl.controls.TextInput;
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.events.MouseEvent;
    import flash.text.TextFieldAutoSize;    
    
    public class TextInputExample extends Sprite
    {
        private var ti1:TextInput;
        private var ti2:TextInput;
        private var label1:Label;
        private var label2:Label;
        private var submitBtn:Button;
        
        public function TextInputExample() {
            setupLabels();
            setupInputFields();    
            setupButton();
        }
        private function setupInputFields():void {
            ti1 = new TextInput();
            ti2 = new TextInput();
            ti1.move(50,10);
            ti2.move(50,40);
            ti2.displayAsPassword = true;
            ti1.addEventListener(Event.CHANGE, textEntered);
            ti2.addEventListener(Event.CHANGE, textEntered);
            addChild(ti1);
            addChild(ti2);
        }
        private function setupLabels():void {
            label1 = new Label();
            label2 = new Label();
            label1.move(10,10);
            label2.move(10,40);
            label1.text = "User:";
            label2.text = "Pass:"
            addChild(label1);
            addChild(label2);
        }
        private function setupButton():void {
            submitBtn = new Button();
            submitBtn.move(150,70);
            submitBtn.label = "Go";
            submitBtn.enabled = false;
            submitBtn.setSize(50,20);
            submitBtn.addEventListener(MouseEvent.CLICK, submitLogin);
            addChild(submitBtn);
        }
        private function textEntered(e:Event):void {
            if(ti1.text != "" && ti2.text != "") {
                submitBtn.enabled = true;
            }
            else {
                submitBtn.enabled = false;    
            }
        }
        private function submitLogin(e:MouseEvent):void {
            var submitLabel:Label = new Label();
            submitLabel.move(10,70);
            submitLabel.autoSize = TextFieldAutoSize.LEFT;
            submitLabel.text = "Login has been submitted."
            addChild(submitLabel);
            submitBtn.removeEventListener(MouseEvent.CLICK, submitLogin);
        }
    }
}




 

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

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