HTML テキストの Label コントロールから余分な空白文字 (スペースや改行など) を削除するかどうかを指定します。

condenseWhite プロパティは、text プロパティではなく htmlText プロパティで設定されたテキストにのみ影響します。text プロパティでテキストを設定した場合、condenseWhite は無視されます。

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

デフォルト値false;.

このプロパティはデータバインディングのソースとして使用できます。

アイテムレンダラーまたはアイテムエディタでコンポーネントを使用するときに、コンポーネントに値を渡すことができます。通常、データバインディングを使用して、data プロパティのフィールドをこのコンポーネントのプロパティにバインドします。

ドロップインアイテムレンダラーまたはドロップインアイテムエディタとしてコントロールを使用すると、アイテムの現在の値が、このコントロールの text プロパティに自動的に書き込まれます。

MXML でこのプロパティを設定することはありません。

デフォルト値null.

このプロパティはデータバインディングのソースとして使用できます。

関連項目

Label コントロールによって表示されるテキストを指定します。テキストのスタイルを表す HTML マークアップも一緒に指定します。このプロパティで HTML テキストを指定する場合は、Flash TextField コントロールでサポートされている HTML タグのサブセットを使用できます。

このプロパティを設定すると、Label インスタンスに CSS スタイルが適用された後に HTML マークアップが適用されます。このプロパティを取得すると、HTML マークアップに CSS スタイルが含まれます。

たとえば、"This is an example of <b>bold</b> markup",という文字列を設定した場合、Label には、通常適用される CSS スタイルが適用された 「This is an example of bold markup」というテキストが表示されます。また、<b> マークアップによって、"bold" という単語がボールド体のフォントで表示されます。

HTML マークアップでは、< や > などの文字を使用します。これらの文字は、XML では特別な意味を持っています (MXML でも同じです) 。したがって、次のようなコードはコンパイルされません。

<mx:Label htmlText="This is an example of <b>bold</b> markup"/>
   

この問題を回避するには、3 つの方法があります。

• initialize ハンドラとして呼び出される ActionScript メソッドの htmlText プロパティを設定します。

  <mx:Label id="myLabel" initialize="myLabel_initialize()"/>
     

  myLabel_initialize メソッドは、スクリプトの CDATA セクションに指定します。

  <mx:Script>
  <![CDATA[
  private function myLabel_initialize():void {
  myLabel.htmlText = "This is an example of <b>bold</b> markup";
     }
     ]]>
  </mx:Script>
     
     

  HTML マークアップの読みやすさが保たれるので、これが最も単純な方法です。initialize ハンドラでラベルを参照できるようにするには、ラベルに id を割り当てる必要があります。

• CDATA セクションで子タグを使用して、htmlText プロパティを指定します。XML の CDATA セクションには、< や > などの文字が特別な意味を持たない文字データが含まれます。

  <mx:Label>
  <mx:htmlText><![CDATA[これは <b>bold</b> マークアップのサンプルです]]></mx:htmlText>
  <mx:Label/>
     

  <mx:Label> タグでは、属性ではなく子タグとして htmlText プロパティを記述する必要があります。XML では属性の値に CDATA を使用できないためです。マークアップは読み取れますが、CDATA セクションではこの方法は複雑になります。

• 属性値内の HTML マークアップ文字 < と > が書き込まれるところで、XML エンティティの < と > として hmtlText 属性を代わりに使用します。

  <mx:Label htmlText="This is an example of &lt;b&gt;bold&lt;/b&gt; markup"/&gt;
     

  HTML マークアップの読み取りがほとんど不可能になるので、この方法はお勧めしません。

htmlText プロパティが設定されているときに condenseWhite プロパティが true の場合、複数の空白文字は、HTML 対応ブラウザと同じように圧縮されます。たとえば、3 つの連続するスペースは、1 つのスペースとして表示されます。condenseWhite の既定値は false なので、空白文字を圧縮するには condenseWhite を true に設定する必要があります。

htmlText プロパティの設定直後にそれを読み込んだ場合は、設定したものと同じストリングが取得されます。ただし、LayoutManager の実行後には、値は変更され、CSS スタイルを含むマークアップが追加されます。

htmlText プロパティの設定は、さまざまな方法で text プロパティに影響を与えます。htmlText プロパティの設定直後に text プロパティを読み込んだ場合は null が取得されます。これは、新しい htmlText に対応する text がまだ決定されていないことを示します。ただし、LayoutManager の実行後には、text プロパティの値はすべての HTML マークアップが削除された htmlText 文字列に変更されます。つまり、値は、Label が実際に表示する文字になります。

逆に、text 設定すると、前に設定された htmlText プロパティが適切でなくなります。text プロパティの設定直後に htmlText プロパティを読み込んだ場合は null が取得されます。これは、新しい text に対応する htmlText がまだ決定されていないことを示します。ただし、LayoutManager の実行後には、htmlText プロパティの値は変更され、新しいテキストに CSS スタイル用の HTML マークアップが追加されたものになります。

LayoutManager を直ちに実行させるには、Label で validateNow() メソッドを呼び出します。たとえば、何らかの htmlText を設定した後、すぐにvalidateNow() メソッドを呼び出すと、HTML マークアップを含まない対応する text を直ちに取得できます。

ActionScript の中に text プロパティと htmlText プロパティの両方を設定した場合は、最後に設定されたプロパティが有効になります。MXML では両方設定しないでください。これは、MXML ではインスタンスのプロパティの取得を特定の順序で設定することが保証されていないためです。

text プロパティまたは htmlText プロパティをループの中に設定すると処理が高速になります。これは、テキストを実際に表示する TextField が、LayoutManager が実行されるまでは更新されないためです。

このプロパティを null に設定しようとした場合は、代わりに空のストリングに設定されます。このプロパティの値が一時的に null になった場合、text が設定されたばかりで、対応する htmlText がまだ認識されていないことを意味します。

デフォルト値"".

このプロパティはデータバインディングのソースとして使用できます。

関連項目

ドロップインアイテムレンダラーまたはドロップインアイテムエディタとして使用すると、このコンポーネントの listData プロパティが、List コントロールからの該当するデータで初期化されます。その後、コンポーネントでこの listData プロパティを使用して、ドロップインアイテムレンダラーまたはドロップインアイテムエディタの data プロパティを初期化できます。

MXML および ActionScript でこのプロパティを設定することはありません。このコンポーネントがドロップインアイテムレンダラーまたはドロップインアイテムエディタとして使用されるときに、Flex でプロパティが設定されます。

デフォルト値null.

このプロパティはデータバインディングのソースとして使用できます。

関連項目

テキストが選択可能であるかどうかを指定します。テキストを選択可能にすると、コントロールからテキストをコピーできます。

デフォルト値false;.

このコントロールで表示されるプレーンテキストです。その外観は、この Label コントロールの CSS スタイルによって決定されます。

このプロパティを設定すると、ストリングで HTML マークアップのように見える文字が特殊な意味を持たなくなり、単に入力されたとおりの文字として表示されます。

HTML タグを使用してフォーマットされたテキストを表示するには、htmlText プロパティを使用します。htmlText プロパティを設定している場合は、その HTML で、設定されたテキストが置き換えられ、text プロパティは、HTML テキストから HTML タグを除いたプレーンテキストを返します。

特殊文字である左山括弧 (<)、右山括弧 (>)、アンパサンド (&) をテキストに含める場合は、CDATA タグでテキストストリングを囲む必要があります。特殊文字の代わりに、< などの HTML 文字エンティティを使用できます。

Label コントロールよりテキストの幅の方が大きい場合、テキストは省略記号 (...) で切り詰められ、最後まで表示されません。マウスを Label コントロール上に移動すると、テキスト全体がツールヒントとして表示されます。tooltip プロパティを使用してツールヒントを設定している場合は、テキストではなくツールヒントが表示されます。

このプロパティを null に設定しようとした場合は、代わりに空のストリングに設定されます。text プロパティには、値 null を一時的に設定できます。これは、htmlText が最近設定され、対応する text 値がまだ決定されていないことを示します。

デフォルト値"".

このプロパティはデータバインディングのソースとして使用できます。

この Label のテキストを表示するための内部 UITextField です。

テキストの高さです。

textHeight プロパティの値は、コンポーネントが検証された後でのみ正しい値になります。text を設定し、その直後に textHeight を取得した場合は、間違った値を受け取る可能性があります。コンポーネントが検証されるまで待つか、値を取得する前に validateNow() メソッドを呼び出します。この動作は、値をただちに更新する flash.text.TextField コントロールの動作とは異なります。

関連項目

テキストの幅です。

textWidth プロパティの値は、コンポーネントが検証された後でのみ正しい値になります。text を設定し、その直後に textWidth を取得した場合は、間違った値を受け取る可能性があります。コンポーネントが検証されるまで待つか、値を取得する前に validateNow() メソッドを呼び出します。この動作は、値をただちに更新する flash.text.TextField コントロールの動作とは異なります。

関連項目

このプロパティが true のときに Label コントロールのサイズがテキストよりも小さい場合、Label コントロールのテキストは切り捨てられ、"..." などのローカライズ可能文字列が使用されます。このプロパティが false の場合、コントロールに収まらないテキストは切り捨てられます。

デフォルト値true.

コンストラクタ。

コントロール内のテキスト行のテキストの位置と測定に関する情報を持つ TextLineMetrics オブジェクトを返します。正しい数値を取得するには、コンポーネントを検証する必要があります。text を設定し、その直後に getLineMetrics() を呼び出した場合は、間違った値を受け取る可能性があります。コンポーネントが検証されるまで待つか、validateNow() を呼び出します。この動作は、値をただちに更新する flash.text.TextField クラスの動作とは異なります。

関連項目

data プロパティが変更されたときに送出されます。

コンポーネントをアイテムレンダラーとして使う場合、data プロパティは表示するデータを保持します。このイベントを受け取って、data プロパティが変更されたときにコンポーネントを更新することができます。

FlexEvent.DATA_CHANGE 定数により、dataChange イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。