| パッケージ | mx.controls |
| public class Text | |
| 継承 | Text  Label UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Text コントロールでは、スクロールバーはサポートされていません。スクロールする必要がある場合は、編集可能でない TextArea コントロールを使用します。
HTML タグを使用して、Text コントロールのテキストをフォーマットできます。コントロールの CSS スタイルが適用された後に HTML タグが適用されます。テキストの上下左右にスペースを追加することもできます。
デフォルトでは、Text コントロール内のテキストは選択可能ですが、選択不可に設定することもできます。アイテムレンダラー内で Text コントロールを使用する場合は、selectable プロパティを常に false に設定します。
テキストの長さがコントロールの幅を超える場合は、テキストを折り返します。テキストは、コントロール内で常に左上揃えで表示されます。
Text コンポーネントのサイズを設定するには、通常では、幅を明示的に指定し、すべてのテキストが表示されるように高さを自動調整します。明示的な高さを指定すると、一部のテキストが切り詰められる場合があります。Label とは異なり、Text では切り詰められたテキストに対して "..." が表示されません。また、Text では、パーセント値を使用して幅と高さを設定することもよくあります。
幅と高さを未指定のままにすると、行の折り返しなしに、テキスト内の明示的な改行に基づいて幅と高さが計算されます。たとえば、text プロパティを設定した場合は、改行文字 "\n" によって改行が発生します。htmlText プロパティを設定した場合は、HTML マークアップ <br> によって改行が生じます。text または htmlText が長く、改行が含まれていない場合、Text コンポーネントの幅が非常に長くなる可能性があります。maxWidth を設定して、コンポーネントの幅を制限できます。
Text コントロールには、背景や境界線がなく、フォーカスを取得できません。
MXML シンタックス
MXML シンタックスの非表示
<mx:Text> タグはスーパークラスのすべてのタグ属性を継承し、次のタグを追加します。
<mx:Text />
関連項目
| メソッド | 定義 | ||
|---|---|---|---|
| Text()
コンストラクタ。
| Text | ||
 | addChild(child:DisplayObject):DisplayObject
この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。
| DisplayObjectContainer | |
| addChildAt(child:DisplayObject, index:int):DisplayObject
この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。
| DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
| EventDispatcher | |
| areInaccessibleObjectsUnderPoint(point:Point):Boolean
特定の
point ポイントを指定して呼び出した DisplayObjectContainer.getObjectsUnderPoint() メソッドから返されたリストに、セキュリティ上の制約のために省略される表示オブジェクトがあるかどうかを示します。 | DisplayObjectContainer | |
| callLater(method:Function, args:Array = null):void
後で呼び出す関数をキューに格納します。
| UIComponent | |
| clearStyle(styleProp:String):void
このコンポーネントインスタンスからスタイルプロパティを削除します。
| UIComponent | |
| contains(child:DisplayObject):Boolean
指定された表示オブジェクトが、DisplayObjectContainer インスタンスの子であるか、インスタンス自体であるかを指定します。
| DisplayObjectContainer | |
| contentToGlobal(point:Point):Point
Point オブジェクトをコンテンツ座標からグローバル座標に変換します。 | UIComponent | |
| contentToLocal(point:Point):Point
Point オブジェクトをコンテンツ座標からローカル座標に変換します。 | UIComponent | |
| createReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void
この IUIComponent オブジェクトへの
id 参照を親ドキュメントオブジェクト上に作成します。 | UIComponent | |
| deleteReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void
この IUIComponent オブジェクトへの
id 参照を親ドキュメントオブジェクトから削除します。 | UIComponent | |
| determineTextFormatFromStyles():UITextFormat
この UIComponent のテキストスタイルに対応する UITextFormat オブジェクトを返します。
| UIComponent | |
| dispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
| EventDispatcher | |
| drawFocus(focused:Boolean):void
このコンポーネントを囲むフォーカスインジケータを表示または非表示にします。
| UIComponent | |
| drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void
このスキンの Graphics オブジェクトに、プログラムで矩形を描画します。
| UIComponent | |
| effectFinished(effectInst:EffectInstance):void
コンポーネントでの再生の停止時にエフェクトインスタンスによって呼び出されます。
| UIComponent | |
| effectStarted(effectInst:EffectInstance):void
コンポーネントでの再生の開始時にエフェクトインスタンスによって呼び出されます。
| UIComponent | |
| endEffectsStarted():void
現在コンポーネントで再生中のすべてのエフェクトを終了します。
| UIComponent | |
| executeBindings(recurse:Boolean = false):void
この UIComponent オブジェクトへのデータバインディングを実行します。
| UIComponent | |
| finishPrint(obj:Object, target:IFlexDisplayObject):void
印刷の完了後に呼び出されます。
| UIComponent | |
| getBounds(targetCoordinateSpace:DisplayObject):Rectangle
targetCoordinateSpace オブジェクトの座標系を基準にして、表示オブジェクトの領域を定義する矩形を返します。 | DisplayObject | |
| getChildAt(index:int):DisplayObject
指定のインデックス位置にある子表示オブジェクトインスタンスを返します。
| DisplayObjectContainer | |
| getChildByName(name:String):DisplayObject
指定された名前に一致する子表示オブジェクトを返します。
| DisplayObjectContainer | |
| getChildIndex(child:DisplayObject):int
child DisplayObject インスタンスのインデックス位置を返します。 | DisplayObjectContainer | |
| getClassStyleDeclarations():Array
この UIComponent インスタンスのタイプセレクタを探します。
| UIComponent | |
| getExplicitOrMeasuredHeight():Number
明示された高さを使用するのか、それとも測定した高さを使用するのかを決定する便利なメソッドです。
| UIComponent | |
| getExplicitOrMeasuredWidth():Number
明示的な幅または測定幅を使用するかどうかを決定するための便利なメソッドです。
| UIComponent | |
| getFocus():InteractiveObject
現在フォーカスを持っているオブジェクトを取得します。
| UIComponent | |
| getLineMetrics(lineIndex:int):TextLineMetrics
コントロール内のテキスト行のテキストの位置と測定に関する情報を持つ TextLineMetrics オブジェクトを返します。
| Label | |
| getObjectsUnderPoint(point:Point):Array
指定されたポイントの下にあり、この DisplayObjectContainer インスタンスの子または孫などであるオブジェクトの配列を返します。
| DisplayObjectContainer | |
| getRect(targetCoordinateSpace:DisplayObject):Rectangle
シェイプ上の線を除き、
targetCoordinateSpace パラメータによって定義された座標系に基づいて、表示オブジェクトの境界を定義する矩形を返します。 | DisplayObject | |
| getRepeaterItem(whichRepeater:int = -1):Object
指定された Repeater がこの Repeater を生成するために使用した
dataProvider 内のアイテムを返します。この Repeater が繰り返されていない場合は、null を返します。 | UIComponent | |
| getStyle(styleProp:String):*
このコンポーネントのスタイル参照チェーンのいずれかの場所に設定されたスタイルプロパティを取得します。
| UIComponent | |
| globalToContent(point:Point):Point
Point オブジェクトをグローバル座標からコンテンツ座標に変換します。 | UIComponent | |
| globalToLocal(point:Point):Point
point オブジェクトをステージ (グローバル) 座標から表示オブジェクトの (ローカル) 座標に変換します。 | DisplayObject | |
| hasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
| EventDispatcher | |
| hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
| Object | |
| hitTestObject(obj:DisplayObject):Boolean
表示オブジェクトを評価して、
obj 表示オブジェクトと重複または交差するかどうかを調べます。 | DisplayObject | |
| hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
表示オブジェクトを評価して、
x および y パラメータで指定されたポイントと重複または交差するかどうかを調べます。 | DisplayObject | |
| horizontalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix
水平方向のグラデーションを描画するときに
rot パラメータとして drawRoundRect() メソッドに渡すことのできるボックスの Matrix を返します。 | UIComponent | |
| initialize():void
このコンポーネントの内部構造を初期化します。
| UIComponent | |
| initializeRepeaterArrays(parent:IRepeaterClient):void
このコンポーネントの繰り返されるインスタンスを追跡する各種プロパティを初期化します。
| UIComponent | |
| invalidateDisplayList():void
次に画面が更新されている間に
updateDisplayList() メソッドが呼び出されるように、コンポーネントをマークします。 | UIComponent | |
| invalidateProperties():void
次に画面が更新されている間に
commitProperties() メソッドが呼び出されるように、コンポーネントをマークします。 | UIComponent | |
| invalidateSize():void
次に画面が更新されている間に
measure() メソッドが呼び出されるように、コンポーネントをマークします。 | UIComponent | |
| isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
| Object | |
| localToContent(point:Point):Point
Point オブジェクトをローカル座標からコンテンツ座標に変換します。 | UIComponent | |
| localToGlobal(point:Point):Point
point オブジェクトを表示オブジェクトの (ローカル) 座標からステージ (グローバル) 座標に変換します。 | DisplayObject | |
| measureHTMLText(htmlText:String):TextLineMetrics
この UIComponent のスタイルで決定される UITextFormat を使用して単一行の UITextField に表示するものとして、
<font> や <b> のような HTML タグが含まれる指定の HTML テキストを測定します。 | UIComponent | |
| measureText(text:String):TextLineMetrics
この UIComponent のスタイルで決定される UITextFormat を使用して単一行の UITextField に表示するものとして、指定のテキストを測定します。
| UIComponent | |
| move(x:Number, y:Number):void
親の内部の指定された位置にコンポーネントを移動します。
| UIComponent | |
| notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void
スタイルの変更を子に通知します。
| UIComponent | |
| owns(child:DisplayObject):Boolean
owner プロパティのチェーンが child からこの UIComponent を指定している場合に、true を返します。 | UIComponent | |
| parentChanged(p:DisplayObjectContainer):void
UIComponent オブジェクトを親に対して追加または削除したときに Flex によって呼び出されます。
| UIComponent | |
| prepareToPrint(target:IFlexDisplayObject):Object
印刷用の IFlexDisplayObject を準備します。
| UIComponent | |
| propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙可能かどうかを示します。
| Object | |
| regenerateStyleCache(recursive:Boolean):void
このコンポーネントの CSS スタイルキャッシュを作成または再作成します。
recursive パラメータが true の場合は、このコンポーネントのすべての子孫の CSS スタイルキャッシュも作成または再作成します。 | UIComponent | |
| registerEffects(effects:Array):void
各エフェクトイベントについて、EffectManager をイベントリスナーの 1 つとして登録します。
| UIComponent | |
| removeChild(child:DisplayObject):DisplayObject
DisplayObjectContainer インスタンスの子リストから指定の
child DisplayObject インスタンスを削除します。 | DisplayObjectContainer | |
| removeChildAt(index:int):DisplayObject
DisplayObjectContainer の子リストの指定された
index 位置から子 DisplayObject を削除します。 | DisplayObjectContainer | |
| removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
| EventDispatcher | |
| resumeBackgroundProcessing():void
[static]
suspendBackgroundProcessing() が呼び出された後、callLater() によってキューに入れられたメソッドのバックグラウンド処理を再開します。 | UIComponent | |
| setActualSize(w:Number, h:Number):void
オブジェクトのサイズを設定します。
| UIComponent | |
| setChildIndex(child:DisplayObject, index:int):void
表示オブジェクトコンテナの既存の子の位置を変更します。
| DisplayObjectContainer | |
| setCurrentState(stateName:String, playTransition:Boolean = true):void
現在の状態を設定します。
| UIComponent | |
| setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
| Object | |
| setStyle(styleProp:String, newValue:*):void
このコンポーネントインスタンスのスタイルプロパティを設定します。
| UIComponent | |
| setVisible(value:Boolean, noEvent:Boolean = false):void
visible プロパティが変更されたときに呼び出されます。 | UIComponent | |
| startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
指定されたスプライトをユーザーがドラッグできるようにします。
| Sprite | |
| stopDrag():void
startDrag() メソッドを終了します。 | Sprite | |
| styleChanged(styleProp:String):void
スタイルプロパティの変更を検出します。
| UIComponent | |
| stylesInitialized():void
コンポーネントのスタイルを初めて初期化するとき、Flex は
stylesInitialized() メソッドを呼び出します。 | UIComponent | |
| suspendBackgroundProcessing():void
[static]
resumeBackgroundProcessing() が呼び出されるまで、callLater() によってキューに入れられたメソッドのバックグラウンド処理をブロックします。 | UIComponent | |
| swapChildren(child1:DisplayObject, child2:DisplayObject):void
指定された 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。
| DisplayObjectContainer | |
| swapChildrenAt(index1:int, index2:int):void
子リスト内の指定されたインデックス位置に該当する 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。
| DisplayObjectContainer | |
| toString():String
アプリケーションの DisplayObject の階層内部でのこのオブジェクトの位置を示すストリングを返します。
| FlexSprite | |
| validateDisplayList():void
子の位置とサイズを検証し、その他のビジュアルオブジェクトを描画します。
| UIComponent | |
| validateNow():void
必要に応じて、このオブジェクトのプロパティとレイアウトを検証および更新し、それを再描画します。
| UIComponent | |
| validateProperties():void
commitProperties() メソッドを呼び出してコンポーネントのプロパティを検証するためにレイアウトロジックによって使用されます。 | UIComponent | |
| validateSize(recursive:Boolean = false):void
コンポーネントの測定サイズを検証します。
LayoutManager.invalidateSize() メソッドがこの ILayoutManagerClient を指定して呼び出された場合、測定の実行時に validateSize() メソッドが呼び出されます。 | UIComponent | |
| validationResultHandler(event:ValidationResultEvent):void
このコンポーネントに割り当てられたバリデータからの
valid と invalid の両方のイベントを処理します。 | UIComponent | |
| valueOf():Object
指定されたオブジェクトのプリミティブ値を返します。
| Object | |
| verticalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix
垂直方向のグラデーションを描画するときに
rot パラメータとして drawRoundRect() メソッドに渡すことのできるボックスの Matrix を返します。 | UIComponent | |
| willTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
| EventDispatcher | |
| Text | () | コンストラクタ |
MXML シンタックスの表示public 関数 Text()コンストラクタ。
<?xml version="1.0"?>
<!-- Simple example to demonstrate the Text control. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
<mx:Panel title="Text Control Example" height="75%" width="75%"
paddingTop="10" paddingLeft="10" paddingRight="10">
<mx:Text width="100%">
<mx:text>
This is a multiline, non-editable text component.
If you need an editable multiline component, use TextArea.
</mx:text>
</mx:Text>
<mx:Text width="100%">
<mx:htmlText>
<![CDATA[This is <font color="#FF0000">HTML text</font> in a <b>Text component</b>. Using the <u>htmlText attribute</u> of the <font color="#008800">Text component</font> you can use basic HTML markup.]]>
</mx:htmlText>
</mx:Text>
</mx:Panel>
</mx:Application>