注意：このクラスは今後のリリースで削除される可能性があります。

Spark テーマのスキンは RichEditableText クラスを使用します。つまり、Spark の TextArea コントロールは、Flash Text Engine（FTE）上に構築される Text Layout Framework（TLF）ライブラリをサポートしています。これらのレイヤーを組み合わせることにより、国際化対応の高品質な文字体裁とレイアウト機能を備えたテキスト編集が可能になります。このスキンには、テキストをスクロールするための水平方向と垂直方向のスクロールバーを表示し、マウスホイールによる垂直スクロールをサポートするスクローラーが含まれています。RichEditableText には textDisplay としてアクセスでき、Scroller には scroller としてアクセスできます。

モバイルテーマのスキンは StyleableStageText クラスを使用します。 StyleableStageText はネイティブテキストフィールドを使用するので、モバイルデバイス上のテキストの入力および操作がしやすくなりますが、いくつかの制限および相違を考慮する必要があります。 StageText にはテキスト測定機能がないので、TextArea に、パーセントベースまたは制約ベースの width および height を明示的に指定する必要があります。StyleableStageText には textDisplay としてアクセスできます。 StageText ベースではなく TextField ベースのスキンを使用する場合は、skinClass プロパティを「spark.skins.mobile.TextAreaSkin」に設定します。

text プロパティを使用すると、表示するテキストを設定したり、ユーザーが入力したテキストを取得したりできます。

テキストのフォーマットは、fontFamily や fontSize などの CSS スタイルを使用して設定されます。

Spark テーマの場合は、widthInChars および heightInLines プロパティで、フォントサイズに合わせて拡大 / 縮小するように TextArea の幅および高さを指定するか、typicalText プロパティを使用できます。typicalText を使用する場合、widthInChars および heightInLines プロパティは無視されることに注意してください。 また、すべてのテーマで、幅や高さを明示的にピクセル単位で指定したり、パーセントで指定したり、left と right や top と bottom などの制約を使用することもできます。

maxChars プロパティを使用して、ユーザーが入力できる文字数を制限したり、restrict を使用して、ユーザーが入力できる文字を制限したりすることもできます。パスワード入力用にこのコントロールを使用するには、displayAsPassword プロパティを true に設定します。

モバイルテーマの場合、ソフトキーボード固有のプロパティである、autoCapitalize、autoCorrect、returnKeyLabel および softKeyboardType プロパティでキーボードヒントを指定します。 ソフトキーボードは存在するが、ヒントで表される機能をサポートしない場合は、ヒントが無視されます。ハードウェアキーボードのみのモバイル環境では、これらのヒントが無視されます。

Spark テーマのテキスト領域

Spark の TextArea と MX の TextArea コントロールの最も重要な違いは、次のとおりです。

• Spark の TextArea では、文字体裁、国際言語のサポート、およびテキストレイアウトの機能が向上しています。
• Spark の TextArea にはリッチテキストのオブジェクト指向モデルがありますが、MX 版にはありません。
• Spark の TextArea では、大量のテキストを表示する機能が強化されています。
• Spark の TextArea では、MX 版とは異なる方法でフォントを埋め込む必要があります。フォントを埋め込む際に embedAsCFF 属性を使用する方法については、フォントのマニュアルを参照してください。

Spark の TextArea コンロールでは、リッチテキストの TLF オブジェクト指向モデルが使用されます。このモデルでは、区分、段落、スパン、ハイパーリンク、画像などのテキストレイアウト要素が ActionScript オブジェクトによって実行時に表現されます。これらのオブジェクトは、プログラムを通じてアクセスして操作できます。リッチテキストを表す TLF の中心的なオブジェクトは TextFlow です。TextArea コントロールに対してリッチテキストを指定するには、コントロールの textFlow プロパティを TextFlow インスタンスに設定します。

複数のフォーマットが混在するテキストを表示する必要がない場合は、TextArea の text プロパティをプレーンテキスト文字列に設定します。text プロパティと textFlow プロパティの相互作用（例えば、一方を設定して他方を取得する方法など）について詳しくは、各プロパティの説明を参照してください。

次の例に示すように、コンパイル時に、TLF マークアップタグを TextArea タグ内に配置できます。

  <s:TextArea>Hello <s:span fontWeight="bold">World!</s:span></s:TextArea>
  

TextArea コントロールには、テキストのフォーマットを変更するためのユーザーインターフェイスはありませんが、プログラムを通じてテキストをフォーマットするために使用できる API が含まれています。例えば、クリックすると、選択したテキストが太字になるようなボタンを作成できます。

デフォルトのテキストフォーマットは、fontFamily や fontSize などの CSS スタイルによって決定されます。TextFlow オブジェクトでフォーマット情報が指定されている場合は、CSS スタイルで指定されているデフォルトのフォーマットがオーバーライドされます。

TextArea コンテンツの特性には、スタイルを使用して制御できるものが数多くあります。次に一般的な特性の一部を示します。

• 行の間隔は lineHeight スタイルを使用して制御します。
• 段落の間隔は paragraphSpaceBefore スタイルと paragraphSpaceAfter スタイルを使用して制御します。
• テキストの整列や均等割り付けには、textAlign スタイルと textAlignLast スタイルを使用します。
• コントロールの境界線からテキストまでのインセットを指定するには、paddingLeft、paddingTop、paddingRight、および paddingBottom スタイルを使用します。

デフォルトでは、コントロールの右端でテキストが折り返されます。テキストの量が TextArea に収まりきらない場合は、垂直スクロールバーが自動的に表示されます。lineBreak スタイルを explicit に設定すると、明示的に改行が指定されている位置でのみ行が折り返されます。これには、CR（¥r）、LF（¥n）または CR+LF（¥r¥n）を text で使用した場合、または <p> と <br/> を TLF マークアップで使用した場合と同じ効果があります。これらの場合、コントロールの幅を超えるテキスト行があるときは、水平スクロールバーが自動的に表示されます。

Spark の TextArea では、フランス語のように左から右（LTR）に読まれるテキスト、アラビア語のように右から左（RTL）に読まれるテキスト、またはフランス語のフレーズを含むアラビア語のように双方向から読まれるテキストを表示できます。主に右から左へのテキストを使用する場合は、direction スタイルを rtl に設定します。textAlign スタイルのデフォルト設定は start です。この設定では、direction が ltr の場合にテキストが左揃えになり、direction が rtl の場合に右揃えになります。反対に整列するには、textAlign を end に設定します。

Spark の TextArea では、1 回の編集セッション内で取り消し / やり直し操作を何度でも実行できます。編集セッションは、コントロールがキーボードフォーカスを取得したときに開始され、コントロールがフォーカスを失ったときに終了します。

List や DataGrid などのリストベースのコンポーネントでこのコンポーネントを使用するには、アイテムレンダラーを作成します。アイテムレンダラーの作成について詳しくは、「Custom Spark item renderers」を参照してください。

Spark テーマの場合、TextArea コントロールには、次のデフォルトの特性があります。

Mobile テーマの場合、TextArea コントロールには、次のデフォルトの特性があります。

Grid コンポーネントは、DataGrid のスキンパーツまたはその他のカスタム複合コンポーネントのエレメントとして使用されるように意図されています。そのため、スキナブルではなく、スクローラーやスクロールバーもなく、マウスやキーボードのイベントのデフォルト処理も用意されていません。

表示可能な Grid の各セルは itemRenderer プロパティを使用して作成される GridItemRenderer インスタンスによって表示されます。各列のアイテムレンダラーを指定します。各アイテムレンダラーは、表示され前に、その行のデータプロバイダーアイテムの値で設定されます。アイテムレンダラーは必要に応じて作成されるので、作成オーバーヘッドを最小限に抑えるために、プールとリサイクルが行われます。

Grid コントロールは、selectionMode プロパティに従って、選択をサポートします。選択された行インデックスやセルインデックスのセットは、setSelectedIndex や selectionContainsIndex() のような選択メソッドを使用してプログラムで変更または照会できます。

Grid コントロールは、selectionMode プロパティおよび hoverRowIndex や columnRowIndex などの対応する行インデックスや列インデックスのプロパティに基づいて、ホバー、キャレットおよび選択範囲のインジケーターを表示します。 インジケーターには、任意のビジュアルエレメントを使用できます。IGridVisualElement を実装するインジケーターは、自分が使用されている行や列に応じて、自分を設定できます。

Grid コントロールでは、スムーズスクロールがサポートされます。垂直方向と水平方向のスクロール位置によって、グリッドの表示部分のピクセル原点が定義され、グリッドのレイアウトには、使用可能なスペースを埋めるのに必要な数のセルアイテムレンダラーのみが表示されます。

Grid コントロールでは、アイテムレンダラーのコンテンツに基づいて、自身の高さを自動的に計算して高さが変化する行がサポートされます。 このサポートは、グリッドの仮想化と呼ばれます。これは（ピクセルの）スクロール位置から行インデックスと列インデックスへのマッピングが、通常はグリッドセルの推奨サイズに関する不完全な情報に基づいているためです。Grid では、ビューにスクロールされた行の高さの計算結果がキャッシュされ、1 つの typicalItem に基づいて残りが推測されます。

DataGrid アイテムレンダラーのトランジションがサポートされていません。 GridItemRenderer クラスの transitions プロパティが無効化されているので、設定しても無視されます。

Application コンテナには、次のデフォルトの特性があります。

通常、ボタンはイベントリスナーを使用して、ユーザーがコントロールを選択したときのアクションを実行します。Button コントロールのマウスをクリックしたときに Button コントロールが有効である場合は、click イベントと buttonDown イベントが送出されます。 ボタンは、有効か無効かにかかわらず、mouseMove、mouseOver、mouseOut、rollOver、rollOut、mouseDown、mouseUp などのイベントを必ず送出します。

List や DataGrid などのリストベースのコンポーネントでこのコンポーネントを使用するには、アイテムレンダラーを作成します。アイテムレンダラーの作成について詳しくは、「Custom Spark item renderers」を参照してください。

Button コントロールには、次のデフォルトの特性があります。

ユーザーが CheckBox コンポーネントまたはそれに関連付けられたテキストをクリックすると、CheckBox コンポーネントの selected プロパティが、チェックマークありの場合は true に、チェックマークなしの場合は false に設定されます。

List や DataGrid などのリストベースのコンポーネントでこのコンポーネントを使用するには、アイテムレンダラーを作成します。アイテムレンダラーの作成について詳しくは、「Custom Spark item renderers」を参照してください。

CheckBox コントロールには、次のデフォルトの特性があります。

パフォーマンスを向上させると共にアプリケーションのサイズを最小限に抑えるため、Group コンテナにはスキンを適用できません。スキンを適用するには、代わりに SkinnableContainer を使用します。

メモ：コンポーネントや別の Group など、Group の内部に DisplayObject の子がある場合、スケールグリッドが正しく機能しないことがあります。子が GraphicElement オブジェクトで、それらすべてが Group の DisplayObject を共有する場合、スケールグリッドは正しく機能します。

子の GraphicElement で次のいずれかのプロパティを設定すると、GraphicElement は独自の DisplayObject を作成する必要があり、したがって Group でのスケールグリッドプロパティは否定されます。

  alpha
  blendMode other than BlendMode.NORMAL or "auto"
  colorTransform
  filters
  mask
  matrix
  rotation
  scaling
  3D properties
  bounds outside the extent of the Group
  

Group コンテナには、次のデフォルトの特性があります。

Spark テーマの TextInput スキンは RichEditableText クラスを使用します。つまり、Spark の TextInput コントロールは、Flash Text Engine（FTE）上に構築される Text Layout Framework（TLF）ライブラリをサポートしています。これらのレイヤーを組み合わせることにより、国際化対応の高品質な文字体裁とレイアウト機能を備えたテキスト編集が可能になります。

モバイルテーマの TextInput スキンは、RichEditableText ではなく StyleableStageText クラスを使用します。 StyleableStageText はネイティブテキストフィールドを使用するので、モバイルデバイス上のテキストの入力および操作がしやすくなりますが、考慮すべき制限および相違があります。 StageText が使用するネイティブテキストコントロールは、テキストの周りに様々なパディングを適用します。 垂直スクロールを回避するために、StageText ベースの TextInput スキンは、このパディングを予測して補正しようとします。 ネイティブテキストコントロールがテキストを処理する方法が、この点および他の点で異なるために、StageText ベースのスキンを使用した TextInput コントロールのデフォルトの高さは、TextField ベースの TextInput スキンを使用した場合のデフォルトの高さとは異なります。

text プロパティを使用すると、表示するテキストを設定したり、ユーザーが入力したテキストを取得したりできます。このプロパティは String なので、ユーザーが 123.45 のような数値を入力した場合は "123.45" として扱われます。

テキストのフォーマットは、fontFamily や fontSize などの CSS スタイルを使用して設定されます。

Spark テーマでは、widthInChars プロパティを使用してコントロールの幅を指定できます。この方法は、フォントサイズに応じて拡大 / 縮小する幅を指定するのに便利です。また、typicalText プロパティを使用することもできます。 typicalText を使用すると、widthInChars プロパティは無視されることに注意してください。 すべてのテーマで、幅をピクセル単位で明示的に指定したり、パーセントで指定したり、left や right などの制約を使用したりすることもできます。通常は高さを明示的に指定する必要はありません。コントロールのデフォルトの高さは、1 行のテキストを十分に表示できるように設定されています。

maxChars プロパティを使用して、ユーザーが入力できる文字数を制限したり、restrict を使用して、ユーザーが入力できる文字を制限したりすることもできます。パスワード入力用にこのコントロールを使用するには、displayAsPassword プロパティを true に設定します。

モバイルテーマの場合、ソフトキーボード固有のプロパティである、autoCapitalize、autoCorrect、returnKeyLabel および softKeyboardType プロパティでキーボードヒントを指定します。 ソフトキーボードは存在するが、ヒントで表される機能をサポートしない場合は、ヒントが無視されます。ハードウェアキーボードのみのモバイル環境では、これらのヒントが無視されます。

このコントロールは複数行のテキスト入力をサポートしないので、ユーザーが Enter キーを押すと、改行が挿入される代わりに、FlexEvent.ENTER イベントが送出されます。デフォルトでは、このコントロールには明示的な改行があります。

このコントロールはスキナブルコントロールで、デフォルトスキンには、Spark テーマの場合は RichEditableText インスタンスが含まれ、Mobile テーマの場合は StyleableStageText インスタンスが含まれます。 それがテキストの表示および編集を処理します。また、このスキンは境界線と背景の描画も処理します。この RichEditableText または StyleableStageText インスタンスには textDisplay オブジェクトとしてアクセスできます。モバイルテーマで StageText ベースのスキンではなく TextField ベースのスキンを使用する場合は、skinClass プロパティを「spark.skins.mobile.TextInputSkin」に設定します。

Spark テーマの場合、RichEditableText では TLF が使用されるので、Spark 版の TextInput コントロールではフランス語のように左から右（LTR）に読まれるテキスト、アラビア語のように右から左（RTL）に読まれるテキスト、またはフランス語のフレーズを含むアラビア語のように双方向から読まれるテキストを表示できます。 主に右から左へのテキストを使用する場合は、direction スタイルを rtl に設定します。textAlign スタイルのデフォルト設定は start です。この設定では、direction が ltr の場合にテキストが左揃えになり、direction が rtl の場合に右揃えになります。反対に整列するには、textAlign を end に設定します。

また、Spark の TextInput では TLF が使用されるので、1 回の編集セッション内で取り消し / やり直し操作を何度でも実行できます。編集セッションは、コントロールがキーボードフォーカスを取得したときに開始され、コントロールがフォーカスを失ったときに終了します。

List や DataGrid などのリストベースのコンポーネントでこのコンポーネントを使用するには、アイテムレンダラーを作成します。アイテムレンダラーの作成について詳しくは、「Custom Spark item renderers」を参照してください。

Spark テーマの場合、TextInput コントロールには、次のデフォルトの特性があります。

Mobile テーマの場合、TextInput コントロールには、次のデフォルトの特性があります。

次の表に、Flex でフォームを作成するために使用するコンポーネントを示します。

NumericStepper コントロールは、単一行のテキスト入力フィールドと、使用できる値を表示するための 2 つの矢印ボタンから構成されます。上矢印キー、下矢印キーおよびマウスホイールを使用して値を変更することもできます。ユーザーが Enter キーを押すか、コンポーネントのフォーカスを外すか、あるいは矢印ボタンの操作または changeValueByStep() メソッドの呼び出しを通じて NumericStepper のステップを変えると、入力値がコミットされます。

List や DataGrid などのリストベースのコンポーネントでこのコンポーネントを使用するには、アイテムレンダラーを作成します。アイテムレンダラーの作成について詳しくは、「Custom Spark item renderers」を参照してください。

NumericStepper コントロールには、次のデフォルトの特性があります。

Spinner は、現在の値を増やすためのボタンと現在の値を減らすためのボタンという、2 つの必須ボタンで構成されます。ユーザーは、上矢印キーと下矢印キーおよびマウスホイールを使用して値を変更することもできます。ユーザーが Enter キーを押すか、コンポーネントのフォーカスを外すか、あるいは矢印ボタンの操作または changeValueByStep() メソッドの呼び出しを通じて Spinner のステップを変えると、入力値がコミットされます。

Spinner コンポーネントのスケールは、value プロパティに対して許可される値のセットです。許可される値は、snapInterval プロパティの整数倍と minimum の合計で、maximum 値以下です。次に実際の使用例を示します。

• minimum = -1
• maximum = 10
• snapInterval = 3

List や DataGrid などのリストベースのコンポーネントでこのコンポーネントを使用するには、アイテムレンダラーを作成します。アイテムレンダラーの作成について詳しくは、「Custom Spark item renderers」を参照してください。

Spinner コントロールには、次のデフォルトの特性があります。

コンポーネントは、それ自身のサイズ（width および height）を変更し、その子を適切に再レイアウトできます（これはデフォルトのサイズ変更モードです）。

コンポーネントのもう 1 つのオプションは、そのスケールを変更する方法です。この場合、子を変更する必要はまったくありません。このオプションは、Group によってサポートされています。

NavigatorContent コンテナは、MX ナビゲーターコンテナの外では使用しないでください。

NavigatorContent コンテナの作成ポリシーは、親のナビゲーターコンテナの作成ポリシーに基づいています。

• 親の作成ポリシーが none に設定されている場合、NavigatorContent の作成ポリシーも none になります。
• 親の作成ポリシーが all に設定されている場合、NavigatorContent の作成ポリシーも all になります。
• 親の作成ポリシーが auto に設定されている場合、NavigatorContent の作成ポリシーは none になります。

NavigatorContent コンテナでは、作成ポリシーのキューはサポートされません。

NavigatorContent コンテナには、次のデフォルトの特性があります。

スライダーは、最小値から最大値までの範囲を無段階に移動できるか、または最小値から最大値までの範囲内で段階的にのみ移動できます。 データヒントを使用して現在の値を表示できます。

VSlider コントロールには、次のデフォルトの特性があります。

プログラムで selected プロパティを使用してこの状態を取得または設定できます。

List や DataGrid などのリストベースのコンポーネントでこのコンポーネントを使用するには、アイテムレンダラーを作成します。アイテムレンダラーの作成について詳しくは、「Custom Spark item renderers」を参照してください。

ToggleButton コントロールには、次のデフォルトの特性があります。

HScrollBar コントロールは単独のコントロールとしても使用できますが、通常はコンポーネントの他のグループに構成部分として組み込み、スクロール機能を実現します。

HScrollBar コントロールには、次のデフォルトの特性があります。

SkinnablePopUpContainer コンテナは、親コンテナの通常のレイアウトの一部として作成しないでください。このコンテナは、親の上にポップアップウィンドウとして表示されます。そのため、アプリケーションの MXML コードにこのコンテナを直接作成しないでください。

代わりに、MXML コンポーネントとして、多くの場合は別の MXML ファイルに作成します。このコンポーネントを表示するには、MXML コンポーネントのインスタンスを作成して、open() メソッドを呼び出します。コンポーネントを開くときに、コンポーネントのサイズと位置を設定することもできます。

コンポーネントを閉じるには、close() メソッドを呼び出します。ポップアップがハンドラーにデータを返す必要がある場合は、PopUp.CLOSE イベントのイベントリスナーを追加し、返されたデータを close() メソッドで指定することができます。

SkinnablePopUpContainer は、最初は closed スキン状態になっています。開くと、自分自身を PopUpManager にポップアップとして追加し、normal スキン状態に移行します。開くまたは閉じるアニメーションを定義するには、closed スキン状態と normal スキン状態の間のトランジションにカスタムスキンを使用します。

SkinnablePopUpContainer コンテナには、次のデフォルトの特性があります。

DropDownList コントロールは、アンカーボタン、プロンプト領域、およびドロップダウンリストで構成されます。ドロップダウンリストを開いたり閉じたりするには、アンカーボタンを使用します。プロンプト領域には、プロンプトのストリングまたはドロップダウンリストで選択されているアイテムが表示されます。

ドロップダウンリストが開いているときは次のようになります。

• アンカーボタンをクリックすると、ドロップダウンリストが閉じて、現在選択されているデータアイテムがコミットされます。
• ドロップダウンリストの外側をクリックすると、ドロップダウンリストが閉じて、現在選択されているデータアイテムがコミットされます。
• データアイテムをクリックすると、そのアイテムが選択されて、ドロップダウンリストが閉じます。
• requireSelection プロパティが false の場合、Ctrl キーを押しながらデータアイテムをクリックすると、アイテムの選択が解除されて、ドロップダウンリストが閉じます。

メモ：Spark のリストベースのコントロール（Spark の ListBase クラスと、そのサブクラスである ButtonBar、ComboBox、DropDownList、List、TabBar）では、BasicLayout クラスを layout プロパティの値として使用することはできません。Spark のリストベースのコントロールでは、BasicLayout を使用しないでください。

List や DataGrid などのリストベースのコンポーネントでこのコンポーネントを使用するには、アイテムレンダラーを作成します。アイテムレンダラーの作成について詳しくは、「Custom Spark item renderers」を参照してください。

DropDownList コントロールには、次のデフォルトの特性があります。