| メソッド | プロパティ | エフェクト | イベント | スタイル | 例 | フレームあり | フレームなし |
TextInput コントロールは、オプションで編集も可能な単一行のテキストフィールドです。1 つの TextInput コントロール内では、HTML テキストの場合を除き、すべてのテキストに同じスタイルを使用する必要があります。TextInput コントロールでは、Macromedia Flash Player の HTML レンダリング機能をサポートしています。TextInput コントロールを Form コンテナ内の FormItem コントロール内で使用する場合は、他の入力コントロールや選択コントロールと同様に、必須値インジケータを含めることができます。
TextInput コントロールにはラベルが含まれませんが、Label コントロールを使用するか、Form コンテナ内の FormItem コントロール内で TextInput コントロールをネストすればラベルを追加できます。TextInput コントロールは、値が必須であるかどうかを表示します。TextInput コントロールには、入力済み状態、選択状態、無効状態、エラー状態など多くの状態があります。TextInput コントロールでは、フォーマット、検証、およびキーボードショートカットをサポートしています。また、change イベントおよび enter イベントをブロードキャストします。
TextInput コントロールを無効にすると、その中のコンテンツは、disabledColor スタイルで定義される別のカラーで表示されます。テキストの編集を禁止するには、editable プロパティを false に設定します。入力されるテキストを隠し、文字の代わりにアスタリスクを表示するには、TextInput コントロールの password プロパティを設定します。
MXML シンタックス
<mx:TextInput> タグは、親クラスのすべてのプロパティと、次のプロパティを継承します。
<mx:TextInput例を参照するにはここをクリックしてください
editable="true|false"
hPosition="0"
htmlText="No default."
maxChars="undefined"
maxHPosition="0"
password="false|true"
restrict="null"
text="No default."
disabledColor="0xAAB3B3"
change="Event handler; no default."
enter="Event handler; no default."
/>
関連項目
TextArea
| メソッド |
| mx.core.UIComponent クラスから継承されるメソッド |
drawFocus getFocus getFocusManager setEnabled setFocus |
| プロパティ | |
| className:Stringこのクラスの名前です。 |
| editable:Booleantrue の場合、ユーザーがテキストを編集できます。 |
| hPosition:Number現在表示されている一番左の文字のピクセル位置です。 |
| htmlText:StringHTML 形式のテキストを含みます。 |
| length:Number
[読み取り専用]
コンポーネント内のテキストの長さです。 |
| maxChars:Numberテキストフィールドに入る最大の文字数です。 |
| maxHPosition:Number
[読み取り専用]
hPosition の最大値です。 |
| password:Booleanフィールドがパスワードのフィールドの場合は true、そうでない場合は false です。 |
| restrict:Stringユーザーがテキストフィールドに入力できる文字のセットです。 |
| tabIndex:NumberTab キーでナビゲーションを行う際のタブ順序です。 |
| text:Stringコントロールに表示されるテキストストリングです。 |
static | version:Stringこのクラスのバージョンを表すストリングです。 |
| mx.core.UIComponent クラスから継承されるプロパティ |
enabled errorString tabEnabled tabIndex version |
| エフェクト |
| mx.core.UIComponent クラスから継承されるエフェクト |
focusInEffect focusOutEffect |
| mx.core.UIObject クラスから継承されるエフェクト |
creationCompleteEffect hideEffect mouseDownEffect mouseOutEffect mouseOverEffect mouseUpEffect moveEffect resizeEffect showEffect |
| イベント | |
change | TextInput コントロールのテキストが変更されたときにブロードキャストします。イベントオブジェクトの target プロパティには、このイベントをトリガしたコンポーネントへの参照が設定されます。イベントオブジェクトの type プロパティには、イベント名 change が設定されます。 |
enter | ユーザーが Enter キーを押したときにブロードキャストする enter イベントのハンドラです。イベントオブジェクトの target プロパティには、このイベントをトリガしたコンポーネントへの参照が設定されます。イベントオブジェクトの type プロパティには、イベント名 enter が設定されます。 |
| mx.core.UIComponent クラスから継承されるイベント |
focusIn focusOut invalid keyDown keyUp valid valueCommitted |
| スタイル | |
disabledColor | 型 : Number 形式 : Color CSS の継承 : あり無効状態の TextInput のカラーです。デフォルト値は 0xAAB3B3 です。 |
| mx.core.UIObject クラスから継承されるスタイル |
color fontFamily fontSize fontStyle fontWeight horizontalGap leading marginLeft marginRight textAlign textDecoration textIndent verticalGap |
| プロパティの詳細 |
className:String
editable:Boolean
hPosition:Number
htmlText:String
メモ : htmlText プロパティでは、コントロールの CSS スタイル設定が無視され、ストリング内に直接指定された HTML タグに基づいて書式が設定されます。
したがって、color、fontSize、および fontFamily などのスタイル属性は無視されます。
length:Number [読み取り専用]
maxChars:Number
maxHPosition:Number [読み取り専用]
password:Boolean
restrict:String
tabIndex:Number
text:String
HTML タグを含むテキストを表示するには、代わりに htmlText プロパティを使用します。
static version:String
| 例 |
| TextInputExample.mxml |
|