メソッド | プロパティ | エフェクト | イベント | スタイル | フレームあり | フレームなし

mx.controls
TextArea クラス

継承を示す線継承を示す線継承を示す線継承を示す線


TextArea クラス
mx.core.ScrollView の拡張

TextArea コントロールは複数行のテキストフィールドで、境界線とオプションのスクロールバーが含まれます。1 つの TextArea コントロール内では、HTML テキストの場合を除き、すべてのテキストに同じスタイルを使用する必要があります。TextArea コントロールでは、Macromedia Flash Player の HTML レンダリング機能をサポートしています。TextArea コントロールは change イベントをブロードキャストします。

TextArea コントロールを無効にすると、その中のコンテンツは、disabledColor スタイルで定義される別のカラーで表示されます。TextArea コントロールを読み取り専用に設定すると、テキストの編集を禁止できます。入力されるテキストを隠し、文字をアスタリスクで表示するには、TextArea の password プロパティを設定します。

MXML シンタックス

<mx:TextArea> タグは、親クラスのすべてのプロパティと、次のプロパティを継承します。

 <mx:TextArea
editable="true|false"
hPosition="Always 0 when wordwrap is set to true."
hScrollPolicy="auto|on|off"
htmlText="No default."
maxChars="undefined"
maxHPosition="Always 0 when wordwrap is set to true."
maxVPosition="0"
password="false|true"
restrict="null"
text="No default."
vPosition="0"
vScrollPolicy="auto|on|off"
wordWrap="false|true"
change="Event handler; no default."
/>

を参照するにはここをクリックしてください

関連項目
    TextInput



メソッド

mx.core.ScrollView クラスから継承されるメソッド
childLoaded   createChildren   createChildWithStyles   getViewMetrics   init   layoutChildren   setScrollProperties  

mx.core.View クラスから継承されるメソッド
childLoaded   constructObject2   createChild   createChildren   destroyAllChildren   destroyChild   destroyChildAt   draw   getBorderMetrics   getChildAt   getChildIndex   getViewMetrics   init   layoutChildren   layoutChrome   setChildIndex  

mx.core.UIComponent クラスから継承されるメソッド
drawFocus   getFocus   getFocusManager   setEnabled   setFocus  

mx.core.UIObject クラスから継承されるメソッド
addEventListener   applyProperties   buildDepthTable   commitProperties   constructObject2   createAccessibilityImplementation   createChildAtDepth   createChildren   createClassChildAtDepth   createClassObject   createEmptyObject   destroyObject   dispatchEvent   doLater   draw   drawRect   executeBindings   fillRect   findNextAvailableDepth   getRepeaterItem   getStyle   handleEvent   init   invalidate   invalidateLayout   invalidateProperties   invalidateSize   invalidateStyle   layoutChildren   measure   move   redraw   removeEventListener   setDepthAbove   setDepthBelow   setMask   setSize   setSizeNoLayout   setStyle   swapDepths  



プロパティ
       className:String
このクラスの名前です。
       editable:Boolean
true の場合、ユーザーがテキストを編集できます。
       hPosition:Number
現在表示されている一番左の文字のピクセル位置です。
       hScrollPolicy:String
水平スクロールバーを常にオンにするか (on)、常にオフにするか (off)、必要なときにオンにするか (auto) を指定します。
       htmlText:String
HTML 形式のテキストを含みます。
       length:Number    [読み取り専用]
TextArea 内のテキストの長さです。
       maxChars:Number
テキストフィールドに入る最大の文字数です。
       maxHPosition:Number    [読み取り専用]
hPosition の最大値です。
       maxVPosition:Number    [読み取り専用]
vPosition の最大値です。
       password:Boolean
true の場合、フィールドはパスワードのフィールドになります。
       restrict:String
ユーザーがテキストフィールドに入力できる文字のセットです。
       tabIndex:Number
Tab キーでナビゲーションを行う際のタブ順序です。
       text:String
コントロールに表示されるテキストストリングです。
staticversion:String
このクラスのバージョンを表すストリングです。
       vPosition:Number
現在表示されている一番上の文字行の行番号です。
       vScrollPolicy:String
垂直スクロールバーを常にオンにするか (on)、常にオフにするか (off)、必要なときにオンにするか (auto) を指定します。
       wordWrap:Boolean
true の場合、テキストは折り返されます。

mx.core.ScrollView クラスから継承されるプロパティ
className   hPosition   hScrollPolicy   liveScrolling   maxHPosition   maxVPosition   scrollTipFunction   showScrollTips   version   vPosition   vScrollPolicy  

mx.core.View クラスから継承されるプロパティ
baselinePosition   className   numChildren   version  

mx.core.UIComponent クラスから継承されるプロパティ
enabled   errorString   tabEnabled   tabIndex   version  

mx.core.UIObject クラスから継承されるプロパティ
alpha   baselinePosition   className   depth   documentDescriptor   height   heightFlex   id   instanceIndices   isDocument   kStretch   layoutHeight   layoutWidth   maxHeight   maxWidth   minHeight   minWidth   mouseX   mouseY   nestLevel   oldHeight   oldWidth   oldX   oldY   parent   parentApplication   parentDocument   percentHeight   percentWidth   preferredHeight   preferredWidth   repeaterIndices   scaleX   scaleY   styleName   tabEnabled   toolTip   version   visible   width   widthFlex   x   y  



エフェクト

mx.core.UIComponent クラスから継承されるエフェクト
focusInEffect   focusOutEffect  

mx.core.UIObject クラスから継承されるエフェクト
creationCompleteEffect   hideEffect   mouseDownEffect   mouseOutEffect   mouseOverEffect   mouseUpEffect   moveEffect   resizeEffect   showEffect  



イベント
changeTextArea コントロールのテキストが変更されたときにブロードキャストします。このイベントオブジェクトの target プロパティには、イベントをトリガしたコンポーネントへの参照が含まれます。イベントオブジェクトの type プロパティには、イベント名 change が含まれます。

mx.core.ScrollView クラスから継承されるイベント
scroll 

mx.core.View クラスから継承されるイベント
childCreated  childDestroyed  childIndexChanged 

mx.core.UIComponent クラスから継承されるイベント
focusIn  focusOut  invalid  keyDown  keyUp  valid  valueCommitted 

mx.core.UIObject クラスから継承されるイベント
creationComplete  dragComplete  dragDrop  dragEnter  dragExit  dragOver  draw  effectEnd  effectStart  hide  hideToolTip  initialize  load  mouseChangeSomewhere  mouseDown  mouseDownSomewhere  mouseMove  mouseMoveSomewhere  mouseOut  mouseOver  mouseUp  mouseUpSomewhere  move  resize  show  showToolTip  unload 



スタイル
disabledColor型 : Number   形式 : Color   CSS の継承 : あり
無効状態の TextArea のカラーです。

mx.core.UIComponent クラスから継承されるスタイル
backgroundAlpha   backgroundColor   backgroundDisabledColor   backgroundImage   backgroundSize   barColor   borderCapColor   borderColor   borderSides   borderStyle   borderThickness   cornerRadius   disabledColor   dropShadow   errorColor   fillColors   highlightColor   modalTransparency   scrollTrackColor   selectedFillColors   shadowCapColor   shadowColor   shadowDirection   shadowDistance   symbolBackgroundColor   symbolBackgroundDisabledColor   symbolBackgroundPressedColor   symbolColor   symbolDisabledColor   themeColor  

mx.core.UIObject クラスから継承されるスタイル
color   fontFamily   fontSize   fontStyle   fontWeight   horizontalGap   leading   marginLeft   marginRight   textAlign   textDecoration   textIndent   verticalGap  



プロパティの詳細

className

className:String  

このクラスの名前です。


editable

editable:Boolean  

true の場合、ユーザーがテキストを編集できます。デフォルト値は true です。


hPosition

hPosition:Number  

現在表示されている一番左の文字のピクセル位置です。このプロパティは常に 0 に設定されており、wordWraptrue に設定されている場合は変更も無視されます。


hScrollPolicy

hScrollPolicy:String  

水平スクロールバーを常にオンにするか (on)、常にオフにするか (off)、必要なときにオンにするか (auto) を指定します。デフォルト値は auto です。


htmlText

htmlText:String  

HTML 形式のテキストを含みます。テキストストリングに HTML タグを含める場合は、CDATA タグで囲む必要があります。タブなどの空白文字や改行文字は畳んで表示されます。特殊文字である左山カッコ (<)、右山カッコ (>)、アンパサンド (&) については、それぞれ対応する HTML の表記 &lt;、&gt;、および &amp; を使用します。

メモ : htmlText プロパティでは、コントロールの CSS スタイル設定が無視され、ストリング内の HTML タグに基づいて書式が設定されます。

したがって、colorfontSize、および fontFamily などのスタイル属性は無視されます。


length

length:Number   [読み取り専用]

TextArea 内のテキストの長さです。


maxChars

maxChars:Number  

テキストフィールドに入る最大の文字数です。デフォルト値は undefined です。


maxHPosition

maxHPosition:Number   [読み取り専用]

hPosition の最大値です。デフォルト値は 0 です。このプロパティは、wordWraptrue に設定されている場合は常に 0 に設定されます。


maxVPosition

maxVPosition:Number   [読み取り専用]

vPosition の最大値です。デフォルト値は 0 です。


password

password:Boolean  

true の場合、フィールドはパスワードのフィールドになります。デフォルト値は false です。このプロパティを true に設定すると、コントロールに入力されるテキストの文字は "*" で表示されます。


restrict

restrict:String  

ユーザーがテキストフィールドに入力できる文字のセットです。restrict プロパティの値が null または空のストリングの場合は、任意の文字を入力できます。このプロパティはユーザーの操作のみを制限します。スクリプトでテキストフィールドに入力するテキストは制限しません。restrict プロパティの値が文字のストリングである場合は、そのストリング内の文字のみをテキストフィールドに入力できます。
ストリングは左から右へスキャンされます。範囲はダッシュ (-) を使用して指定できます。ストリングが ^ で始まる場合、それに続くストリング内の文字はすべて、コントロールに入力できない文字として解釈されます。
たとえば、"^a-z" というストリングは、大文字はすべて入力できますが小文字はいっさい入力できないことを意味します。一部の文字は restrict プロパティで使用すると特殊な意味を持つため、リテラル文字の -、^、および \ を指定するには、次のように円記号を使用する必要があります。
\^
\-
\\


tabIndex

tabIndex:Number  

Tab キーでナビゲーションを行う際のタブ順序です。


text

text:String  

コントロールに表示されるテキストストリングです。タブなどの空白文字や改行文字は畳んで表示されます。テキストストリング内の HTML タグはすべて無視され、ストリングに入力したとおりに表示されます。特殊文字である左山カッコ (<)、右山カッコ (>)、アンパサンド (&) が含まれる場合は、CDATA タグでテキストストリングを囲む必要があります。

HTML タグを含むテキストを表示するには、代わりに htmlText プロパティを使用します。


version

static  version:String  

このクラスのバージョンを表すストリングです。


vPosition

vPosition:Number  

現在表示されている一番上の文字行の行番号です。デフォルト値は 0 です。


vScrollPolicy

vScrollPolicy:String  

垂直スクロールバーを常にオンにするか (on)、常にオフにするか (off)、必要なときにオンにするか (auto) を指定します。デフォルト値は auto です。


wordWrap

wordWrap:Boolean  

true の場合、テキストは折り返されます。デフォルト値は true です。


TextAreaExample.mxml
<?xml version="1.0"?>
<!-- TextArea コントロールの使用方法を示す簡単な例 -->
<mx:Application xmlns:mx="http://www.macromedia.com/2003/mxml" backgroundColor="#FFFFFF">

<mx:Script>
<![CDATA[
var sampleText= "The TextArea control is a multiline text field with a border and optional scroll bars." +
"All text in a TextArea control must use the same styling unless it is HTML text." +
"The TextArea control supports the HTML rendering capabilities of Macromedia Flash Player." +
"The TextArea control broadcasts a change event." +
"If you disable a TextArea control, it displays contents in a different color," +
"represented by the disabledColor style.You can set a TextArea control to read-only to" +
"disallow editing of the text.To conceal input text by displaying characters as asterisks," +
"you set the TextArea's password property.";
                                                            
function showOutput()
           {
textAreaoutput.text= "TextArea Format:" + sampleText;                         
           }
             
function clearText()
           {
textAreaoutput.text="";
           }
           
         ]]>
</mx:Script>

<mx:Panel title="TextArea Panel" marginTop="10">
        
<mx:TextArea id="textAreaoutput" width="300"  height="170"/>
        
<mx:HBox>
<mx:Button label="Press Enter"  click="showOutput();"/>
<mx:Button label="Clear"  click="clearText();"/>
</mx:HBox>
               
</mx:Panel>

</mx:Application>