パッケージfl.controls
クラスpublic class ComboBox
継承ComboBox Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
実装 IFocusManagerComponent

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ComboBox コンポーネントには、ユーザーが 1 つの値を選択できるドロップダウンリストが含まれています。機能は、HTML のフォームエレメントである SELECT に似ています。ComboBox コンポーネントは編集可能にできます。この場合、ユーザーはリストに含まれないエントリを ComboBox コンポーネントの TextInput 部分に入力できます。

例を表示

関連項目

List
TextInput


パブリック プロパティ
 プロパティ定義元
 InheritedaccessibilityProperties : AccessibilityProperties
この表示オブジェクトの現在のアクセシビリティオプションです。
DisplayObject
 Inheritedalpha : Number
指定されたオブジェクトのアルファ透明度値を示します。
DisplayObject
 InheritedblendMode : String
使用するブレンドモードを指定する BlendMode クラスの値です。
DisplayObject
 InheritedbuttonMode : Boolean
このスプライトのボタンモードを指定します。
Sprite
 InheritedcacheAsBitmap : Boolean
true に設定されている場合、表示オブジェクトの内部ビットマップ表現が Flash Player にキャッシュされます。
DisplayObject
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 InheritedcontextMenu : ContextMenu
このオブジェクトに関連付けられたコンテキストメニューを指定します。
InteractiveObject
  dataProvider : DataProvider
表示されるアイテムのリストのデータモデルを取得または設定します。
ComboBox
 InheriteddoubleClickEnabled : Boolean
オブジェクトが doubleClick イベントを受け取るかどうかを指定します。
InteractiveObject
  dropdown : List
[read-only] ComboBox コンポーネントが含む List コンポーネントへの参照を取得します。
ComboBox
  dropdownWidth : Number
ドロップダウンリストの最大幅 (ピクセル単位) を取得または設定します。
ComboBox
 InheriteddropTarget : DisplayObject
[read-only] スプライトのドラッグ先またはスプライトがドロップされた先の表示オブジェクトを指定します。
Sprite
  editable : Boolean
ComboBox コンポーネントが編集可能または読み取り専用のいずれであるかを示すブール値を取得または設定します。
ComboBox
 Inheritedenabled : Boolean
コンポーネントがユーザーの操作を受け付けるかどうかを示す値を取得または設定します。
UIComponent
 Inheritedfilters : Array
表示オブジェクトに現在関連付けられている各フィルタオブジェクトが格納されているインデックス付きの配列です。
DisplayObject
 InheritedfocusEnabled : Boolean
ユーザーがコンポーネントをクリックしたときに、コンポーネントがフォーカスを受け取ることが可能かどうかを示すブール値を取得または設定します。
UIComponent
 InheritedfocusManager : IFocusManager
このコンポーネントとそのピアーに対するフォーカスを制御する FocusManager を取得または設定します。
UIComponent
 InheritedfocusRect : Object
このオブジェクトがフォーカス矩形を表示するかどうかを指定します。
InteractiveObject
 Inheritedgraphics : Graphics
[read-only] ベクターの描画コマンドが発生する、このスプライトに属する Graphics オブジェクトを指定します。
Sprite
 Inheritedheight : Number
コンポーネントの高さを取得または設定します (ピクセル単位)。
UIComponent
 InheritedhitArea : Sprite
スプライトのヒット領域となる別のスプライトを指定します。
Sprite
  labelField : String
TextInput フィールドとドロップダウンリストのラベルとして表示される dataProvider オブジェクトのフィールドの名前を取得または設定します。
ComboBox
  labelFunction : Function
アイテムのラベルの取得に使用される関数を取得または設定します。
ComboBox
  length : int
[read-only] リスト内の項目の数を取得します。
ComboBox
 InheritedloaderInfo : LoaderInfo
[read-only] この表示オブジェクトが属するファイルのロード情報を含む LoaderInfo オブジェクトを返します。
DisplayObject
 Inheritedmask : DisplayObject
呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。
DisplayObject
 InheritedmouseChildren : Boolean
オブジェクトの子に対してマウスが有効かどうかを調べます。
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
このオブジェクトがマウスメッセージを受け取るかどうかを指定します。
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
ユーザーがコンポーネントをクリックしたときに、コンポーネントがフォーカスを受け取ることが可能かどうかを示す値を取得または設定します。
UIComponent
 InheritedmouseX : Number
[read-only] マウス位置の x 座標を示します (ピクセル単位)。
DisplayObject
 InheritedmouseY : Number
[read-only] マウス位置の y 座標を示します (ピクセル単位)。
DisplayObject
 Inheritedname : String
DisplayObject のインスタンス名を示します。
DisplayObject
 InheritednumChildren : int
[read-only] このオブジェクトの子の数を返します。
DisplayObjectContainer
 InheritedopaqueBackground : Object
表示オブジェクトが特定の背景色で不透明であるかどうかを指定します。
DisplayObject
 Inheritedparent : DisplayObjectContainer
[read-only] この表示オブジェクトを含む DisplayObjectContainer オブジェクトを示します。
DisplayObject
  prompt : String
ComboBox コンポーネントのプロンプトを取得または設定します。
ComboBox
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  restrict : String
テキストフィールドにユーザーが入力できる文字を取得または設定します。
ComboBox
 Inheritedroot : DisplayObject
[read-only] ロードされた SWF ファイル内の表示オブジェクトの場合、root プロパティはその SWF ファイルが表す表示リストのツリー構造部分の一番上にある表示オブジェクトとなります。
DisplayObject
 Inheritedrotation : Number
DisplayObject インスタンスの元の位置からの回転角を度単位で示します。
DisplayObject
  rowCount : uint
スクロールバーを持たないドロップダウンリストに表示できる最大行数を取得または設定します。
ComboBox
 Inheritedscale9Grid : Rectangle
現在有効な拡大 / 縮小グリッドです。
DisplayObject
 InheritedscaleX : Number
コンポーネントの現在の幅に縮尺率を乗算します。
UIComponent
 InheritedscaleY : Number
コンポーネントの現在の高さに縮尺率を乗算します。
UIComponent
 InheritedscrollRect : Rectangle
表示オブジェクトのスクロール矩形の境界です。
DisplayObject
  selectedIndex : int
単一選択リストで選択されたアイテムのインデックスを取得または設定します。
ComboBox
  selectedItem : Object
ドロップダウンリストで選択されているアイテムの値を取得または設定します。
ComboBox
  selectedLabel : String
[read-only] ComboBox コンポーネントの TextInput 部分に表示されるストリングを取得します。
ComboBox
 InheritedsoundTransform : SoundTransform
このスプライト内のサウンドを制御します。
Sprite
 Inheritedstage : Stage
[read-only] 表示オブジェクトのステージです。
DisplayObject
 InheritedtabChildren : Boolean
オブジェクトの子に対してタブが有効かどうかを調べます。
DisplayObjectContainer
 InheritedtabEnabled : Boolean
このオブジェクトがタブ順序に含まれるかどうかを指定します。
InteractiveObject
 InheritedtabIndex : int
SWF ファイル内のオブジェクトのタブ順序を指定します。
InteractiveObject
  text : String
編集可能な ComboBox コンポーネントのテキストボックスが含むテキストを取得または設定します。
ComboBox
  textField : TextInput
[read-only] ComboBox コンポーネントが含む TextInput コンポーネントへの参照を取得します。
ComboBox
 InheritedtextSnapshot : TextSnapshot
[read-only] この DisplayObjectContainer インスタンスの TextSnapshot オブジェクトを返します。
DisplayObjectContainer
 Inheritedtransform : Transform
表示オブジェクトのマトリックス、カラー変換、ピクセル境界に関係するプロパティを持つオブジェクトです。
DisplayObject
 InheriteduseHandCursor : Boolean
buttonMode プロパティが true に設定されたスプライト上にマウスが移動したときに、指差しハンドポインタ (ハンドカーソル) を表示するかどうかを示すブール値です。
Sprite
  value : String
[read-only] 編集可能な ComboBox コンポーネント内のアイテムのラベルを取得します。
ComboBox
 Inheritedversion : String = "3.0.0.15"
コンポーネントのバージョン番号。
UIComponent
 Inheritedvisible : Boolean
現在のコンポーネントのインスタンスが可視かどうかを示す値を取得または設定します。
UIComponent
 Inheritedwidth : Number
コンポーネントの幅を取得または設定します (ピクセル単位)。
UIComponent
 Inheritedx : Number
親コンテナ内での x 軸に沿ったコンポーネントの位置を表す x 座標を取得または設定します。
UIComponent
 Inheritedy : Number
親コンテナ内での y 軸に沿ったコンポーネントの位置を表す y 座標を取得または設定します。
UIComponent
パブリック メソッド
 メソッド定義元
  
ComboBox コンポーネントの新しいインスタンスを作成します。
ComboBox
 Inherited
この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。
DisplayObjectContainer
 Inherited
この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
  
アイテムのリストの末尾にアイテムを追加します。
ComboBox
  
addItemAt(item:Object, index:uint):void
指定されたインデックス位置のリストにアイテムを挿入します。
ComboBox
 Inherited
特定の point ポイントを指定して呼び出した DisplayObjectContainer.getObjectsUnderPoint() メソッドから返されたリストに、セキュリティ上の制約のために省略される表示オブジェクトがあるかどうかを示します。
DisplayObjectContainer
 Inherited
このコンポーネントインスタンスからスタイルプロパティを削除します。
UIComponent
  
ドロップダウンリストを閉じます。
ComboBox
 Inherited
指定された表示オブジェクトが、DisplayObjectContainer インスタンスの子であるか、インスタンス自体であるかを指定します。
DisplayObjectContainer
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
このコンポーネントのフォーカスインジケータを表示または非表示にします。
UIComponent
 Inherited
invalidateNow とは異なり、すべてを無効化せずに直ちに描画を開始します。
UIComponent
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
targetCoordinateSpace オブジェクトの座標系を基準にして、表示オブジェクトの領域を定義する矩形を返します。
DisplayObject
 Inherited
指定のインデックス位置にある子表示オブジェクトインスタンスを返します。
DisplayObjectContainer
 Inherited
指定された名前に一致する子表示オブジェクトを返します。
DisplayObjectContainer
 Inherited
子 DisplayObject インスタンスのインデックス位置を返します。
DisplayObjectContainer
 Inherited
現在フォーカスを持っているオブジェクトを取得します。
UIComponent
  
指定されたインデックス位置のアイテムを取得します。
ComboBox
 Inherited
指定されたポイントの下にあり、この DisplayObjectContainer インスタンスの子または孫などであるオブジェクトの配列を返します。
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
シェイプ上の線を除き、targetCoordinateSpace パラメータによって定義された座標系に基づいて、表示オブジェクトの境界を定義する矩形を返します。
DisplayObject
 Inherited
コンポーネントのスタイル参照チェーンに設定されているスタイルプロパティを取得します。
UIComponent
  
[static] 現在のコンポーネントのデフォルトスタイルマップを取得します。
ComboBox
 Inherited
point オブジェクトをステージ (グローバル) 座標から表示オブジェクトの (ローカル) 座標に変換します。
DisplayObject
 Inherited
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
表示オブジェクトを評価して、obj 表示オブジェクトと重複または交差するかどうかを調べます。
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
表示オブジェクトを評価して、x および y パラメータで指定されたポイントと重複または交差するかどうかを調べます。
DisplayObject
 Inherited
invalidate(property:String, callLater:Boolean = true):void
プロパティが無効であることを示し、指定がない限り、コンポーネントを次のフレームに再描画します。
UIComponent
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
  
labelField プロパティと labelFunction プロパティに基づいて、指定されたデータオブジェクトに対してレンダラーが表示するストリングを取得します。
ComboBox
 Inherited
point オブジェクトを表示オブジェクトの (ローカル) 座標からステージ (グローバル) 座標に変換します。
DisplayObject
 Inherited
[static] 複数のクラスのスタイルを 1 つのオブジェクトに結合します。
UIComponent
 Inherited
親の内部の指定された位置にコンポーネントを移動します。
UIComponent
  
ドロップダウンリストを開きます。
ComboBox
 Inherited
指定されたプロパティが存在し列挙できるかどうかを示します。
Object
  
リストからすべてのアイテムを削除します。
ComboBox
 Inherited
DisplayObjectContainer インスタンスの子リストから指定の child DisplayObject インスタンスを削除します。
DisplayObjectContainer
 Inherited
DisplayObjectContainer の子リストの指定されたインデックス位置から子 DisplayObject を削除します。
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
  
指定されたアイテムをリストから削除します。
ComboBox
  
指定したインデックス位置のアイテムを削除します。
ComboBox
  
指定されたインデックス位置にあるアイテムを別のアイテムで置き換えます。
ComboBox
 Inherited
表示オブジェクトコンテナの既存の子の位置を変更します。
DisplayObjectContainer
 Inherited
現在扱っているコンポーネントにフォーカスを設定します。
UIComponent
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
setSize(width:Number, height:Number):void
コンポーネントのサイズを、指定した幅と高さに設定します。
UIComponent
 Inherited
setStyle(style:String, value:Object):void
このコンポーネントインスタンスのスタイルプロパティを設定します。
UIComponent
  
sortItems(... sortArgs):*
現在のデータプロバイダのエレメントを並べ替えます。
ComboBox
  
sortItemsOn(field:String, options:Object = null):*
現在のデータプロバイダのエレメントを 1 つまたは複数のフィールドで並べ替えます。
ComboBox
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
指定されたスプライトをユーザーがドラッグできるようにします。
Sprite
 Inherited
startDrag() メソッドを終了します。
Sprite
 Inherited
指定された 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
子リスト内の指定されたインデックス位置に該当する 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。
DisplayObjectContainer
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
必要に応じて、このオブジェクトのプロパティとレイアウトを検証および更新し、それを再描画します。
UIComponent
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント 概要 定義元
 Inherited Flash Player がオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited 表示オブジェクトが表示リストに追加されたときに送出されます。DisplayObject
 Inherited 表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの追加により、ステージ上の表示リストに追加されたときに送出されます。DisplayObject
   ユーザーが ComboBox コンポーネントの選択を変更したときか、ComboBox コンポーネントが編集可能な場合に、ユーザーがテキストフィールドにキーストロークを入力するたびに送出されます。ComboBox
 Inherited ユーザーが InteractiveObject をポインティングデバイスのメインボタンでクリックしたときに送出されます。InteractiveObject
   何らかの理由でドロップダウンリストが閉じられたときに送出されます。ComboBox
 Inherited Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
 Inherited オブジェクトの doubleClickEnabled フラグが true に設定されている場合にユーザーが InteractiveObject をポインティングデバイスのメインボタンで 2 回続けてすばやくクリックすると送出されます。InteractiveObject
   editable プロパティが true に設定されている場合に、編集可能なテキストフィールドへの入力中にユーザーが Enter キーを押すと送出されます。ComboBox
 Inherited 再生ヘッドが新しいフレームに入るときに送出されます。DisplayObject
 Inherited 表示オブジェクトがフォーカスを取得したときに送出されます。InteractiveObject
 Inherited 表示オブジェクトがフォーカスを失ったときに送出されます。InteractiveObject
 Inherited コンポーネントの可視性が可視から不可視に変化した後に送出されます。UIComponent
   ユーザーがコンポーネント内のアイテムからポインタを離したときに送出されます。ComboBox
   ユーザーがコンポーネント内のアイテムにポインタを置いたときに送出されます。ComboBox
 Inherited ユーザーがキーを押したときに送出されます。InteractiveObject
 Inherited ユーザーがキーボード操作によってフォーカスを変更しようとすると送出されます。InteractiveObject
 Inherited ユーザーがキーを離したときに送出されます。InteractiveObject
 Inherited Flash Player ウィンドウの InteractiveObject インスタンスの上でユーザーがポインティングデバイスのボタンを押すと送出されます。InteractiveObject
 Inherited ユーザーがポインティングデバイスでフォーカスを変更しようとすると送出されます。InteractiveObject
 Inherited ユーザーが InteractiveObject の上でポインティングデバイスを移動させたときに送出されます。InteractiveObject
 Inherited ユーザーが InteractiveObject インスタンスからポインティングデバイスを離したときに送出されます。InteractiveObject
 Inherited ユーザーが Flash Player ウィンドウの InteractiveObject インスタンスにポインティングデバイスを合わせたときに送出されます。InteractiveObject
 Inherited ユーザーが Flash Player ウィンドウの InteractiveObject インスタンスの上でポインティングデバイスのボタンを解放したときに送出されます。InteractiveObject
 Inherited Flash Player ウィンドウの InteractiveObject インスタンスの上でマウスホイールを回転させたときに送出されます。InteractiveObject
 Inherited コンポーネントが移動された後に送出されます。UIComponent
   ユーザーがドロップダウンボタンをクリックしてドロップダウンリストを表示したときに送出されます。ComboBox
 Inherited 表示オブジェクトが表示リストから削除されようとしているときに送出されます。DisplayObject
 Inherited 表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの削除により、表示リストから削除されようとしているときに送出されます。DisplayObject
 Inherited 表示リストが更新およびレンダリングされようとしているときに送出されます。DisplayObject
 Inherited コンポーネントのサイズが変更された後に送出されます。UIComponent
 Inherited ユーザーが InteractiveObject インスタンスからポインティングデバイスを離したときに送出されます。InteractiveObject
 Inherited ユーザーが InteractiveObject インスタンスにポインティングデバイスを合わせたときに送出されます。InteractiveObject
   ユーザーが ComboBox コンポーネントのドロップダウンリストをスクロールしたときに送出されます。ComboBox
 Inherited コンポーネントの可視性が不可視から可視に変化した後に送出されます。UIComponent
 Inherited オブジェクトの tabChildren フラグの値が変更されたときに送出されます。InteractiveObject
 Inherited オブジェクトの tabEnabled フラグが変更されたときに送出されます。InteractiveObject
 Inherited オブジェクトの tabIndex プロパティの値が変更されたときに送出されます。InteractiveObject
スタイル
 スタイル 説明 定義元
  
buttonWidth
データ型: Number   形式: Length
コンポーネントの右端と選択されたアイテムを表すテキストを区切る間隔です (ピクセル単位)。 ボタンは背景スキンの一部です。 デフォルト値 : 24.
ComboBox
  
cellRenderer
データ型: Class
コンポーネント内の各アイテム用のセルレンダラーを指定するクラスです。 デフォルト値 : fl.controls.listClasses.CellRenderer.
ComboBox
  
contentPadding
データ型: Number   形式: Length
コンテンツ (コンポーネントとスクロールバー) と背景の外側エッジ間のパディングです (ピクセル単位)。 デフォルト値 : 3.
ComboBox
  
disabledAlpha
データ型: Class
enabled プロパティが false の場合に、リストに設定されるアルファの値です。 デフォルト値 : 0.5.
ComboBox
  
disabledSkin
データ型: Class
コンポーネントの enabled プロパティが false に設定されている場合に、ComboBox コンポーネントに表示される背景を指定するクラスの名前です。 デフォルト値 : ComboBox_disabledSkin.
ComboBox
 Inherited データ型: flash.text.TextFormat
ボタンが無効な場合に、コンポーネントラベルのレンダリングに使用される TextFormat オブジェクトです。
UIComponent
  
downArrowDisabledSkin
データ型: Class
スクロールバーの下矢印ボタンが無効になったときに、その下矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。 デフォルト値 : ScrollArrowDown_disabledSkin.
ComboBox
  
downArrowDownSkin
データ型: Class
スクロールバーの下矢印ボタンをクリックしたときに、その下矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。 デフォルト値 : ScrollArrowDown_downSkin.
ComboBox
  
downArrowOverSkin
データ型: Class
スクロールバーの下矢印ボタンにマウスポインタを合わせたときに、その下矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。 デフォルト値 : ScrollArrowDown_overSkin.
ComboBox
  
downArrowUpSkin
データ型: Class
スクロールバーの下矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。 デフォルト値 : ScrollArrowDown_upSkin.
ComboBox
  
downSkin
データ型: Class
マウスボタンがダウン状態の場合に、ComboBox コンポーネントに表示される背景を指定するクラスの名前です。 デフォルト値 : ComboBox_downSkin.
ComboBox
  
embedFonts
データ型: Boolean
埋め込みフォントのアウトラインが、テキストフィールドのレンダリングに使用されるかどうかを示します。 値が true の場合、Flash Player は埋め込みフォントアウトラインを使用してテキストフィールドをレンダリングします。 値が false である場合は、デバイスフォントを使用してテキストフィールドをレンダリングします。

テキストフィールドの embedFonts プロパティを true に設定する場合、テキストフィールドに適用される TextFormat オブジェクトの font プロパティを使用して、そのテキストのフォントを指定する必要があります。 指定したフォントが SWF ファイルに埋め込まれていない場合、テキストは表示されません。

デフォルト値 : false.
ComboBox
 Inherited データ型: Number   形式: Length
コンポーネント領域の外側とフォーカスインジケータ領域のエッジを区切るパディングです (ピクセル単位)。
UIComponent
 Inherited データ型: Class
フォーカスインジケータの表示に使用されるスキンです。
UIComponent
  
overSkin
データ型: Class
カーソルがコンポーネントの上にある場合に、ComboBox コンポーネントに表示される背景を指定するクラスの名前です。 デフォルト値 : ComboBox_overSkin.
ComboBox
  
repeatDelay
データ型: Number   形式: Time
buttonDown イベントが最初に送出されてから 2 番目の buttonDown イベントを送出するまでの待機時間です (ミリ秒単位)。 デフォルト値 : 500.
ComboBox
  
repeatInterval
データ型: Number   形式: Time
buttonDown イベントを再送出するまでの待機時間を repeatDelay スタイルに指定します (ミリ秒単位)。 デフォルト値 : 35.
ComboBox
 Inherited データ型: flash.text.TextFormat
コンポーネントラベルのレンダリングに使用される TextFormat オブジェクトです。
UIComponent
  
textPadding
データ型: Number   形式: Length
境界と選択されたアイテムを表すテキストを区切る間隔です (ピクセル単位)。 デフォルト値 : 3.
ComboBox
  
thumbArrowUpSkin
データ型: Class
スクロールバーのサムのスキンとして使用するクラスの名前です。 デフォルト値 : ScrollThumb_upSkin.
ComboBox
  
thumbDisabledSkin
データ型: Class
サムの無効状態を示すために使用されるスキンです。 デフォルト値 : ScrollThumb_upSkin.
ComboBox
  
thumbDownSkin
データ型: Class
サムをクリックしたときに、スクロールバーのサムのスキンとして使用するクラスの名前です。 デフォルト値 : ScrollThumb_downSkin.
ComboBox
  
thumbIcon
データ型: Class
スクロールバーのサムのアイコンとして使用するクラスの名前です。 デフォルト値 : ScrollBar_thumbIcon.
ComboBox
  
thumbOverSkin
データ型: Class
スクロールバーのサムにマウスポインタを合わせたときに、そのサムのスキンとして使用するクラスの名前です。 デフォルト値 : ScrollThumb_overSkin.
ComboBox
  
trackDisabledSkin
データ型: Class
無効なトラックを示すために使用されるスキンです。 デフォルト値 : ScrollTrack_Skin.
ComboBox
  
trackDownSkin
データ型: Class
無効なスキンのダウン状態を示すために使用されるスキンです。 デフォルト値 : ScrollTrack_Skin.
ComboBox
  
trackOverSkin
データ型: Class
スクロールトラック上にマウスが配置されていることを示すために使用されるスキンです。 デフォルト値 : ScrollTrack_Skin.
ComboBox
  
trackUpSkin
データ型: Class
スクロールトラックのマウスのアップ状態を示すために使用されるスキンです。 デフォルト値 : ScrollTrack_Skin.
ComboBox
  
upArrowDisabledSkin
データ型: Class
スクロールバーの上矢印ボタンが無効になったときに、その上矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。 デフォルト値 : ScrollArrowUp_disabledSkin.
ComboBox
  
upArrowDownSkin
データ型: Class
スクロールバーの上矢印ボタンをクリックしたときに、その上矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。 デフォルト値 : ScrollArrowUp_downSkin.
ComboBox
  
upArrowOverSkin
データ型: Class
スクロールバーの上矢印ボタンにマウスポインタを合わせたときに、その上矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。 デフォルト値 : ScrollArrowUp_overSkin.
ComboBox
  
upArrowUpSkin
データ型: Class
スクロールバーの上矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。 デフォルト値 : ScrollArrowUp_upSkin.
ComboBox
  
upSkin
データ型: Class
ComboBox コンポーネントの背景を指定するクラスの名前です。 デフォルト値 : ComboBox_upSkin.
ComboBox
プロパティの詳細
dataProviderプロパティ
dataProvider:DataProvider  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

表示されるアイテムのリストのデータモデルを取得または設定します。データプロバイダは、複数のリストコンポーネントで共有できます。 データプロバイダへの変更は、このデータプロバイダをデータソースとして使用しているすべてのコンポーネントに対して直ちに有効になります。


実装
    public function get dataProvider():DataProvider
    public function set dataProvider(value:DataProvider):void

関連項目




次の例は、ComboBox のデータプロバイダを設定する方法を示します。データプロバイダが更新されると、ComboBox も更新されます。

import fl.controls.ComboBox;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();

var cb:ComboBox = new ComboBox();
cb.dataProvider = dp;
addChild(cb);

var counter = 0;
var t:Timer = new Timer(500);
t.addEventListener(TimerEvent.TIMER,addAnotherItem);
t.start();

function addAnotherItem(e:TimerEvent = null):void {
    dp.addItem( { label: "Item " + counter++ } );
}
dropdownプロパティ 
dropdown:List  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ComboBox コンポーネントが含む List コンポーネントへの参照を取得します。List サブコンポーネントは、表示する必要が生じるまで ComboBox 内でインスタンス化されません。ただし、dropdown プロパティがアクセスされた場合は、リストが作成されます。


実装
    public function get dropdown():List
dropdownWidthプロパティ 
dropdownWidth:Number  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ドロップダウンリストの最大幅 (ピクセル単位) を取得または設定します。このプロパティのデフォルト値は、ComboBox コンポーネントの幅です。つまり、TextInput インスタンスの幅と BaseButton インスタンスの幅を合わせた値です。

デフォルト値 : 100.


実装
    public function get dropdownWidth():Number
    public function set dropdownWidth(value:Number):void



次の例では、ComboBox コンポーネントインスタンスを作成し、Slider コンポーネントの値に基づいて dropdownWidth プロパティを設定します。

import fl.controls.ComboBox;
import fl.controls.Slider;
import fl.events.SliderEvent;

var mySlider:Slider = new Slider();
mySlider.minimum = 50;
mySlider.maximum = 150;
mySlider.liveDragging = true;
mySlider.snapInterval = 5;
mySlider.tickInterval = 10;
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
mySlider.move(10, 10);
addChild(mySlider);

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item A"});
myComboBox.addItem({label:"Item B"});
myComboBox.move(10, 30);
addChild(myComboBox);

mySlider.value = myComboBox.dropdownWidth;

function changeHandler(event:SliderEvent):void {
    myComboBox.dropdownWidth = event.value;
}

次の例では、ComboBox コンポーネントインスタンスを作成し、ドロップダウンリストのテキストの長さに基づいて dropdownWidth プロパティを設定します。

import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"The quick brown fox"});
myComboBox.addItem({label:"Lorem ipsum"});
myComboBox.addItem({label:"Little Miss Muffet"});
myComboBox.addItem({label:"Goldilocks and the three bears"});
myComboBox.addItem({label:"Jack and Jill"});
myComboBox.move(10, 30);
addChild(myComboBox);

var maxLength:Number = 0;
var i:uint;
for (i = 0; i < myComboBox.length; i++) {
    myComboBox.selectedIndex = i;
    myComboBox.drawNow();
    var currText:String = myComboBox.text;
    var currWidth:Number = myComboBox.textField.textWidth;
    maxLength = Math.max(currWidth, maxLength);
    trace(currText, currWidth, maxLength);
}

myComboBox.selectedIndex = -1;
myComboBox.dropdownWidth = maxLength + 20;
myComboBox.open();
editableプロパティ 
editable:Boolean  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ComboBox コンポーネントが編集可能または読み取り専用のいずれであるかを示すブール値を取得または設定します。true の値は、ComboBox コンポーネントが編集可能であることを示します。false の値は、ComboBox コンポーネントが編集可能でないことを示します。

編集可能な ComboBox コンポーネントの場合は、ドロップダウンリストに含まれていない値もテキストボックスに入力できます。リスト内に含まれるアイテムのテキストがテキストボックスに表示されます。ComboBox コンポーネントが編集可能でない場合は、テキストをテキストボックスには入力できません。

デフォルト値 : false.


実装
    public function get editable():Boolean
    public function set editable(value:Boolean):void



次の例では、enter イベントが送出されたとき、データプロバイダにカスタムアイテムを追加する新しい編集可能な ComboBox インスタンスを作成します。

import fl.controls.ComboBox;
import fl.data.DataProvider;
import fl.events.ComponentEvent;

var dp:DataProvider = new DataProvider();

var myComboBox:ComboBox = new ComboBox;
myComboBox.dataProvider = dp;
myComboBox.editable = true;
myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler);
myComboBox.move(10, 10);
addChild(myComboBox);

function enterHandler(event:ComponentEvent):void {
    var myCB:ComboBox = event.currentTarget as ComboBox;
    dp.addItem({label:myCB.text});
    myCB.text = "";
    myCB.sortItemsOn("label", Array.CASEINSENSITIVE);
}
labelFieldプロパティ 
labelField:String  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

TextInput フィールドとドロップダウンリストのラベルとして表示される dataProvider オブジェクトのフィールドの名前を取得または設定します。

デフォルトで、コンポーネントは label プロパティを各 dataProvider アイテムのプロパティとして表示します。dataProvider アイテムに label プロパティが含まれない場合は、別のプロパティを使用するように labelField プロパティを設定できます。

メモ : labelField プロパティは、labelFunction プロパティがコールバック関数に設定されている場合は使用されません。

デフォルト値 : "label".


実装
    public function get labelField():String
    public function set labelField(value:String):void

関連項目




次の例では、ComboBox を作成し、labelField プロパティを設定してカスタムラベルフィールドを設定します。

import fl.controls.ComboBox;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem({firstName:"Jane", lastName:"Doe"}); 
dp.addItem({firstName:"Bill", lastName:"Smith"});
dp.addItem({firstName:"Tim", lastName:"Jones"});
dp.sortOn(["firstName","lastName"]);

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.labelField = "firstName";
myComboBox.move(10, 10);
addChild(myComboBox);
labelFunctionプロパティ 
labelFunction:Function  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アイテムのラベルの取得に使用される関数を取得または設定します。

デフォルトで、コンポーネントは label プロパティを dataProvider アイテムのプロパティとして表示します。ただし、一部のデータセットには、label がない場合や、値を変更しないでラベルとして使用できるフィールドがない場合があります。たとえば、指定されたデータセットは完全名を格納しますが、lastName フィールドと firstName フィールドで維持します。この場合には、このプロパティを使用して、lastName フィールドと firstName フィールドの値を連結し、表示される完全名のストリングにするコールバック関数を設定できます。

メモ : labelField プロパティは、labelFunction プロパティがコールバック関数に設定されている場合は使用されません。


実装
    public function get labelFunction():Function
    public function set labelFunction(value:Function):void

関連項目




この例では、リストの labelFunction プロパティを各セルに表示されるストリングをフォーマットする関数に設定します。
import fl.data.DataProvider;
import fl.controls.List;

var myDataProvider:DataProvider = new DataProvider();
myDataProvider.addItem({name:"User A", price:0.43});
myDataProvider.addItem({name:"User B", price:0.34});

var users:List = new List();
users.dataProvider = myDataProvider;
users.labelFunction = myLabelFunction;
addChild(users);

function myLabelFunction(item:Object):String {
    return  item.name + " ($" + item.price.toFixed(2) + ")";
}

次の例では、ComboBox を作成し、labelField プロパティを設定してカスタムラベルフィールドを設定します。

import fl.controls.ComboBox;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem({firstName:"Jane", lastName:"Doe"}); 
dp.addItem({firstName:"Bill", lastName:"Smith"});
dp.addItem({firstName:"Tim", lastName:"Jones"});
dp.sortOn(["lastName", "firstName"]);

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.labelFunction = nameLabelFunction;
myComboBox.move(10, 10);
addChild(myComboBox);

function nameLabelFunction(item:Object):String {
    return item.lastName + ", " + item.firstName;
}
lengthプロパティ 
length:int  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

リスト内の項目の数を取得します。このプロパティは List コンポーネントに属しますが、ComboBox インスタンスからアクセスできます。

デフォルト値 : 0.


実装
    public function get length():int

関連項目




次の例では、ComboBox を作成し、ComboBox 内のアイテム数に基づいて rowCount プロパティを設定します。

import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item A"});
myComboBox.addItem({label:"Item B"});
myComboBox.addItem({label:"Item C"});
myComboBox.addItem({label:"Item D"});
myComboBox.addItem({label:"Item E"});
myComboBox.addItem({label:"Item F"});
myComboBox.rowCount = myComboBox.length / 2;
addChild(myComboBox);

次の例では、ComboBox を作成し、ComboBox 内のアイテム数に基づいて rowCount プロパティを設定します。

import fl.controls.ComboBox;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem({label:"Item A"});
dp.addItem({label:"Item B"});
dp.addItem({label:"Item C"});
dp.addItem({label:"Item D"});
dp.addItem({label:"Item E"});
dp.addItem({label:"Item F"});

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.rowCount = myComboBox.length / 2;
addChild(myComboBox);
promptプロパティ 
prompt:String  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ComboBox コンポーネントのプロンプトを取得または設定します。この prompt は、selectedIndex が -1 のときに ComboBox の TextInput 部分に表示されるストリングです。通常、"Select one..." のようなストリングになります。prompt が設定されていない場合は、ComboBox コンポーネントは selectedIndex プロパティを 0 に設定し、dataProvider プロパティ内の最初のアイテムを表示します。

デフォルト値 : "".


実装
    public function get prompt():String
    public function set prompt(value:String):void



次の例では、ComboBox コンポーネントインスタンスを作成し、prompt プロパティを設定し、プロンプトのテキスト幅に合わせてコンボボックスのサイズを変更します。

import fl.controls.ComboBox;

var cbStyles:Object = ComboBox.getStyleDefinition();
var bW:Number = cbStyles.buttonWidth as Number

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Please select an option...";
myComboBox.addItem({label:"Option 1"});
myComboBox.addItem({label:"Option 2"});
myComboBox.drawNow();
myComboBox.width = myComboBox.textField.textWidth + 35;
myComboBox.dropdownWidth = myComboBox.width - bW;
myComboBox.move(10, 10);
addChild(myComboBox);

次の例では、ComboBox コンポーネントインスタンスを作成し、データプロバイダのアイテム数に基づいて prompt プロパティを設定します。

import fl.controls.ComboBox;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem({label:"Getting Started"});
dp.addItem({label:"New Features"});
dp.addItem({label:"ActionScript"});
dp.addItem({label:"Components"});
dp.sortOn("label", Array.CASEINSENSITIVE);

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Topics (" + dp.length + ")";
myComboBox.dataProvider = dp;
myComboBox.width = 150;
myComboBox.move(10, 10);
addChild(myComboBox);
restrictプロパティ 
restrict:String  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

テキストフィールドにユーザーが入力できる文字を取得または設定します。restrict プロパティの値が文字のストリングである場合は、そのストリング内の文字のみをテキストフィールドに入力できます。ストリングは左から右に読み取られます。restrict プロパティの値が null の場合は、任意の文字を入力できます。restrict プロパティの値が空のストリング ("") の場合は、いずれの文字も入力できません。ハイフン (-) 文字を使用して、範囲を指定できます。これはユーザー入力のみを制限します。スクリプトは任意の文字をテキストフィールドに入力できます。

デフォルト値 : null.


実装
    public function get restrict():String
    public function set restrict(value:String):void

関連項目




次の例では、restrict プロパティを使用して、16 進数のカラー値だけを入力できる編集可能な ComboBox コンポーネントを作成します。

import fl.controls.ComboBox;
import fl.data.DataProvider;
import fl.events.ComponentEvent;

var dp:DataProvider = new DataProvider();

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.editable = true;
myComboBox.restrict = "0-9A-F";
myComboBox.textField.maxChars = 6;
myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler);
myComboBox.move(10, 10);
addChild(myComboBox);

function enterHandler(event:ComponentEvent):void {
    var colorStr:String = ComboBox(event.currentTarget).text;
    var colorNum:uint = uint("0x" + colorStr);
    dp.addItem({label:colorStr, value:colorNum});
    dp.sortOn("value", Array.NUMERIC);
    event.currentTarget.text = "";
}
rowCountプロパティ 
rowCount:uint  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

スクロールバーを持たないドロップダウンリストに表示できる最大行数を取得または設定します。ドロップダウンリスト内のアイテムの数がこの値を超えると、リストのサイズが変更され、必要に応じてスクロールバーが表示されます。ドロップダウンリスト内のアイテムの数がこの値より小さい場合、ドロップダウンリストのサイズは、現在含んでいるアイテムの数に合うように変更されます。

これは List コンポーネントの動作とは異なります。List コンポーネントでは、領域が余ってしまう場合でも、必ず rowCount プロパティで指定した行数が表示されます。

デフォルト値 : 5.


実装
    public function get rowCount():uint
    public function set rowCount(value:uint):void

関連項目




次の例では、Slider コンポーネントを使用して、ComboBox コンポーネントの rowCount プロパティを設定します。

import fl.controls.ComboBox;
import fl.controls.Slider;
import fl.events.SliderEvent;

var numItems:uint = 8;

var mySlider:Slider = new Slider();
mySlider.tickInterval = 1;
mySlider.snapInterval = 1;
mySlider.minimum = 1;
mySlider.maximum = numItems;
mySlider.liveDragging = true;
mySlider.move(10, 10);
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);

var myComboBox:ComboBox = new ComboBox();
myComboBox.move(10, 30);
addChild(myComboBox);

var i:uint;
for (i = 0; i < numItems; i++) {
    myComboBox.addItem({label:"Item " + i});
}

function changeHandler(event:SliderEvent):void {
    myComboBox.rowCount = event.value;
}
selectedIndexプロパティ 
selectedIndex:int  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

単一選択リストで選択されたアイテムのインデックスを取得または設定します。単一リストは、一度に 1 つのアイテムだけを選択できるリストです。

-1 の値は、アイテムが選択されていないことを示します。複数の選択が行われている場合、この値は選択されたグループの最後に選択されたアイテムのインデックスに等しくなります。

ActionScript を使用してこのプロパティを設定すると、指定されたインデックス位置のアイテムが現在の選択を置き換えます。選択がプログラムで変更されたときには、change イベントオブジェクトは送出されません。

デフォルト値 : 0.


実装
    public function get selectedIndex():int
    public function set selectedIndex(value:int):void

関連項目




次の例では、Slider コンポーネントを使用して、ComboBox コンポーネントインスタンスの selectedIndex プロパティを設定します。

import fl.controls.ComboBox;
import fl.controls.Slider;
import fl.data.DataProvider;
import fl.events.SliderEvent;

var items:XML = <items>
        <item label="Item 1" />
        <item label="Item 2" />
        <item label="Item 3" />
        <item label="Item 4" />
    </items>;

var dp:DataProvider = new DataProvider(items);

var mySlider:Slider = new Slider();
mySlider.liveDragging = true;
mySlider.tickInterval = 1;
mySlider.snapInterval = 1;
mySlider.minimum = 0;
mySlider.maximum = dp.length - 1;
mySlider.width = 100;
mySlider.move(10, 10);
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.move(10, 30);
addChild(myComboBox);

function changeHandler(event:SliderEvent):void {
    myComboBox.selectedIndex = event.value;
}

次の例では、ComboBox コンポーネントを作成し、その selectedIndex プロパティの値をステージ上のラベルに表示します。

import fl.controls.ComboBox;
import fl.controls.Label;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Please select an item...";
myComboBox.addItem({label:"Item 1"});
myComboBox.addItem({label:"Item 2"});
myComboBox.addItem({label:"Item 3"});
myComboBox.addItem({label:"Item 4"});
myComboBox.width = 150;
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myComboBox);

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "selectedIndex:" + myComboBox.selectedIndex;
myLabel.move(myComboBox.x + myComboBox.width + 10, myComboBox.y);
addChild(myLabel);

function changeHandler(event:Event):void {
    myLabel.text = "selectedIndex:" + myComboBox.selectedIndex;
}
selectedItemプロパティ 
selectedItem:Object  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ドロップダウンリストで選択されているアイテムの値を取得または設定します。ユーザーが編集可能な ComboBox コンポーネントのテキストボックスにテキストを入力すると、selectedItem プロパティは undefined になります。このプロパティが値を持つのは、ユーザーがドロップダウンリストからアイテムを選択する場合か、ActionScript を使用してドロップダウンリストからアイテムを選択する場合のみです。ComboBox コンポーネントが編集可能でない場合、selectedItem プロパティの値は常に有効です。編集可能な ComboBox コンポーネントのドロップダウンリストにアイテムがない場合、このプロパティの値は null になります。

デフォルト値 : null.


実装
    public function get selectedItem():Object
    public function set selectedItem(value:Object):void

関連項目




次の例では、Button コンポーネントを使用して、ComboBox のアイテムを List にコピーします。

import fl.controls.Button;
import fl.controls.ComboBox;
import fl.controls.List;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Select an item";
myComboBox.addItem({label:"Item A"});
myComboBox.addItem({label:"Item B"});
myComboBox.addItem({label:"Item C"});
myComboBox.move(10, 10);
addChild(myComboBox);

var myButton:Button = new Button();
myButton.label = "Copy";
myButton.move(myComboBox.x + myComboBox.width + 10, myComboBox.y);
myButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(myButton);

var myList:List = new List();
myList.rowCount = myList.length;
myList.selectable = false;
myList.move(myComboBox.x, myComboBox.y + myComboBox.height + 10);
addChild(myList);

function clickHandler(event:MouseEvent):void {
    if (myComboBox.selectedIndex > -1) {
        myList.addItem(myComboBox.selectedItem);
        myList.rowCount = myList.length;
    }
}

次の例では、2 つの Label コンポーネントを使用して、現在選択されている ComboBox のアイテムを表示します。

import fl.controls.ComboBox;
import fl.controls.Label;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Select a user:";
myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); 
myComboBox.addItem({firstName:"Bill", lastName:"Smith"});
myComboBox.addItem({firstName:"Tim", lastName:"Jones"});
myComboBox.labelFunction = nameLabelFunction;
myComboBox.width = 120;
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myComboBox);

var firstNameLabel:Label = new Label();
firstNameLabel.text = "";
firstNameLabel.autoSize = TextFieldAutoSize.LEFT;
firstNameLabel.move(myComboBox.x, myComboBox.y + myComboBox.height);
addChild(firstNameLabel);

var lastNameLabel:Label = new Label();
lastNameLabel.text = "";
lastNameLabel.autoSize = TextFieldAutoSize.LEFT;
lastNameLabel.move(firstNameLabel.x, firstNameLabel.y + firstNameLabel.height);
addChild(lastNameLabel);

function changeHandler(event:Event):void {
    var cb:ComboBox = event.currentTarget as ComboBox;
    var item:Object = cb.selectedItem;
    if (cb.selectedIndex > -1) {
        firstNameLabel.text = item.firstName;
        lastNameLabel.text = item.lastName;
    }
}

function nameLabelFunction(item:Object):String {
    return item.lastName + ", " + item.firstName;
}
selectedLabelプロパティ 
selectedLabel:String  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ComboBox コンポーネントの TextInput 部分に表示されるストリングを取得します。この値は、labelField プロパティか labelFunction プロパティを使用して、データから計算されます。


実装
    public function get selectedLabel():String

関連項目




次の例では、Label コンポーネントを使用して、ComboBox の selectedLabel プロパティを表示します。

import fl.controls.ComboBox;
import fl.controls.Label;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Select a user:";
myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); 
myComboBox.addItem({firstName:"Bill", lastName:"Smith"});
myComboBox.addItem({firstName:"Tim", lastName:"Jones"});
myComboBox.labelFunction = nameLabelFunction;
myComboBox.width = 120;
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myComboBox);

var myLabel:Label = new Label();
myLabel.text = "";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.move(myComboBox.x, myComboBox.y + myComboBox.height);
addChild(myLabel);

function changeHandler(event:Event):void {
    var cb:ComboBox = event.currentTarget as ComboBox;
    myLabel.text = "selectedLabel: " + cb.selectedLabel;
}

function nameLabelFunction(item:Object):String {
    return item.lastName + ", " + item.firstName;
}
textプロパティ 
text:String  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

編集可能な ComboBox コンポーネントのテキストボックスが含むテキストを取得または設定します。編集可能でない ComboBox コンポーネントの場合、この値は読み取り専用です。

デフォルト値 : "".


実装
    public function get text():String
    public function set text(value:String):void



次の例では、TextArea コンポーネントインスタンスに入力されるテキストを表示する編集可能な ComboBox を作成します。

import fl.controls.ComboBox;
import fl.controls.TextArea;
import fl.events.ComponentEvent;

var myComboBox:ComboBox = new ComboBox();
myComboBox.editable = true;
myComboBox.addEventListener(TextEvent.TEXT_INPUT, textInputHandler);
myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler);
myComboBox.width = 300;
myComboBox.move(10, 10);
addChild(myComboBox);

var myTextArea:TextArea = new TextArea();
myTextArea.wordWrap = false;
myTextArea.setSize(300, 200);
myTextArea.move(myComboBox.x, myComboBox.y + myComboBox.height + 10);
addChild(myTextArea)

function textInputHandler(event:TextEvent):void {
    myTextArea.appendText(event.type + ":\n");
    myTextArea.appendText("\t" + event.currentTarget.text + "\n");
    myTextArea.appendText("\t" + event.text + "\n");
    myTextArea.appendText("\n");
    
    autoScroll(myTextArea);
}

function enterHandler(event:ComponentEvent):void {
    myTextArea.appendText(event.type + ":\n");
    myTextArea.appendText("\t" + event.currentTarget.text + "\n");
    myTextArea.appendText("\n");
    autoScroll(myTextArea);
}

function autoScroll(ta:TextArea):void {
    ta.verticalScrollPosition = ta.maxVerticalScrollPosition;
}
textFieldプロパティ 
textField:TextInput  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ComboBox コンポーネントが含む TextInput コンポーネントへの参照を取得します。このプロパティを使用して、基になっている TextInput コンポーネントをアクセスおよび操作します。たとえば、このプロパティを使用してテキストボックスの選択を変更したり、テキストボックスに入力できる文字のセットを制限したりできます。


実装
    public function get textField():TextInput



次の例では、8 文字のみ入力できる編集可能な ComboBox コンポーネントを作成します。

import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.editable = true;
myComboBox.textField.maxChars = 8;
myComboBox.move(10, 10);
addChild(myComboBox);

次の例では、ComboBox を作成し、埋め込みテキストフィールドのテキストフォーマットを設定します。

import fl.controls.ComboBox;

var comicSansTF:TextFormat = new TextFormat();
comicSansTF.font = "Comic Sans MS";

var myComboBox:ComboBox = new ComboBox();
myComboBox.textField.setStyle("textFormat", comicSansTF);
myComboBox.addItem({label:"Item A"});
myComboBox.addItem({label:"Item B"});
myComboBox.addItem({label:"Item C"});
myComboBox.addItem({label:"Item D"});
myComboBox.move(10, 10);
addChild(myComboBox);

次の例では、ComboBox コンポーネントインスタンスを作成し、埋め込みテキストフィールドとドロップダウンメニューのカスタムテキストフォーマットを設定します。

import fl.controls.ComboBox;
import fl.data.DataProvider;

var myTextFormat:TextFormat = new TextFormat();
myTextFormat.font = "Comic Sans MS";
myTextFormat.color = 0xFF0000;

var fontArray:Array = Font.enumerateFonts(true);
fontArray.sortOn("fontName", Array.CASEINSENSITIVE);

var dp:DataProvider = new DataProvider(fontArray);

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.dropdown.iconField = null;
myComboBox.labelField = "fontName";
myComboBox.textField.setStyle("textFormat", myTextFormat);
myComboBox.dropdown.setRendererStyle("textFormat", myTextFormat);
myComboBox.width = 200;
myComboBox.move(10, 10);
addChild(myComboBox);
valueプロパティ 
value:String  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

編集可能な ComboBox コンポーネント内のアイテムのラベルを取得します。編集可能でない ComboBox コンポーネントの場合、このプロパティは、アイテムに含まれているデータを取得します。


実装
    public function get value():String



次の例では、Label コンポーネントを使用して、編集可能な ComboBox の value プロパティを表示します。

import fl.controls.ComboBox;
import fl.controls.Label;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Select a user:";
myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); 
myComboBox.addItem({firstName:"Bill", lastName:"Smith"});
myComboBox.addItem({firstName:"Tim", lastName:"Jones"});
myComboBox.labelFunction = nameLabelFunction;
myComboBox.width = 120;
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.CHANGE, changeHandler);
myComboBox.editable = true;
addChild(myComboBox);

var myLabel:Label = new Label();
myLabel.text = "";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.move(myComboBox.x, myComboBox.y + myComboBox.height);
addChild(myLabel);

function changeHandler(event:Event):void {
    var cb:ComboBox = event.currentTarget as ComboBox;
    myLabel.text = "value: " + cb.value;
}

function nameLabelFunction(item:Object):String {
    var str:String;
    if (item == null) {
        str = myComboBox.value;
    } else {
        str = item.lastName + ", " + item.firstName;
    }
    return str;
}
コンストラクタの詳細
ComboBox()コンストラクタ
public function ComboBox()

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ComboBox コンポーネントの新しいインスタンスを作成します。

メソッドの詳細
addItem()メソッド
public function addItem(item:Object):void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アイテムのリストの末尾にアイテムを追加します。

アイテムは、label プロパティと data プロパティを含む必要があります。ただし、他のプロパティを含むアイテムもリストに追加できます。デフォルトで、アイテムの label プロパティを使用して行のラベルを表示します。data プロパティを使用して行のデータを格納します。

パラメータ

item:Object — データプロバイダに追加されるアイテムです。

関連項目

addItemAt()メソッド 
public function addItemAt(item:Object, index:uint):void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

指定されたインデックス位置のリストにアイテムを挿入します。指定されたインデックス位置にあるアイテムまたはそれより後にあるアイテムのインデックスは、1 だけインクリメントされます。

パラメータ

item:Object — リストに追加されるアイテムです。
 
index:uint — アイテムを追加するインデックス位置です。

関連項目

close()メソッド 
public function close():void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ドロップダウンリストを閉じます。

メモ : このメソッドを呼び出すと、close イベントが送出されます。ComboBox が既に閉じられている場合は、このメソッドを呼び出しても無効です。

関連項目




次の例では、ComboBox コンポーネントインスタンスを作成し、open() メソッドと close() メソッドを使用して、ドロップダウンメニューの表示と非表示を切り替えます。

import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item 1"});
myComboBox.addItem({label:"Item 2"});
myComboBox.addItem({label:"Item 3"});
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.OPEN, openHandler);
myComboBox.addEventListener(Event.CLOSE, closeHandler);
addChild(myComboBox);

var isOpen:Boolean = false;

var timer:Timer = new Timer(1000);
timer.addEventListener(TimerEvent.TIMER, timerHandler);
timer.start();

function openHandler(event:Event):void {
    isOpen = true;
}

function closeHandler(event:Event):void {
    isOpen = false;
}

function timerHandler(event:TimerEvent):void {
    if (isOpen) {
        myComboBox.close();
    } else {
        myComboBox.open();
    }
}
getItemAt()メソッド 
public function getItemAt(index:uint):Object

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

指定されたインデックス位置のアイテムを取得します。

パラメータ

index:uint — 取得されるアイテムのインデックスです。

戻り値
Object — 指定されたインデックス位置にあるオブジェクトです。



次の例では、ComboBox コンポーネントインスタンスを作成し、for loop と getItemAt() メソッドを使用して、ComboBox のアイテムを DataGrid コンポーネント内にコピーします。

import fl.controls.ComboBox;
import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item 1", price:0.34});
myComboBox.addItem({label:"Item 2", price:13.19});
myComboBox.addItem({label:"item 3", price:2.96});
myComboBox.addItem({label:"Item 4", price:3.49});
myComboBox.addItem({label:"Item 5", price:1.27});
myComboBox.move(10, 10);
addChild(myComboBox);

var indexCol:DataGridColumn = new DataGridColumn("index");
indexCol.headerText = "";
indexCol.sortOptions = Array.NUMERIC;

var labelCol:DataGridColumn = new DataGridColumn("label");
labelCol.sortOptions = Array.CASEINSENSITIVE;

var priceCol:DataGridColumn = new DataGridColumn("price");
priceCol.sortOptions = Array.NUMERIC;

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn(indexCol);
myDataGrid.addColumn(labelCol);
myDataGrid.addColumn(priceCol);
myDataGrid.move(10, 40);
myDataGrid.rowCount = myComboBox.length;
myDataGrid.width = 180;
addChild(myDataGrid);

var i:uint;
var item:Object;
for (i = 0; i < myComboBox.length; i++) {
    item = myComboBox.getItemAt(i);
    myDataGrid.addItem({index:i, label:item.label, price:item.price});
}
getStyleDefinition()メソッド 
public static function getStyleDefinition():Object

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

現在のコンポーネントのデフォルトスタイルマップを取得します。スタイルマップには、使用されているスタイルに基づき、コンポーネントの適切な型が保持されます。たとえば、disabledTextFormat スタイルには、null または TextFormat オブジェクトの値が保持されます。現在のコンポーネントに対し、これらのスタイルを使用して、setStyle() を呼び出すことができます。次のコードでは、指定したコンポーネントのデフォルトの disabledTextFormat スタイルがオーバーライドされます。

componentInstance.setStyle("disabledTextFormat", new TextFormat());

戻り値
Object — デフォルトスタイルのオブジェクトです。

関連項目




次の例では、複数のコンポーネントクラス用のスタイルブラウザを作成します。
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}
itemToLabel()メソッド 
public function itemToLabel(item:Object):String

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

labelField プロパティと labelFunction プロパティに基づいて、指定されたデータオブジェクトに対してレンダラーが表示するストリングを取得します。

メモ : labelField は、labelFunction プロパティがコールバック関数に設定されている場合は使用されません。

パラメータ

item:Object — レンダリングされるオブジェクトです。

戻り値
String — データに応じて表示されるストリングです。

関連項目

open()メソッド 
public function open():void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ドロップダウンリストを開きます。

メモ : このメソッドを呼び出すと、open イベントが送出されます。ComboBox コンポーネントが既に開かれている場合は、このメソッドを呼び出しても無効です。

関連項目

removeAll()メソッド 
public function removeAll():void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

リストからすべてのアイテムを削除します。

関連項目




次の例では、Button コンポーネントインスタンスを使用して、removeAll() メソッドで ComboBox のアイテムを削除します。

import fl.controls.Button;
import fl.controls.ComboBox;
import fl.controls.TextInput;

var greenTF:TextFormat;
var redTF:TextFormat;
var myTextInput:TextInput;
var addButton:Button;
var myComboBox:ComboBox;
var removeButton:Button;

greenTF = new TextFormat();
greenTF.color = 0x006600;

redTF = new TextFormat();
redTF.color = 0xFF0000;

myTextInput = new TextInput();
myTextInput.maxChars = 20;
myTextInput.restrict = "a-zA-Z";
myTextInput.move(10, 10);
addChild(myTextInput);

addButton = new Button();
addButton.label = "(+) Add";
addButton.setStyle("textFormat", greenTF);
addButton.move(120, 10);
addButton.addEventListener(MouseEvent.CLICK, addClickHandler);
addChild(addButton);

myComboBox = new ComboBox();
myComboBox.move(10, 40);
addChild(myComboBox);

removeButton = new Button();
removeButton.label = "(-) Remove All";
removeButton.setStyle("textFormat", redTF);
removeButton.move(120, 40);
removeButton.addEventListener(MouseEvent.CLICK, removeClickHandler);
addChild(removeButton);

function addClickHandler(event:MouseEvent):void {
    if (myTextInput.length > 0) {
        trace("adding item...");
        myComboBox.addItem({label:myTextInput.text});
        myComboBox.sortItemsOn("label", Array.CASEINSENSITIVE);
        myTextInput.text = "";
    }
}

function removeClickHandler(event:MouseEvent):void {
    trace("removing all items...");
    myComboBox.removeAll();
}
removeItem()メソッド 
public function removeItem(item:Object):Object

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

指定されたアイテムをリストから削除します。

パラメータ

item:Object — 削除されるアイテムです。

戻り値
Object — 削除されたアイテムです。

関連項目




次の例は、アイテムがクリックされたときにリストからそのアイテムを削除する方法を示します。
import fl.controls.List;
import fl.events.ListEvent;

var myList:List = new List();
myList.addItem( { label: "Carrot" } );
myList.addItem( { label: "Turnip" } );
myList.addItem( { label: "Tomato" } );
myList.addItem( { label: "Blueberry" } );
myList.addEventListener(ListEvent.ITEM_CLICK,removeSelectedItem);
addChild(myList);

function removeSelectedItem(e:ListEvent):void {
    myList.removeItem(e.item);
}
removeItemAt()メソッド 
public function removeItemAt(index:uint):void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

指定したインデックス位置のアイテムを削除します。指定されたインデックスより大きいアイテムのインデックス位置は、配列内を 1 つだけ前に進みます。

これは ComboBox コンポーネントのインスタンスから利用できる List コンポーネントのメソッドです。

パラメータ

index:uint — 削除されるアイテムのインデックスです。


例外
RangeError — 指定されたインデックスは、0 より小さいか、またはデータプロバイダの長さ以上です。

関連項目

replaceItemAt()メソッド 
public function replaceItemAt(item:Object, index:uint):Object

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

指定されたインデックス位置にあるアイテムを別のアイテムで置き換えます。このメソッドは、List コンポーネントのデータプロバイダを変更します。データプロバイダが他のコンポーネントと共有されている場合は、これらのコンポーネントに提供されるデータも更新されます。

パラメータ

item:Object — 指定されたインデックス位置で置き換えるアイテムです。
 
index:uint — 置き換えられるアイテムのインデックス位置です。

戻り値
Object — 置き換えられたアイテムです。



次の例では、replaceItemAt() メソッドを使用して、現在選択されている ComboBox のアイテムを TextInput コンポーネントの値に置き換えます。

import fl.controls.Button;
import fl.controls.ComboBox;
import fl.controls.TextArea;
import fl.controls.TextInput;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Select a user...";
myComboBox.addItem({label:"Person 1"});
myComboBox.addItem({label:"Person 2"});
myComboBox.addItem({label:"Person 3"});
myComboBox.addItem({label:"Person 4"});
myComboBox.width = 150;
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myComboBox);

var myTextInput:TextInput = new TextInput();
myTextInput.restrict = "a-zA-Z0-9";
myTextInput.maxChars = 12;
myTextInput.move(10, 40);
addChild(myTextInput)

var myButton:Button = new Button();
myButton.label = "Replace item";
myButton.addEventListener(MouseEvent.CLICK, clickHandler);
myButton.move(120, 40);
addChild(myButton);

var myTextArea:TextArea = new TextArea();
myTextArea.editable = false;
myTextArea.setSize(320, 240);
myTextArea.move(10, 70);
addChild(myTextArea);

function changeHandler(event:Event):void {
    myTextInput.text = myComboBox.selectedLabel;
}

function clickHandler(event:MouseEvent):void {
    var cIndex:int = myComboBox.selectedIndex;
    if (cIndex > -1) {
        var newItem:Object = {label:myTextInput.text};
        var oldItem:Object = myComboBox.replaceItemAt(newItem, cIndex);
        myComboBox.selectedIndex = cIndex;
        myTextArea.appendText("[index:" + cIndex + "] old:'" + oldItem.label +"', new:'" + newItem.label + "'\n");
        myTextArea.verticalScrollPosition = myTextArea.maxVerticalScrollPosition;
    }
}
sortItems()メソッド 
public function sortItems(... sortArgs):*

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

現在のデータプロバイダのエレメントを並べ替えます。このメソッドは、エレメントの Unicode 値に基づいて並べ替えを実行します。ASCII は Unicode のサブセットです。

パラメータ

... sortArgs — 並べ替える対象を示すパラメータです。

戻り値
* — 戻り値は、このメソッドにパラメータが渡されているかどうかによって異なります。詳細については、Array.sort() メソッドを参照してください。sortArgs パラメータが Array.UNIQUESORT に設定されている場合、このメソッドは 0 を返します。

関連項目




次の例では、各アイテムのラベルテキストに従って、ComboBox インスタンスのアイテムを並べ替えます。並べ替えるアイテムを、カスタムソート関数 upperCaseSort() に渡します。この関数は、2 つのアイテムの label プロパティを比較し、アイテムを表示する順序に従ってブール値を返します。
import fl.controls.ComboBox;

var cb:ComboBox = new ComboBox();
cb.addItem( { label: "Mercury" } );
cb.addItem( { label: "Venus" } );
cb.addItem( { label: "Earth" } );
cb.addItem( { label: "planet" } );
cb.sortItems(upperCaseSort);
addChild(cb);

function upperCaseSort(a:Object, b:Object):Boolean {
    return a.label.toUpperCase() > b.label.toUpperCase();
}
sortItemsOn()メソッド 
public function sortItemsOn(field:String, options:Object = null):*

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

現在のデータプロバイダのエレメントを 1 つまたは複数のフィールドで並べ替えます。

パラメータ

field:String — 並べ替えるフィールドです。
 
options:Object (default = null) — デフォルトのソート動作のオーバーライドに使用されるソートパラメータです。2 つ以上のパラメータをビット単位の OR (|) 演算子で区切ります。

戻り値
* — 戻り値は、このメソッドにパラメータが渡されているかどうかによって異なります。詳細については、Array.sortOn() メソッドを参照してください。sortOption パラメータが Array.UNIQUESORT に設定されている場合、このメソッドは 0 を返します。

関連項目




次の例では、cb という名前の ComboBox インスタンスを使用しています。この中には、"Apples""Bananas""cherries"、および "Grapes" というラベルの 4 つのエレメントが含まれています。
import fl.controls.ComboBox;

var cb:ComboBox = new ComboBox();
addChild(cb);

// First, populate the ComboBox with the elements.
cb.addItem( { label: "Bananas" } );
cb.addItem( { label: "Apples" } );
cb.addItem( { label: "cherries" } );
cb.addItem( { label: "Grapes" } );

// The following statement sorts using the order parameter set to "ASC", 
// and results in a sort that places "cherries" at the bottom of the list 
// because the sort is case-sensitive.
cb.sortItemsOn("label", "ASC"); 
// resulting order: Apples, Bananas, Grapes, cherries

// The following statement sorts using the order parameter set to "DESC", 
// and results in a sort that places "cherries" at the top of the list 
// because the sort is case-sensitive.
cb.sortItemsOn("label", "DESC");
// resulting order: cherries, Grapes, Bananas, Apples

// The following statement sorts using the optionsFlag parameter set to 
// Array.CASEINSENSITIVE. Note that an ascending sort is the default setting.
cb.sortItemsOn("label", Array.CASEINSENSITIVE);
// resulting order: Apples, Bananas, cherries, Grapes

// The following statement sorts using the optionsFlag parameter set to 
// Array.CASEINSENSITIVE | Array.DESCENDING.
cb.sortItemsOn("label", Array.CASEINSENSITIVE | Array.DESCENDING);
// resulting order: Grapes, cherries, Bananas, Apples

次の例では、ComboBox を作成し、sortItemsOn() メソッドを使用してアイテムを並べ替えます。

import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); 
myComboBox.addItem({firstName:"Bill", lastName:"Smith"});
myComboBox.addItem({firstName:"Tim", lastName:"Jones"});
myComboBox.sortItemsOn("lastName", Array.CASEINSENSITIVE);
myComboBox.labelFunction = nameLabelFunction;
myComboBox.move(10, 10);
addChild(myComboBox);

function nameLabelFunction(item:Object):String {
    return item.lastName + ", " + item.firstName;
}
イベントの詳細
change イベント
イベントオブジェクトの型: flash.events.Event
Event.type property = flash.events.Event.CHANGE

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ユーザーが ComboBox コンポーネントの選択を変更したときか、ComboBox コンポーネントが編集可能な場合に、ユーザーがテキストフィールドにキーストロークを入力するたびに送出されます。

type プロパティ (change イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblestrue
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
target値が変更されたオブジェクトです。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。
close イベント  
イベントオブジェクトの型: flash.events.Event
Event.type property = flash.events.Event.CLOSE

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

何らかの理由でドロップダウンリストが閉じられたときに送出されます。

type プロパティ (close イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
target接続が閉じられたオブジェクトです。



次の例では、ComboBox コンポーネントインスタンスを作成し、open() メソッドと close() メソッドを使用して、ドロップダウンメニューの表示と非表示を切り替えます。

import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item 1"});
myComboBox.addItem({label:"Item 2"});
myComboBox.addItem({label:"Item 3"});
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.OPEN, openHandler);
myComboBox.addEventListener(Event.CLOSE, closeHandler);
addChild(myComboBox);

var isOpen:Boolean = false;

var timer:Timer = new Timer(1000);
timer.addEventListener(TimerEvent.TIMER, timerHandler);
timer.start();

function openHandler(event:Event):void {
    isOpen = true;
}

function closeHandler(event:Event):void {
    isOpen = false;
}

function timerHandler(event:TimerEvent):void {
    if (isOpen) {
        myComboBox.close();
    } else {
        myComboBox.open();
    }
}

関連項目

enter イベント  
イベントオブジェクトの型: fl.events.ComponentEvent
ComponentEvent.type property = fl.events.ComponentEvent.ENTER

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

editable プロパティが true に設定されている場合に、ユーザーが編集可能なテキストフィールドへの入力中に Enter キーを押すと送出されます。

type プロパティ (enter イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
currentTargetイベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
targetイベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。
itemRollOut イベント  
イベントオブジェクトの型: fl.events.ListEvent
ListEvent.type property = fl.events.ListEvent.ITEM_ROLL_OUT

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ユーザーがコンポーネント内のアイテムからポインタを離したときに送出されます。

type プロパティ (itemRollOut イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
columnIndexレンダラーを含む列の 0 から始まるインデックスです。
currentTargetイベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
indexレンダラーを含んでいる DataProvider の 0 から始まるインデックスです。
itemレンダラーに属するデータへの参照です。
rowIndexレンダラーを含んでいる行の 0 から始まるインデックスです。
targetイベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。

関連項目

itemRollOver イベント  
イベントオブジェクトの型: fl.events.ListEvent
ListEvent.type property = fl.events.ListEvent.ITEM_ROLL_OVER

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ユーザーがコンポーネント内のアイテムにポインタを置いたときに送出されます。

type プロパティ (itemRollOver イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
columnIndexレンダラーを含む列の 0 から始まるインデックスです。
currentTargetイベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
indexレンダラーを含んでいる DataProvider の 0 から始まるインデックスです。
itemレンダラーに属するデータへの参照です。
rowIndexレンダラーを含んでいる行の 0 から始まるインデックスです。
targetイベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。



次の例では、ユーザーがコンポーネントのインスタンス上に移動したときに開く ComboBox コンポーネントを作成します。

import fl.controls.ComboBox;
import fl.controls.TextArea;
import fl.events.ListEvent;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item 1"});
myComboBox.addItem({label:"Item 2"});
myComboBox.addItem({label:"Item 3"});
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.OPEN, openHandler);
myComboBox.addEventListener(Event.CLOSE, closeHandler);
myComboBox.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
myComboBox.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOutHandler);
myComboBox.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler);
myComboBox.addEventListener(MouseEvent.ROLL_OUT, rollOutHandler);
myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OVER, dropdownRollOverHandler)
myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OUT, dropdownRollOutHandler);
addChild(myComboBox);

var myTextArea:TextArea = new TextArea();
myTextArea.editable = false;
myTextArea.setSize(320, 240);
myTextArea.move(120, 10);
addChild(myTextArea);

function openHandler(event:Event):void {
    logEvent("ComboBox open");
}

function closeHandler(event:Event):void {
    logEvent("ComboBox close");
}

function itemRollOverHandler(event:ListEvent):void {
    var rowIdx:uint = event.rowIndex as uint;
    logEvent("ComboBox itemRollOver: " + "`" + myComboBox.getItemAt(rowIdx).label + "`");
}

function itemRollOutHandler(event:ListEvent):void {
    var rowIdx:uint = event.rowIndex as uint;
    logEvent("ComboBox itemRollOut: " + "`" + myComboBox.getItemAt(rowIdx).label + "`");
}

function rollOverHandler(event:MouseEvent):void {
    logEvent("ComboBox rollOver");
    myComboBox.open();
}

function rollOutHandler(event:MouseEvent):void {
    logEvent("ComboBox rollOut");
    myComboBox.close();
}

function dropdownRollOverHandler(event:MouseEvent):void {
    logEvent("ComboBox.dropdown rollOver");
    // reopen ComboBox after it gets closed by the ComboBox rollOut event
    myComboBox.open();
}

function dropdownRollOutHandler(event:MouseEvent):void {
    logEvent("ComboBox.dropdown rollOut");
    myComboBox.close();
}

function logEvent(text:String):void {
    myTextArea.appendText(text + "\n");
    myTextArea.verticalScrollPosition = myTextArea.maxVerticalScrollPosition;
}

関連項目

open イベント  
イベントオブジェクトの型: flash.events.Event
Event.type property = flash.events.Event.OPEN

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ユーザーがドロップダウンボタンをクリックしてドロップダウンリストを表示したときに送出されます。また、ComboBox コンポーネントが編集可能でない場合に、ユーザーがテキストフィールドをクリックしたときにも送出されます。

type プロパティ (open イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
target接続をオープンしたネットワークオブジェクトです。



次の例では、open() メソッドを使用して、ComboBox コンポーネントのドロップダウンリストを開く Button コンポーネントを作成します。ドロップダウンメニューは、ユーザーがマウスポインタを ComboBox またはドロップダウンメニュー上に置かない限り、1 秒後に閉じます。

import fl.controls.Button;
import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item 1"});
myComboBox.addItem({label:"Item 2"});
myComboBox.addItem({label:"Item 3"});
myComboBox.move(10, 10);
myComboBox.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler);
myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler);
myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OUT, rollOutHandler);
addChild(myComboBox);

var myButton:Button = new Button();
myButton.emphasized = true;
myButton.label = "open ComboBox";
myButton.move(120, 10);
myButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(myButton);

var closeTimer:Timer = new Timer(1000, 1);
closeTimer.addEventListener(TimerEvent.TIMER_COMPLETE, timerCompleteHandler);

function clickHandler(event:MouseEvent):void {
    myComboBox.open();
    closeTimer.reset();
    closeTimer.start();
}

function timerCompleteHandler(event:TimerEvent):void {
    myComboBox.close();
}

function rollOverHandler(event:MouseEvent):void {
    closeTimer.stop();
}

function rollOutHandler(event:MouseEvent):void {
    myComboBox.close();
}

関連項目

scroll イベント  
イベントオブジェクトの型: fl.events.ScrollEvent
ScrollEvent.type property = fl.events.ScrollEvent.SCROLL

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ユーザーが ComboBox コンポーネントのドロップダウンリストをスクロールしたときに送出されます。

type プロパティ (scroll イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
currentTargetイベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
delta1。実行されたスクロールの量を示す値です。
directionvertical。ScrollBar の方向です。
position0。ScrollBar サムの移動後の位置です。
targetイベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。
例の使用法
ComboBoxExample.as

この例は、ComboBox インスタンスのイベントを監視する方法を示します。

例を実行するには、次の手順に従います。

  1. ComboBox コンポーネントをステージまでドラッグし、cb という名前を付けます。
  2. このコードを ComboBoxExample.as として FLA ファイルと同じディレクトリに保存します。
  3. FLA ファイルのドキュメントクラスを ComboBoxExample に設定します。
package 
{
    import fl.controls.ComboBox;
    import flash.display.Sprite
    import flash.events.Event;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    
    public class ComboBoxExample extends Sprite
    {
        private var tf:TextField;
        
        public function ComboBoxExample() {
            setupComboBox();
            setupTextField();
        }

        private function setupTextField():void {
            tf = new TextField();
            tf.x = 230;
            tf.y = 15;
            tf.autoSize = TextFieldAutoSize.LEFT;
            addChild(tf);
        }

        private function setupComboBox():void {
            cb.setSize(200, 22);
            cb.prompt = "Select a Credit Card";
            cb.addItem( { label: "MasterCard", data:1 } );
            cb.addItem( { label: "Visa", data:2 } );
            cb.addItem( { label: "American Express", data:3 } );
            cb.addEventListener(Event.CHANGE, cardSelected);            
        }

        private function cardSelected(e:Event):void {
            tf.text = "You have selected: "
            tf.appendText(cb.selectedItem.label);
        }
    }
}




 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flash/9.0_jp/ActionScriptLangRefV3/fl/controls/ComboBox.html