Label コントロールは、編集できない単一行のテキストラベルです。次のような特性があります。

• ユーザーはテキストを変更できませんが、アプリケーションからテキストを修正することはできます。
• スタイルまたは HTML テキストを使用すると、テキストのフォーマットを指定できます。
• 整列とサイズ変更を制御できます。
• このコントロールは透明で backgroundColor プロパティを持たないため、コンポーネントのコンテナの背景は見えています。
• コントロールには境界線がありません。そのため、ラベルは背景に直接書き込まれたテキストのように表示されます。
• このコントロールはフォーカスを取得できません。

詳細については、『Adobe Flex リファレンスガイド』を参照してください。

編集することのできない、複数行から成るテキストフィールドを作成する場合は、Text コントロールを使用します。詳細については、Text コントロールを参照してください。ユーザーが編集可能なテキストフィールドを作成するには、TextInput または TextArea コントロールを使用します。詳細については、TextInput コントロールおよびTextArea コントロールを参照してください。

次の図に Label コントロールの例を示します。

このサンプルを作成するためのコードの詳細については、Label コントロールの作成を参照してください。

Label コントロールの作成

Label コントロールは、次の例に示すように、<mx:Label> タグを使用して MXML 内で定義します。MXML の他の場所（別のタグまたは ActionScript ブロック）のコンポーネントを参照する場合は、id 値を指定します。

<?xml version="1.0"?>
<!-- textcontrols/LabelControl.mxml -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" 
    width="150" height="80" 
    borderStyle="solid" 
    backgroundGradientColors="[#FFFFFF, #FFFFFF]">

  <mx:Label text="Label1"/>
</mx:Application>
前の例で実行する SWF ファイルは以下のとおりです。

純粋なテキストだけのストリングを指定する場合は text プロパティを使用し、HTML 形式のストリングを指定する場合は htmlText プロパティを使用します。これらのプロパティの使用の詳細については、text プロパティの使用およびhtmlText プロパティの使用を参照してください。

Label コントロールのサイズ設定

幅を指定しない場合、text または htmlText プロパティの値を変更すると、Label コントロールのサイズは自動的に変更されます。

Label コントロールのサイズを明示的に指定したときに、そのサイズが小さすぎてテキスト全体を表示できない場合は、省略記号（...）によってテキストが途中で切り捨てられます。マウスを Label コントロール上に移動すると、テキスト全体がツールヒントとして表示されます。tooltip プロパティを使用してツールヒントを設定した場合も、テキストでなくツールヒントが表示されます。