ASDoc

mx.controls
Label クラス

直接の既知のサブクラス
mx.controls.FormItemLabel, mx.controls.Text, mx.controls.sliderclasses.SliderLabel

Label クラス
mx.core.UIObject の拡張

Label コントロールは編集不可能な単一行のテキストフィールドです。複数行にわたる編集不可能なテキストの大きなブロックを作成するには、Text コントロールを使用します。ラベルは HTML でフォーマットするように設定できます。また、ラベルの行揃えやサイズも制御できます。

Label コントロールは境界線を持たず、フォーカスを取得できません。他のコントロールとは異なり、Label コントロールでは、UIComponent ではなく UIObject クラスを直接継承しています。

MXML シンタックス

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

 <mx:Label
   htmlText="No default."
   text="No default."
   disabledColor="0x848384"
   hide="Event handler; no default."
   show="Event handler; no default."
 />

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

関連項目
    Text
    TextInput
    TextArea

メソッド

プロパティ
	`className:String`このクラスの名前です。
	`htmlText:String`HTML 形式のテキストを含みます。
	`text:String`コントロールに表示されるテキストストリングです。
`static`	`version:String`このクラスのバージョンを表すストリングです。

エフェクト

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

creationCompleteEffect   hideEffect   mouseDownEffect   mouseOutEffect   mouseOverEffect   mouseUpEffect   moveEffect   resizeEffect   showEffect

イベント
`hide`	オブジェクトの状態が可視から不可視に変化したときにブロードキャストします。このイベントオブジェクトの `target` プロパティには、イベントをトリガしたコンポーネントへの参照が含まれます。 `type` プロパティには、イベントの名前 `hide` が含まれます。
`show`	コンポーネントが表示されたときにブロードキャストします。このイベントオブジェクトの `target` プロパティには、イベントをトリガしたコンポーネントへの参照が含まれます。 `type` プロパティには、イベントの名前 `show` が含まれます。

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 の継承 : あり`無効を示すテキストの色です。デフォルト値は 0x848384 です。

mx.core.UIObject クラスから継承されるスタイル

color   fontFamily   fontSize   fontStyle   fontWeight   horizontalGap   leading   marginLeft   marginRight   textAlign   textDecoration   textIndent   verticalGap

プロパティの詳細

className

className:String

このクラスの名前です。

htmlText

htmlText:String

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

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

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

テキスト

text:String

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

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

version

static version:String

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

例

LabelExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<mx:Application xmlns:mx="http://www.macromedia.com/2003/mxml" backgroundColor="#FFFFFF">

<!-- Label コントロールの使用方法を示す簡単な例 -->
<mx:Script>
<![CDATA[
      
var htmlData= "<br>Label's htmlText property contains HTML-formatted text."+ newline + 
" If your text string contains" + newline +
" HTML tags, you must wrap it in the CDATA tag."+ newline + 
" The control  collapses any white space characters, such as tab" + newline + 
" and  newline characters.For the special characters left  angle bracket (<), " + newline +
" right angle bracket (>),  or ampersand (&), " + newline +
" insert the HTML equivalents of  <CODE>&lt;</CODE>, <CODE>&gt;" + newline +
" </CODE>, and <CODE>&amp;</CODE>.  <br> "+ newline +
" <p><b>Note</b>:The <CODE>htmlText</CODE> property ignore CSS style settings for the control, " + newline +
" and instead rely on the HTML tags in the string for formatting."+ newline +
" </p>  ";
                                         
function displayDetails()
          {
simpleLabel.text="";
simpleLabel.htmlText= htmlData;
          }
          
function clearArea()
          {
simpleLabel.text="This Label displays Html Text";
          }      
   
   ]]>
</mx:Script>

<mx:Panel title="Label Panel" width="640" height="250">
    
<mx:Label id="simpleLabel" text="This Label displays Html Text"/>
<mx:Button id="Display" label="Click to diplay Label's Html Text" click="displayDetails();"/>
<mx:Button id="Clear" label="Clear htmlText" click="clearArea();"/>
  
</mx:Panel>

</mx:Application>

mx.controls Label クラス

className

htmlText

テキスト

version

mx.controls
Label クラス