コンボボックス (PRIM_CMBX)

値のドロップダウンリスト

祖先 - コントロール (PRIM_CTRL) オブジェクト (PRIM_OBJT)

詳細

コンボボックスまたはドロップダウンは、クリックしたときに利用可能な値のリストを表示するリストベースのコントロールです。
 
構成に応じて、コンボはコントロールの編集部分にデータを入力することもできます。
 
コンボから項目が選択されると、下にあるリストエントリに関連付けられたフィールド値が親コンポーネントに返されます。

例

シンプルな ２ 列のコンボ

Function Options(*DIRECT)
Begin_Com Role(*EXTENDS #PRIM_FORM) Height(284) Left(196) Top(211) Width(549) Clientwidth(533) Clientheight(245)
   Define_Com Class(#PRIM_CMBX) Name(#ComboBox) Componentversion(1) Displayposition(1) Fixedheight(False) Left(128) Parent(#COM_OWNER) Showselection(False) Showselectionhilight(False) Tabposition(1) Top(40) Height(37) Width(272) Comboboxstyle(DropDownList)
   Define_Com Class(#PRIM_CBCL) Name(#CBCL1) Displayposition(1) Parent(#ComboBox) Source(#xDemoAlpha128) Usepicklist(False)
   Define_Com Class(#PRIM_CBCL) Name(#CBCL2) Displayposition(2) Parent(#ComboBox) Source(#xDemoNumber) Usepicklist(False)
 
   Evtroutine Handling(#Com_owner.CreateInstance)
 
      #Com_owner.AddEntry( 1 "One" )
      #Com_owner.AddEntry( 2 "Two" )
      #Com_owner.AddEntry( 3 "Three" )
      #Com_owner.AddEntry( 4 "Four" )
      #Com_owner.AddEntry( 5 "Five" )
 
 Endroutine
 
   Mthroutine Name(AddEntry)
      Define_Map For(*input) Class(#xDemoNumber) Name(#Value)
      Define_Map For(*input) Class(#xDemoAlpha128) Name(#Caption)
 
      #xDemoNumber := #Value
      #xDemoAlpha128 := #Caption
 
      Add_Entry To_List(#ComboBox)
 
 Endroutine
 
      Evtroutine Handling(#ComboBox.ItemGotFocus)
 
      #Com_owner.Caption := #xDemoAlpha128
 
 Endroutine
 
 End_Com

プロパティ

名前記述
AutoSelectAutoSelectはテキストを自動的に選択するためのプロパティです。
AutoSelectItemAutoSelectItemは、最初のアイテムを自動的に設定します
BusyUpdatesBusyUpdatesはコントロールがそれ自身をどのようにしてアップデートするかを指定します。 コントロール (PRIM_CTRL) より継承
BusyUpdatesOfParentBusyUpdatesOfParentは親のコントロールが更新するかどうかを指定します。 コントロール (PRIM_CTRL) より継承
CanFocusCanFocusはコントロールがキーボードフォーカスを受け取れるかどうかを示す値を返します。 コントロール (PRIM_CTRL) より継承
Cellリスト内の特定のセルへの参照
Columnsリスト内の列のコレクション
ComboBoxStyleComboBoxStyleはコンボボックスのタイプを指定するためのプロパティです。
ComponentClassNameコンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承
ComponentMembersこのコンポーネントの全てにアクセスできるようにします。 オブジェクト (PRIM_OBJT) より継承
ComponentPatternNameコンポーネントのクラスを制限します。 オブジェクト (PRIM_OBJT) より継承
ComponentTagインスタンス用に値を格納できる汎用スペース オブジェクト (PRIM_OBJT) より継承
ComponentTypeComponentTypeではコンポーネントのタイプ情報にアクセスできます。 オブジェクト (PRIM_OBJT) より継承
ComponentTypeNameComponentTypeName十分適格なコンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承
ComponentVersion利用されているコントロールのバリアント
CurrentItemUIのタッチまたはリスト関連コマンド経由で最後に選択されたリスト内の項目
CursorCursorのイメージを指定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
DataClassデータ入力の制御に使用された、リポジトリフィールドまたは基礎となる製品データクラスへの参照
DisplayPositionDisplayPositionに表示の位置を指定します。 コントロール (PRIM_CTRL) より継承
DragStyleDragStyleはどのようにコンポーネントがドラッグされるかを決めます。 コントロール (PRIM_CTRL) より継承
DropDownCountDropDownCountはリストに表示する項目数を設定するためのプロパティです。
DropDownOpenコンボボックスは開いているか
DropDownWidthDropDownWidthはドロップダウンの幅をwidthプロパティのパーセント値で示します。
EnabledEnabledはコンポーネントを使用可能/使用不可にするためのプロパティです。 コントロール (PRIM_CTRL) より継承
EntriesEntriesはリストの項目数を表示するためのプロパティです。
FixedHeightコンボの高さを自動的にテキストの高さに設定します
FixedPosition親がスクールされても移動しないよう、コントロールを固定します コントロール (PRIM_CTRL) より継承
FocusFocusはコンポーネントにフォーカスがあるかどうかを判断するためのプロパティです。 コントロール (PRIM_CTRL) より継承
FocusedStyleコントロールにフォーカスがある時に適用するスタイルへの参照 コントロール (PRIM_CTRL) より継承
FocusedStylesコントロールにフォーカスがある時に適用するスタイルのコレクション コントロール (PRIM_CTRL) より継承
FocusItemFocusItemはフォーカスを持つ項目を判断/設定するためのプロパティです。
Handleデスクトップアプリケーション内のWindowsハンドルを返します コントロール (PRIM_CTRL) より継承
HasSelection編集可能なテキストが選択されている場合TRUE
HeightHeightコンポーネントの高さを設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintHintはコンポーネントの記述を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintPopupHintPopupは省略値のポップアップテキストの代わりにポップアップパネル(#prim_ppnl)インスタンスが利用できるようにします。 コントロール (PRIM_CTRL) より継承
HintShowHintShowはヒントを表示するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintShowOfParentHintShowOfParentはコンテナのHintShowプロパティを参照するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintTitleHintTitleヒントウィンドウの上部に強調文字で表示されるテキストを指定します。 コントロール (PRIM_CTRL) より継承
IntegralHeightリストの最後の項目を部分的に表示するかどうかをIntegralHeightプロパティで設定します。
IsAnimatingIsAnimatingは現在コントロールがアニメーションで表示されていることを示します。 コントロール (PRIM_CTRL) より継承
IsRealizedデザインインスタンスが実施されるとTRUEになります。 コントロール (PRIM_CTRL) より継承
Itemsコンポーネント内のアイテムのコレクション
LeftLeftはコンポーネントの左側の位置を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
MessageSetLANSA内部専用
MessagesOfComponentLANSA内部専用
MessagesOfFeatureLANSA内部専用
ModifiedModifiedはコントロールの内容が変更されていることを知らすためのプロパティです。 コントロール (PRIM_CTRL) より継承
ModifiedRulesModifiedプロパティをTRUEに設定する時を制御します。
MouseOverMouseOverマウスがコントロールの真上にあるかどうかを決定します。 コントロール (PRIM_CTRL) より継承
MouseOverStyleMouseOverStyleマウスが真上にある時にコントロールに適用するスタイル(#Prim_vs.Style)を定義します。 コントロール (PRIM_CTRL) より継承
MouseOverStylesMouseOverStylesマウスが真上にある時にコントロールに適用するスタイル集(#Prim_vs.Style)です。 コントロール (PRIM_CTRL) より継承
Nameコンポーネントの名前 オブジェクト (PRIM_OBJT) より継承
NotificationStyleどのようにイベントが起動されるかをコントロールします
OpacityOpacityはコントロールと背景の表示関係を表します。 コントロール (PRIM_CTRL) より継承
Ownerコンポーネントのオーナーです。 オブジェクト (PRIM_OBJT) より継承
Parentこのコントロールがビジュアル的に位置しているコントロールへの参照 コントロール (PRIM_CTRL) より継承
PopupPopupは通常の右クリックのポップアップメニューの代わりにポップアップパネル(#prim_ppnl)インスタンスが利用できるようにします。 コントロール (PRIM_CTRL) より継承
PopupMenu右クリックで表示されるポップアップメニューへの参照 コントロール (PRIM_CTRL) より継承
ReadOnlyコンポーネントを入力として使用できるかどうかを制御します
RotationRotationは指定の原点の周りをコントロールが回転できるようにします。 コントロール (PRIM_CTRL) より継承
RotationOriginLeftRotationOriginLeftはコントロールがその周りを回転する想定地点の左座標を指定します。 コントロール (PRIM_CTRL) より継承
RotationOriginTopRotationOriginTopはコントロールがその周りを回転する想定地点の上座標を指定します。 コントロール (PRIM_CTRL) より継承
RowHeightドロップダウン内の行の高さ(ピクセル)
ScaleHeightScaleHeightはコントロールのビジュアル表示で使用する高さをパーセントで示します。 コントロール (PRIM_CTRL) より継承
ScaleOriginLeftScaleOriginLeftはコントロールのサイズ調整時の想定開始地点の左座標を指定します。 コントロール (PRIM_CTRL) より継承
ScaleOriginTopScaleOriginTopはコントロールのサイズ調整時の想定開始地点の上座標を指定します。 コントロール (PRIM_CTRL) より継承
ScaleWidthScaleWidthはコントロールのビジュアル表示で使用する幅をパーセントで示します。 コントロール (PRIM_CTRL) より継承
ScreenLeftScreenLeftはスクリーンの左側からの距離を設定します。 コントロール (PRIM_CTRL) より継承
ScreenTopScreenTopはスクリーンの上部からの距離を設定します。 コントロール (PRIM_CTRL) より継承
ScrollLeftスクロールされた子コントロールの(親コントロールに対して)左の位置 コントロール (PRIM_CTRL) より継承
ScrollTopスクロールされた子コントロールの(親コントロールに対して)上の位置 コントロール (PRIM_CTRL) より継承
SelectionEndSelectionEndは選択の終了地点を設定します。
SelectionStartSelectionStartは選択の開始地点を設定します。
SelectionStyleSelectionStyleは複数選択可能にするためのプロパティです。
ShowSelectionShowSelectionは選択されている項目を表示するかどうかを設定するためのプロパティです。
ShowSelectionHilightShowSelectionHilightは選択されたアイテムがどのように表示されるかをコントロールします
SkewLeftSkewLeftはコントロールを水平方向に傾ける角度を定義します。 コントロール (PRIM_CTRL) より継承
SkewOriginLeftSkewOriginLeftはコントロール傾斜時の想定開始地点の左座標を指定します。 コントロール (PRIM_CTRL) より継承
SkewOriginTopSkewOriginTopはコントロール傾斜時の想定開始地点の上座標を指定します。 コントロール (PRIM_CTRL) より継承
SkewTopSkewTopはコントロールを垂直方向に傾ける角度を定義します。 コントロール (PRIM_CTRL) より継承
StyleStyleはコントロールに適用するスタイル(#Prim_vs.Style)を定義します。 コントロール (PRIM_CTRL) より継承
Stylesコントロールに適用するスタイルのコレクション コントロール (PRIM_CTRL) より継承
TabPositionTabPositionはフォーカスの順番を指定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
TabStopTabStopはTabキーによってフォーカスをもつことを設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
TextTextプロパティの値にコンポーネントの入力域に表示されているデータが入ります。
ThemeDrawStyleコントロールに適用するテーマの描画スタイルの名前 コントロール (PRIM_CTRL) より継承
TopTopはコンポーネントの上側の位置を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
TouchMoveタッチ移動処理にコントロールがどう対応するかを決定します。 コントロール (PRIM_CTRL) より継承
TouchRotateタッチ回転にコントロールがどう対応するかを決定します。 コントロール (PRIM_CTRL) より継承
TouchScaleタッチサイズ変更にコントロールがどう対応するかを決定します。 コントロール (PRIM_CTRL) より継承
TouchSizeコントロールをサイズ調整可能にするかどうかを決定します。 コントロール (PRIM_CTRL) より継承
ValueValueプロパティはコンポーネントの入力域の値を設定するために使用します。
ValueAt指定の位置の値
VisibleVisibleはコンポーネントを表示/非表示するためのプロパティです。 コントロール (PRIM_CTRL) より継承
VisualStyleVisualStyleはコンポーネントの表示構成を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
VisualStyleOfParentVisualStyleOfParentはコンテナのVisualStyleプロパティを参照するためのプロパティです。 コントロール (PRIM_CTRL) より継承
WebAriaこの Web ページのコンポーネントのアクセシビリティ記述として利用される Aria 属性を上書きする内容の詳細を示すコンポーネント インスタンスへの参照 コントロール (PRIM_CTRL) より継承
WidthWidthはコンポーネントの幅を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承

イベント

名前記述
AnimationEndedアニメーション終了時に起動します コントロール (PRIM_CTRL) より継承
Cancelled
AutoCompletingフィールドが編集されると、オートコンプリートイベントが起動します
Value
ChangedChangedイベントはコンポーネントの値が変更された時に実行されます。
CloseUpコンボボックスのリスト部分が閉じる時にCloseUpイベントが実行されます。
ComboChangedChangedイベントはコンポーネントの値が変更された時に実行されます。
CreateInstanceコンポーネントを作成する時にCreateInstanceのイベントを実行します。 コントロール (PRIM_CTRL) より継承
DestroyInstanceコンポーネントが解除される前にDestroyInstanceのイベントを実行します。 コントロール (PRIM_CTRL) より継承
DoubleClickDoubleClickイベントはマウスをダブルクリックした時に実行されます。
Origin, Handled
DragDropDragDropイベントはコンポーネントがドロップされる時に実行されます。 コントロール (PRIM_CTRL) より継承
PosX, PosY, Source, Payload, AggregatedSource, Origin, Handled, DragResult
DragOverカーソルがコントロールの上を移動するドラッグアンドドロップ処理中に起動されます。 コントロール (PRIM_CTRL) より継承
PosX, PosY, Source, Payload, DragState, AcceptDrop, DragCursor, ShowDropHilight, AggregatedSource, Origin, Handled
DropDownコンボボックスのリスト部分がドロップダウンするときにDropDownイベントが実行されます。
Continue
EndDragEndDragはドラッグアンドドロップが完了した時に実行されます。 コントロール (PRIM_CTRL) より継承
Source, Payload, DragResult, AggregatedSource, Origin, Handled
EnterEnterイベントはフォーカスをもつ時に実行されます。
KeyCode, Char, IsAltDown, IsControlDown, IsShiftDown, Handled
GotFocusGotFocusイベントはフォーカスをもつ時に実行されます。
InitializeInitializeはコンポーネントをロードする時に実行されます。 コントロール (PRIM_CTRL) より継承
ItemGotFocusItemGotFocusイベントは項目がフォーカスがをもつと実行されます。
ItemGotFocusAcceptItemGotFocusAcceptはアイテムがフォーカスされた時に発生します
Accept, Reason
ItemGotSelectionItemGotSelectionイベントは項目が選択された時に実行されます。
ItemGotSelectionAcceptItemGotSelectionAcceptはアイテムがフォーカスされた時に発生します。
Accept, Reason
ItemLostFocusItemLostFocus他の項目がフォーカスをもつとこのイベントが実行されます。
ItemLostFocusAcceptItemLostFocusAcceptはアイテムがフォーカスされた時に発生します。
Accept, Reason
ItemLostSelectionItemLostSelectionイベントは他の項目が選択された時に実行されます。
ItemLostSelectionAcceptItemLostSelectionAcceptアイテムがフォーカスされた時に発生します
Accept, Reason
KeyPressKeyPressはキーボードのキーが押されたことを示します
KeyCode, Char, IsAltDown, IsControlDown, IsShiftDown, Handled
LostFocusLostFocusイベントは他の項目がフォーカスを持つと実行されます。
MouseEnterコントロールの境界内にマウスが入りました。 コントロール (PRIM_CTRL) より継承
MouseHoverマウスがコントロール上でホバリングしました。 コントロール (PRIM_CTRL) より継承
Origin, Handled
MouseLeaveマウスがコントロールの境界から出ました。 コントロール (PRIM_CTRL) より継承
StartDragStartDragはマウスをドラッグした時に実行されます。 コントロール (PRIM_CTRL) より継承
Source, Payload, Continue, DragList, AggregatedSource, Origin, Handled
TouchChangeTouchStartとTouchEndの境界で繰り返し起動され、タッチイベントの詳細を提供します。 コントロール (PRIM_CTRL) より継承
MoveLeft, MoveTop, ScaleWidth, ScaleHeight, Rotation, Continue
TouchEndユーザーのタッチが終了した時に起動します。 コントロール (PRIM_CTRL) より継承
TouchStartユーザーにより画面に物理的な接触が最初に行われた時に起動します。 コントロール (PRIM_CTRL) より継承
Origin, TouchMove, TouchRotate, TouchScale, TouchSize

メソッド

名前記述
CloseDropDownDropDownまたはDropDownListスタイルのコンボボックスのリストボックス部分が閉じられるように設定します。
Result
FadeIn非表示から表示へのアニメーション コントロール (PRIM_CTRL) より継承
Duration, Delay
FadeOut表示から非表示へのアニメーション コントロール (PRIM_CTRL) より継承
Duration, Delay, Visible
MoveFromコントロールを指定位置から現在の位置に移動 コントロール (PRIM_CTRL) より継承
Left, Top, Duration, Delay
MoveTo指定されたピクセル数の移動をアニメーション化 コントロール (PRIM_CTRL) より継承
Left, Top, Duration, Delay
OpenDropDownドロップダウンまたはドロップダウンリストスタイルのコンボボックスのリストボックス部分が表示されるように設定します。
Result
RealizeRealizeは動的にコンポーネントを作成するためのメソッドです。 コントロール (PRIM_CTRL) より継承
Scaleサイズの変化をアニメーション化 コントロール (PRIM_CTRL) より継承
ScaleWidth, ScaleHeight, Duration, Delay
SelectTextSelectTextは、テキストを選択します
StartPosition, Length
SetFocusSetFocusはコンポーネントにフォーカスをするためのメソッドです。 コントロール (PRIM_CTRL) より継承
SetValueAt指定の位置に値を設定
Result, Row, Column, Value
ShowMessagesLANSA内部専用 コントロール (PRIM_CTRL) より継承
SizeToサイズの変化をアニメーション化 コントロール (PRIM_CTRL) より継承
Width, Height, Duration, Delay
UnrealizeUnrealizeメソッドはコンポーネントを削除するためのメソッドです。 コントロール (PRIM_CTRL) より継承
UpdateDisplayUpdateDisplayメソッドは画面を直ちに更新します。 コントロール (PRIM_CTRL) より継承

参照

すべてのコンポーネント クラス

テクニカルリファレンス

EPC150060 - December 2023