| パッケージ | spark.components |
| クラス | public class ButtonBar |
| 継承 | ButtonBar ButtonBarBase ListBase SkinnableDataContainer SkinnableContainerBase SkinnableComponent UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| 実装 | IFocusManagerComponent |
| サブクラス | AXMBreadCrumb, AXMButtonBar |
| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
通常、ボタンバーのプッシュボタンは、関連するボタンをグループ化して共通の外観と操作性を提供し、1 か所で change イベントのロジックを処理するために使用します。
ButtonBar コントロールは、その dataProvider プロパティの値に基づいて Button コントロールを作成します。 dataProvider プロパティを操作してデータアイテムを追加および削除するには、addItem() や removeItem() などのメソッドを使用します。ButtonBar コントロールは、dataProvider プロパティへの変更に基づいて、自動的に必要な子を追加または削除します。
List や DataGrid などのリストベースのコンポーネントでこのコンポーネントを使用するには、アイテムレンダラーを作成します。アイテムレンダラーの作成について詳しくは、「Custom Spark item renderers」を参照してください。
モバイル以外のプロジェクトでは、ButtonBar コントロールを使用すると ViewStack コンテナのアクティブな子を設定できます。次に例を示します。
メモ:Spark のリストベースのコントロール(Spark の ListBase クラスと、そのサブクラスである ButtonBar、ComboBox、DropDownList、List、TabBar)では、BasicLayout クラスを layout プロパティの値として使用することはできません。Spark のリストベースのコントロールでは、BasicLayout を使用しないでください。
<s:ButtonBar dataProvider="{myViewStack}" requireSelection="true" />
<mx:ViewStack id="myViewStack"
borderStyle="solid">
<s:NavigatorContent id="search" label="Search">
<s:Label text="Search Screen"/>
</s:NavigatorContent>
<s:NavigatorContent id="custInfo" label="Customer Info">
<s:Label text="Customer Info"/>
</s:NavigatorContent>
<s:NavigatorContent id="accountInfo" label="Account Info">
<s:Label text="Account Info"/>
</s:NavigatorContent>
</mx:ViewStack>
ButtonBar コントロールには、次のデフォルトの特性があります。
| 特性 | 説明 |
|---|---|
| デフォルトサイズ | すべてのボタンを表示できるだけのサイズ |
| 最小サイズ | 0 ピクセル |
| 最大サイズ | 制限なし |
| デフォルトスキンクラス | spark.skins.spark.ButtonBarSkin |
MXML シンタックスを隠すThe <s:ButtonBar> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:ButtonBar />
デフォルトの MXML プロパティdataProvider
さらに例を参照
Using Spark list-based controls
Spark ButtonBar and TabBar controls
関連する API エレメント
| メソッド | 定義元 | ||
|---|---|---|---|
コンストラクターです。 | ButtonBar | ||
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | EventDispatcher | |
![]() |
ビジュアルでないスタイルクライアントを、このコンポーネントのインスタンスに追加します。 | UIComponent | |
![]() |
特定の point ポイントを指定して呼び出した DisplayObjectContainer.getObjectsUnderPoint() メソッドから返されたリストに、セキュリティ上の制約のために省略される表示オブジェクトがあるかどうかを示します。 | DisplayObjectContainer | |
![]() |
後で呼び出す関数をキューに格納します。 | UIComponent | |
![]() |
このコンポーネントインスタンスからスタイルプロパティを削除します。 | UIComponent | |
![]() |
指定された表示オブジェクトが、DisplayObjectContainer インスタンスの子であるか、インスタンス自体であるかを指定します。 | DisplayObjectContainer | |
![]() |
Point オブジェクトをコンテンツ座標からグローバル座標に変換します。 | UIComponent | |
![]() |
Point オブジェクトをコンテンツ座標からローカル座標に変換します。 | UIComponent | |
![]() |
このコンテナの子を識別するプロパティのセットを返します。 | UIComponent | |
![]() |
このコンテナの子を識別するプロパティのセットを返します。 | UIComponent | |
![]() |
この IUIComponent オブジェクトへの id 参照を親ドキュメントオブジェクト上に作成します。 | UIComponent | |
![]() |
この IUIComponent オブジェクトへの id 参照を親ドキュメントオブジェクトから削除します。 | UIComponent | |
![]() |
この UIComponent のテキストスタイルに対応する UITextFormat オブジェクトを返します。 | UIComponent | |
![]() | [オーバーライド]
イベントをイベントフローに送出します。 | UIComponent | |
![]() |
このコンポーネントを囲むフォーカスインジケーターを表示するか、または非表示にします。 | 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 | |
![]() |
コンポーネントでの再生の停止時にエフェクトインスタンスによって呼び出されます。 | UIComponent | |
![]() |
コンポーネントでの再生の開始時にエフェクトインスタンスによって呼び出されます。 | UIComponent | |
![]() |
現在コンポーネントで再生中のすべてのエフェクトを終了します。 | UIComponent | |
![]() |
UIComponent オブジェクトがターゲットであるすべてのバインディングを実行します。 | UIComponent | |
![]() |
印刷の完了後に呼び出されます。 | UIComponent | |
![]() |
指定されたインデックス位置でオートメーションオブジェクトを提供します。 | UIComponent | |
![]() |
オートメーションオブジェクトリストを提供します。 | UIComponent | |
![]() |
targetCoordinateSpace オブジェクトの座標系を基準にして、表示オブジェクトの領域を定義する矩形を返します。 | DisplayObject | |
![]() |
エレメントの境界の x 座標を、指定したエレメントサイズで返します。 | UIComponent | |
![]() |
エレメントの境界の y 座標を、指定したエレメントサイズで返します。 | UIComponent | |
![]() |
指定された名前に一致する子表示オブジェクトを返します。 | DisplayObjectContainer | |
![]() |
この UIComponent インスタンスのタイプセレクターを探します。 | UIComponent | |
![]() |
レイアウト制約値を返します。これは、このコンポーネントの制約スタイルを取得することと同じです。 | UIComponent | |
![]() |
明示的に指定された高さを使用するのか、それとも測定された高さを使用するのかを決定するための便利なメソッドです。
| UIComponent | |
![]() |
明示された幅を使用するのか、それとも測定した幅を使用するのかを決定する便利なメソッドです。
| UIComponent | |
![]() |
現在フォーカスを持っているオブジェクトを取得します。 | UIComponent | |
![]() |
エレメントのレイアウトの高さを返します。 | UIComponent | |
![]() |
エレメントのレイアウトの幅を返します。 | UIComponent | |
![]() |
画面に描画するためにエレメントで使用する x 座標を返します。 | UIComponent | |
![]() |
画面に描画するためにエレメントで使用する y 座標を返します。 | UIComponent | |
![]() |
兄弟を基準としてコンポーネントのレイアウトを計算するために使用される変換マトリックスを返します。 | UIComponent | |
![]() |
このエレメントのレイアウト変換 Matrix3D を返します。 | UIComponent | |
![]() |
エレメントの最大の高さを返します。 | UIComponent | |
![]() |
エレメントの最大の幅を返します。 | UIComponent | |
![]() |
エレメントの最小の高さを返します。 | UIComponent | |
![]() |
エレメントの最小の幅を返します。 | UIComponent | |
![]() |
指定されたポイントの下にあり、この DisplayObjectContainer インスタンスの子(または孫など)であるオブジェクトの配列を返します。 | DisplayObjectContainer | |
![]() |
エレメントの推奨高さを返します。 | UIComponent | |
![]() |
エレメントの推奨幅を返します。 | UIComponent | |
![]() |
シェイプ上の線を除き、targetCoordinateSpace パラメーターによって定義された座標系に基づいて、表示オブジェクトの境界を定義する矩形を返します。 | DisplayObject | |
![]() |
指定された Repeater がこの Repeater を生成するために使用した dataProvider 内のアイテムを返します。この Repeater が繰り返されていない場合は、null を返します。 | UIComponent | |
![]() |
このコンポーネントのスタイル参照チェーンのいずれかの場所に設定されたスタイルプロパティを取得します。 | UIComponent | |
![]() |
Point オブジェクトをグローバル座標からコンテンツ座標に変換します。 | UIComponent | |
![]() |
point オブジェクトをステージ(グローバル)座標から表示オブジェクトの(ローカル)座標に変換します。 | DisplayObject | |
![]() |
ステージ(グローバル)座標の 2 次元のポイントを 3 次元の表示オブジェクトの(ローカル)座標に変換します。 | DisplayObject | |
![]() |
currentCSSState が null でない場合、true を返します。 | UIComponent | |
![]() |
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | |
![]() |
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
![]() |
指定されたステートがこの UIComponent で定義されているかどうかを判別します。 | UIComponent | |
![]() |
表示オブジェクトの境界ボックスを評価して、obj 表示オブジェクトの境界ボックスと重複または交差するかどうかを調べます。 | DisplayObject | |
![]() |
表示オブジェクトを評価して、x および y パラメーターで指定されたポイントと重複または交差するかどうかを調べます。 | DisplayObject | |
![]() |
水平方向のグラデーションを描画するときに rot パラメーターとして drawRoundRect() メソッドに渡すことのできるボックスの Matrix を返します。 | UIComponent | |
![]() |
このコンポーネントの内部構造を初期化します。 | UIComponent | |
![]() |
このコンポーネントの繰り返しインスタンスを追跡する各種プロパティを初期化します。 | UIComponent | |
![]() |
次の画面更新時に updateDisplayList() メソッドが呼び出されるように、コンポーネントをマークします。 | UIComponent | |
![]() |
depth プロパティが変更されたことを示すために、コンポーネントのアイテムによって呼び出されます。 | UIComponent | |
![]() |
エレメントの layoutDirection を変更する場合、または親エレメントの layoutDirection を変更する場合は、エレメントでこのメソッドを呼び出す必要があります。 | UIComponent | |
![]() |
後で画面更新時に commitProperties() メソッドが呼び出されるように、コンポーネントをマークします。 | UIComponent | |
![]() |
後で画面更新時に measure() メソッドが呼び出されるように、コンポーネントをマークします。 | UIComponent | |
![]() |
後で画面が更新されるときにスキンの新しい状態が設定されるように、コンポーネントをマークします。 | SkinnableComponent | |
![]() |
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
![]() | [オーバーライド]
データアイテムが指定されると、labelField および labelFunction プロパティを考慮しながらレンダラーが表示する必要がある正しいテキストを返します。 | ListBase | |
![]() |
3 次元の表示オブジェクトの(ローカル)座標の 3 次元のポイントをステージ(グローバル)座標の 2 次元のポイントに変換します。 | DisplayObject | |
![]() |
Point オブジェクトをローカル座標からコンテンツ座標に変換します。 | UIComponent | |
![]() |
point オブジェクトを表示オブジェクトの(ローカル)座標からステージ(グローバル)座標に変換します。 | DisplayObject | |
![]() |
cssState が currentCSSState に一致した場合は、true を返します。 | UIComponent | |
![]() |
このインスタンスが、指定されたタイプと同じであるのか、それともそのサブクラスであるのかを判別します。 | UIComponent | |
![]() |
この UIComponent のスタイルで決定される UITextFormat を使用して単一行の UITextField に表示するものとして、<font> や <b> のような HTML タグが含まれる可能性のある、指定の HTML テキストを測定します。 | UIComponent | |
![]() |
この UIComponent のスタイルで決定される UITextFormat を使用して単一行の UITextField(または UIFTETextField)に表示するものとして、指定のテキストを測定します。 | UIComponent | |
![]() |
親の内部の指定された位置にコンポーネントを移動します。 | UIComponent | |
![]() |
スタイルの変更を子に通知します。 | UIComponent | |
![]() |
owner プロパティのチェーンが child からこの UIComponent を指定している場合に、true を返します。 | UIComponent | |
![]() |
UIComponent オブジェクトを親に対して追加または削除したときに Flex によって呼び出されます。 | UIComponent | |
![]() |
印刷用の IFlexDisplayObject を準備します。 | UIComponent | |
![]() |
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
![]() |
このコンポーネントの CSS スタイルキャッシュを作成または再作成します。recursive パラメーターが true の場合は、このコンポーネントのすべての下位要素の CSS スタイルキャッシュも作成または再作成します。 | UIComponent | |
![]() |
各エフェクトイベントごとに、EffectManager をイベントリスナーの 1 つとして登録します。 | UIComponent | |
![]() |
DisplayObjectContainer インスタンスの子リストから、すべての child DisplayObject インスタンスを削除します。 | DisplayObjectContainer | |
![]() |
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | |
![]() |
ビジュアルでないスタイルクライアントを、このコンポーネントのインスタンスから削除します。 | UIComponent | |
![]() |
指定されたイベントを再生します。 | UIComponent | |
![]() |
仮想キーボードを前面に表示します。 | InteractiveObject | |
![]() |
提供された ID を使用して子を解決します。 | UIComponent | |
![]() | [静的]
suspendBackgroundProcessing() が呼び出された後、callLater() によってキューに入れられたメソッドのバックグラウンド処理を再開します。 | UIComponent | |
![]() |
オブジェクトのサイズを設定します。 | UIComponent | |
![]() |
レイアウト制約値を設定します。これは、このコンポーネントの制約スタイルを設定することと同じです。 | UIComponent | |
![]() |
現在の状態を設定します。 | UIComponent | |
![]() |
現在扱っているコンポーネントにフォーカスを設定します。 | UIComponent | |
![]() |
画面に描画するためにエレメントで使用する座標を設定します。 | UIComponent | |
![]() |
エレメントのレイアウトサイズを設定します。 | UIComponent | |
![]() |
兄弟を基準としてコンポーネントのレイアウトサイズおよび位置を計算するために使用される変換 Matrix を設定します。 | UIComponent | |
![]() |
兄弟を基準としてコンポーネントのレイアウトサイズおよび位置を計算するために使用される変換 Matrix3D を設定します。 | UIComponent | |
![]() |
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
![]() |
このコンポーネントインスタンスのスタイルプロパティを設定します。 | UIComponent | |
![]() |
visible プロパティが変更されたときに呼び出されます。 | UIComponent | |
![]() |
指定されたスプライトをユーザーがドラッグできるようにします。 | Sprite | |
![]() |
指定されたスプライトを、ユーザーがタッチ対応デバイス上でドラッグできるようにします。 | Sprite | |
![]() |
このオブジェクトでルート指定されているすべての MovieClip のタイムラインでの実行を再帰的に停止します。 | DisplayObjectContainer | |
![]() |
startDrag() メソッドを終了します。 | Sprite | |
![]() |
タッチ対応デバイスで使用する startTouchDrag() メソッドを終了します。 | Sprite | |
![]() |
スタイルプロパティの変更を検出します。 | UIComponent | |
![]() |
コンポーネントのスタイルを初めて初期化するとき、Flex は stylesInitialized() メソッドを呼び出します。 | UIComponent | |
![]() | [静的]
resumeBackgroundProcessing() が呼び出されるまで、callLater() によってキューに入れられたメソッドのバックグラウンド処理をブロックします。 | UIComponent | |
![]() |
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
![]() | [オーバーライド]
アプリケーションの DisplayObject の階層におけるこのオブジェクトの位置を示すストリングを返します。 | FlexSprite | |
![]() | transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void
コンポーネントの独自の座標空間内で指定され、親の座標空間内に固定される、特定のポイントを保持して変換の回転、拡大 / 縮小および平行移動を更新するためのユーティリティメソッドです。 | UIComponent | |
![]() |
このオブジェクトのローカル座標に指定されたポイントをオブジェクトの親の座標の場所に変換するユーティリティメソッドです。 | UIComponent | |
![]() |
使用または再使用するためにアイテムレンダラーを更新します。 | SkinnableDataContainer | |
![]() |
子の位置とサイズを検証し、その他のビジュアルオブジェクトを描画します。 | UIComponent | |
![]() |
必要に応じて、このオブジェクトのプロパティとレイアウトを検証および更新し、それを再描画します。 | UIComponent | |
![]() |
commitProperties() メソッドを呼び出してコンポーネントのプロパティを検証するために、レイアウトロジックによって使用されます。 | UIComponent | |
![]() |
コンポーネントの測定サイズを検証します。LayoutManager.invalidateSize() メソッドがこの ILayoutManagerClient を指定して呼び出された場合、測定の実行時に validateSize() メソッドが呼び出されます。 | UIComponent | |
![]() |
このコンポーネントに割り当てられたバリデーターからの valid と invalid の両方のイベントを処理します。 | UIComponent | |
![]() |
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
![]() |
垂直方向のグラデーションを描画するときに rot パラメーターとして drawRoundRect() メソッドに渡すことのできるボックスの Matrix を返します。 | UIComponent | |
![]() |
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher | |
スタイルには共通スタイルと特定のテーマに関連するスタイルがあります。共通スタイルは、任意のテーマと共に使用できます。特定のテーマに関連するスタイルは、アプリケーションがそのテーマを使用する場合にのみ使用できます。
このコンポーネントはスキンパーツで構成されるスキンを使用します。スキンパーツを直接設定しないでください。コンポーネントのスキンがスキンパーツを設定します。
| スキンパーツ | 説明 | 定義元 | ||
|---|---|---|---|---|
![]() | 必須: false パーツタイプ: 静的 言語バージョン: ActionScript 3.0 製品バージョン: Flex 4 ランタイムバージョン: Flash10, AIR 1.5 データアイテムがプッシュ、レンダリング、およびレイアウトされる、スキンクラス内の DataGroup を定義する、オプションのスキンパーツです。 | SkinnableDataContainer | ||
firstButton:IFactory | 必須: false パーツタイプ: 動的 言語バージョン: ActionScript 3.0 製品バージョン: Flex 4 ランタイムバージョン: Flash10, AIR 1.5 最初のボタンを定義するスキンパーツです。 IFactory はこの型のオブジェクトを返す必要があります IVisualElement。 | ButtonBar | ||
lastButton:IFactory | 必須: false パーツタイプ: 動的 言語バージョン: ActionScript 3.0 製品バージョン: Flex 4 ランタイムバージョン: Flash10, AIR 1.5 最後のボタンを定義するスキンパーツです。 IFactory はこの型のオブジェクトを返す必要があります IVisualElement。 | ButtonBar | ||
middleButton:IFactory | 必須: true パーツタイプ: 動的 言語バージョン: ActionScript 3.0 製品バージョン: Flex 4 ランタイムバージョン: Flash10, AIR 1.5 中間のボタンを定義するスキンパーツです。 IFactory はこの型のオブジェクトを返す必要があります IVisualElement。 | ButtonBar | ||
コンポーネントをスキン化するには、次の状態を定義するスキンを実装します。すべてのスキン状態を実装する必要がありますが、スキン状態は空でもかまいません。空のスキン状態は、デフォルトのスキン状態に変更がないことを指定します。
ButtonBar | () | コンストラクター |
public function ButtonBar()| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
コンストラクターです。
<?xml version="1.0"?>
<!-- Simple example to demonstrate the Spark ButtonBar -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx">
<fx:Style>
@namespace "library://ns.adobe.com/flex/spark";
ButtonBar ToggleButton:upAndSelected,
ButtonBar ToggleButton:overAndSelected,
ButtonBar ToggleButton:downAndSelected,
ButtonBar ToggleButton:disabledAndSelected {
chromeColor: #663366;
color: #9999CC;
}
ButtonBar {
chromeColor: #9999CC;
color: #663366;
}
</fx:Style>
<fx:Script>
<![CDATA[
import spark.events.IndexChangeEvent;
private function changeSelection(event:IndexChangeEvent): void {
selectionText.text = "Selected Item: " + ButtonBar(event.target).selectedItem;
}
]]>
</fx:Script>
<s:Panel title="Spark ButtonBar Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<s:Label text="Select an item below:" x="10" y="15" />
<s:ButtonBar id="viewMenu" requireSelection="true" x="10" y="40" width="320"
change="changeSelection(event)">
<s:dataProvider>
<s:ArrayCollection source="['Home', 'Rooms', 'Dining']" />
</s:dataProvider>
</s:ButtonBar>
<s:Label x="10" y="75" id="selectionText" />
</s:Panel>
</s:Application>
Tue Jun 12 2018, 10:34 AM Z
MXML シンタックスを表示