リスト (PRIM_LIST)

テーブル形式のリストデータ

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

詳細

List コントロールは、ツリー構造、データ入力、およびユーザー定義の cell セル内容をサポートする非常に機能的なリストです。
 
I最も単純な形式では、 List は、 LANSA リストコマンドによって管理される典型的な2次元 column ベースのリストコントロールです。例えば、 ADD_ENTRY、 GET_ENTRY、 SELECTLISTなどになります。各列にはソースフィールドがあり、データ値は項目が使用されるので、リストの内外にマッピングされます。
 
リストはツリーとしても使用できます。List Items は他のリストアイテムの parented であり、リストコントロールは外観を管理し、必要に応じて項目を展開したり折りたたんだりします。
 
リストには、他の LANSA リスト、例えば TreeGrid などの単一の列タイプを制御するものと違って、 さまざまなタイプのコンテンツをサポートする特定の column タイプのコンテンツをサポートする特定の列タイプがあります。.これは、イメージ、チェックボックス、ボタン、再利用可能パーツを含む、通常のフィールドが基本となる列を超えるものです。
 
サポートされている列の型は、 stringnumberdate timeimagebuttoncheck box そして reusable partです。
 
リストは、データのない列の使用もサポートしています。たとえば、必要に応じてリストがチェックボックスのみで構成されている場合もあります。フィールド値に頼ることなく、列の currentitem プロパティにアクセスできます。
 
列は次の 2 つの方法で動作します。1 つめは、エントリ追加時に、列の定義がプロトタイプとして使用されます。ですから、「削除」というキャプションで定義されたボタン列には、各項目に「削除」というキャプションが付いたボタンが表示されます。2 つめは、すべての列タイプには、個別のインスタンスへのアクセスを提供する CurrentItem プロパティがあります。
 
List は、 DropDown コントロールの基礎としても使用されます。その結果、リスト内で利用可能なすべての機能が DropDown のドロップダウン領域でも利用可能になります。
 
注:ブラウザでの実行は、大量のデータには適していません。数千のエントリをリストに追加すると、パフォーマンスに影響します。代わりに、一度に1ページずつページングを改善されたフィルタリングを使用し、オンデマンド戦略を使用してデータが限定されていることを確認する必要があります。

この例は、数字とボタンの列を持つ単純なリストを示しています。ボタンは、行が奇数行の場合非表示になります。ボタンをクリックすると、行が削除されます。
Begin_Com Role(*EXTENDS #PRIM_WEB) Height(456) Width(864) Layoutmanager(#TableLayout1)
   Define_Com Class(#PRIM_TBLO) Name(#TableLayout1)
   Define_Com Class(#PRIM_TBLO.Column) Name(#Column1) Displayposition(1) Parent(#TableLayout1)
   Define_Com Class(#PRIM_TBLO.Row) Name(#Row1) Displayposition(1) Parent(#TableLayout1)
   Define_Com Class(#PRIM_TBLO.Item) Name(#List1Item1) Column(#Column1) Manage(#List) Parent(#TableLayout1) Row(#Row1)
 
   Define_Com Class(#PRIM_LIST) Name(#List) Displayposition(1) Left(0) Parent(#COM_OWNER) Tabposition(1) Top(0) Height(456) Width(864) Rowheight(33)
   Define_Com Class(#PRIM_LIST.Number) Name(#ColumnXDEMONUMB1) Displayposition(1) Increment(1) Parent(#List) Source(#xDemoNumber) Wrap(False)
   Define_Com Class(#PRIM_LIST.Button) Name(#ColumnButton1) Columnwidth(100) Displayposition(2) Parent(#List) Caption('Delete') Cellsizing(None) Cellwidth(80)
 
   Evtroutine Handling(#Com_Owner.CreateInstance)
 
      Begin_Loop Using(#xDemoNumber) To(10)
 
         Add_Entry To_List(#List)
 
         #ColumnButton1.CurrentItem.Visible := (#xDemoNumber.mod( 2 ) = 0)
 
      End_Loop
 
   Endroutine
 
   Evtroutine Handling(#ColumnButton1.Click)
 
      Dlt_Entry Number(#List.CurrentItem.Entry)
 
   Endroutine
 
End_Com

プロパティ

名前記述
AlternateItemThemeDrawStyle代替アイテムに適用するThemeDrawStyle
AutoSelectItemリストがロードされた時に自動的に最初の項目を選択します
BusyUpdatesBusyUpdatesはコントロールがそれ自身をどのようにしてアップデートするかを指定します。 コントロール (PRIM_CTRL) より継承
BusyUpdatesOfParentBusyUpdatesOfParentは親のコントロールが更新するかどうかを指定します。 コントロール (PRIM_CTRL) より継承
CanFocusCanFocusはコントロールがキーボードフォーカスを受け取れるかどうかを示す値を返します。 コントロール (PRIM_CTRL) より継承
CheckBoxesリスト内の各アイテムにチェックボックスを表示します。
ColumnDragユーザーが列を並び替えれるかどうかを指定します。
ColumnHeaderHeight列見出し領域の高さ(ピクセル)
ColumnHeaderSizing列見出しのサイズ調整方法を決定します
ColumnLines列区切り線の表示
ColumnMarginLeft列の左余白(ピクセル)
ColumnMarginRight列の右余白(ピクセル)
ColumnMouseOverStyleマウスオーバーで列見出しに適用するスタイル
ColumnMouseOverStylesマウスオーバーで列見出しに適用するスタイルのコレクション
ColumnPressedStyleマウスダウンで列見出しに適用されるスタイル
ColumnPressedStylesマウスダウンで列見出しに適用されるスタイルのコレクション
Columnsリスト内のすべての列のコレクション
ColumnSortArrow第一ソートの場合、列のソート矢印を表示します。
ColumnStyleマウスダウンで列見出しに適用するスタイル
ColumnStyles列見出しに適用するスタイルのコレクション
ColumnThemeDrawStyle列見出しに適用するテーマの描画スタイルの名前
ComponentClassNameコンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承
ComponentMembersこのコンポーネントの全てにアクセスできるようにします。 オブジェクト (PRIM_OBJT) より継承
ComponentPatternNameコンポーネントのクラスを制限します。 オブジェクト (PRIM_OBJT) より継承
ComponentTagインスタンス用に値を格納できる汎用スペース オブジェクト (PRIM_OBJT) より継承
ComponentTypeComponentTypeではコンポーネントのタイプ情報にアクセスできます。 オブジェクト (PRIM_OBJT) より継承
ComponentTypeNameComponentTypeName十分適格なコンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承
CurrentItemUIのタッチまたはリスト関連コマンド経由で最後に選択されたリスト内の項目
CurrentPage表示する現在のページを指定します
CursorCursorのイメージを指定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
DisplayPositionDisplayPositionに表示の位置を指定します。 コントロール (PRIM_CTRL) より継承
DragStyleDragStyleはどのようにコンポーネントがドラッグされるかを決めます。 コントロール (PRIM_CTRL) より継承
EnabledEnabledはコンポーネントを使用可能/使用不可にするためのプロパティです。 コントロール (PRIM_CTRL) より継承
EnterKeyStyleリスト内でEnterキー押下時にどうするかを決定します。
Filterリストをフィルターするために検索する文字列
FixedPosition親がスクールされても移動しないよう、コントロールを固定します コントロール (PRIM_CTRL) より継承
FocusFocusはコンポーネントにフォーカスがあるかどうかを判断するためのプロパティです。 コントロール (PRIM_CTRL) より継承
FocusColumnリスト内のアクティブな列への参照
FocusedStyleコントロールにフォーカスがある時に適用するスタイルへの参照 コントロール (PRIM_CTRL) より継承
FocusedStylesコントロールにフォーカスがある時に適用するスタイルのコレクション コントロール (PRIM_CTRL) より継承
FocusItemFocusItemはフォーカスを持つ項目を判断/設定するためのプロパティです。
Handleデスクトップアプリケーション内のWindowsハンドルを返します コントロール (PRIM_CTRL) より継承
HeightHeightコンポーネントの高さを設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintHintはコンポーネントの記述を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintPopupHintPopupは省略値のポップアップテキストの代わりにポップアップパネル(#prim_ppnl)インスタンスが利用できるようにします。 コントロール (PRIM_CTRL) より継承
HintShowHintShowはヒントを表示するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintShowOfParentHintShowOfParentはコンテナのHintShowプロパティを参照するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintTitleHintTitleヒントウィンドウの上部に強調文字で表示されるテキストを指定します。 コントロール (PRIM_CTRL) より継承
HorizontalScrollIncHorizontalScrollIncは、水平方向のスクロールバーのピクセル単位の増加量を指定します。
HorizontalScrollPosHorizontalScrollPos水平方向のスクロールバーの位置を設定します。
IsAnimatingIsAnimatingは現在コントロールがアニメーションで表示されていることを示します。 コントロール (PRIM_CTRL) より継承
IsRealizedデザインインスタンスが実施されるとTRUEになります。 コントロール (PRIM_CTRL) より継承
Itemsリスト内のアイテムのコレクション
ItemThemeDrawStyle項目に適用するテーマの描画スタイルの名前
KeyboardPositioningキーボード入力を基にリストがどのように位置づけられるかを決定します。
LeftLeftはコンポーネントの左側の位置を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
ModifiedModifiedはコントロールの内容が変更されていることを知らすためのプロパティです。 コントロール (PRIM_CTRL) より継承
ModifiedRulesModifiedプロパティをTRUEに設定する時を制御します。
MouseOverMouseOverマウスがコントロールの真上にあるかどうかを決定します。 コントロール (PRIM_CTRL) より継承
MouseOverStyleMouseOverStyleマウスが真上にある時にコントロールに適用するスタイル(#Prim_vs.Style)を定義します。 コントロール (PRIM_CTRL) より継承
MouseOverStylesMouseOverStylesマウスが真上にある時にコントロールに適用するスタイル集(#Prim_vs.Style)です。 コントロール (PRIM_CTRL) より継承
Nameコンポーネントの名前 オブジェクト (PRIM_OBJT) より継承
NotificationStyleNotificationStyleどのようにイベントが起動されるかをコントロールします
OpacityOpacityはコントロールと背景の表示関係を表します。 コントロール (PRIM_CTRL) より継承
Ownerコンポーネントのオーナーです。 オブジェクト (PRIM_OBJT) より継承
Parentこのコントロールがビジュアル的に位置しているコントロールへの参照 コントロール (PRIM_CTRL) より継承
PopupPopupは通常の右クリックのポップアップメニューの代わりにポップアップパネル(#prim_ppnl)インスタンスが利用できるようにします。 コントロール (PRIM_CTRL) より継承
PopupMenu右クリックで表示されるポップアップメニューへの参照 コントロール (PRIM_CTRL) より継承
RotationRotationは指定の原点の周りをコントロールが回転できるようにします。 コントロール (PRIM_CTRL) より継承
RotationOriginLeftRotationOriginLeftはコントロールがその周りを回転する想定地点の左座標を指定します。 コントロール (PRIM_CTRL) より継承
RotationOriginTopRotationOriginTopはコントロールがその周りを回転する想定地点の上座標を指定します。 コントロール (PRIM_CTRL) より継承
RowHeight行の高さ(ピクセル)
RowLines行区切り線の表示
RowResize行のサイズ調整を許可します。
RowSizing行のサイズ調整方法を決定します。
RowsPerPageページごとに表示する行数を指定します
ScaleHeightScaleHeightはコントロールのビジュアル表示で使用する高さをパーセントで示します。 コントロール (PRIM_CTRL) より継承
ScaleOriginLeftScaleOriginLeftはコントロールのサイズ調整時の想定開始地点の左座標を指定します。 コントロール (PRIM_CTRL) より継承
ScaleOriginTopScaleOriginTopはコントロールのサイズ調整時の想定開始地点の上座標を指定します。 コントロール (PRIM_CTRL) より継承
ScaleWidthScaleWidthはコントロールのビジュアル表示で使用する幅をパーセントで示します。 コントロール (PRIM_CTRL) より継承
ScreenLeftScreenLeftはスクリーンの左側からの距離を設定します。 コントロール (PRIM_CTRL) より継承
ScreenTopScreenTopはスクリーンの上部からの距離を設定します。 コントロール (PRIM_CTRL) より継承
ScrollLeftスクロールされた子コントロールの(親コントロールに対して)左の位置 コントロール (PRIM_CTRL) より継承
ScrollTopスクロールされた子コントロールの(親コントロールに対して)上の位置 コントロール (PRIM_CTRL) より継承
SelectedRowCountSelectedRowCountは、いくつの行が選択されているかを表示します
SelectionStyleリストが単一選択か複数選択のいずれをサポートするか指定します。
ShowPagesページングボタンの表示または非表示
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) より継承
ThemeDrawStyleコントロールに適用するテーマの描画スタイルの名前 コントロール (PRIM_CTRL) より継承
TopTopはコンポーネントの上側の位置を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
TouchMoveタッチ移動処理にコントロールがどう対応するかを決定します。 コントロール (PRIM_CTRL) より継承
TouchRotateタッチ回転にコントロールがどう対応するかを決定します。 コントロール (PRIM_CTRL) より継承
TouchScaleタッチサイズ変更にコントロールがどう対応するかを決定します。 コントロール (PRIM_CTRL) より継承
TouchSizeコントロールをサイズ調整可能にするかどうかを決定します。 コントロール (PRIM_CTRL) より継承
TreeButtons展開/折りたたみ状態のイメージを表示または非表示
VerticalScrollIncVerticalScrollIncは、垂直方向のスクロールバーのピクセル単位の増加量を指定します。
VerticalScrollPosVerticalScrollPosは垂直方向のスクロールバーの位置を設定します。
Virtualizationリストが仮想化されるかどうか指定します
VisibleVisibleはコンポーネントを表示/非表示するためのプロパティです。 コントロール (PRIM_CTRL) より継承
VisualStyleVisualStyleはコンポーネントの表示構成を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
VisualStyleOfParentVisualStyleOfParentはコンテナのVisualStyleプロパティを参照するためのプロパティです。 コントロール (PRIM_CTRL) より継承
WebAriaこの Web ページのコンポーネントのアクセシビリティ記述として利用される Aria 属性を上書きする内容の詳細を示すコンポーネント インスタンスへの参照 コントロール (PRIM_CTRL) より継承
WidthWidthはコンポーネントの幅を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承

イベント

名前記述
AnimationEndedアニメーション終了時に起動します コントロール (PRIM_CTRL) より継承
Cancelled
ChangedChangedイベントはコンポーネントの値が変更された時に実行されます。
CreateInstanceコンポーネントを作成する時にCreateInstanceのイベントを実行します。 コントロール (PRIM_CTRL) より継承
DestroyInstanceコンポーネントが解除される前にDestroyInstanceのイベントを実行します。 コントロール (PRIM_CTRL) より継承
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
EndDragEndDragはドラッグアンドドロップが完了した時に実行されます。 コントロール (PRIM_CTRL) より継承
Source, Payload, DragResult, AggregatedSource, Origin, Handled
EnterコントロールでEnterキーが押下されると起動します。
KeyCode, Char, IsAltDown, IsControlDown, IsShiftDown, Handled
GotFocusGotFocusイベントはフォーカスをもつ時に実行されます。
InitializeInitializeはコンポーネントをロードする時に実行されます。 コントロール (PRIM_CTRL) より継承
ItemChangedItemChangedイベントは項目が変更された時に実行されます。
Item
ItemClickアイテムのクリック時に起動されます。
Item
ItemCollapsedリスト内のアイテムが折りたたまれた時に起動されます。
Item
ItemDoubleClickリスト内のアイテムでユーザーがダブルクリックした時に起動されます。
Item
ItemExpandingリスト内のアイテムが展開された時に起動されます。
Item
ItemGotFocusItemGotFocusイベントは項目がフォーカスがをもつと実行されます。
Item
ItemGotSelectionItemGotSelectionイベントは項目が選択された時に実行されます。
Item
ItemLostFocusItemLostFocus他の項目がフォーカスをもつとこのイベントが実行されます。
Item
ItemLostSelectionItemLostSelectionイベントは他の項目が選択された時に実行されます。
Item
ItemMouseEnterマウスがアイテムの境界に入りました。
Item
ItemMouseHoverマウスがアイテム上でホバーリングしています。
Item
ItemMouseLeaveマウスがアイテムの境界を出ました。
Item
ItemRealizingアイテムのデザインインスタンスの実施時、通常はアイテムがビューポートに入ると起動されます。
Item
KeyPressキーボードでキー押下時に起動します。
KeyCode, Char, IsAltDown, IsControlDown, IsShiftDown, Handled
LostFocusLostFocusイベントは他の項目がフォーカスを持つと実行されます。
MouseEnterコントロールの境界内にマウスが入りました。 コントロール (PRIM_CTRL) より継承
MouseHoverマウスがコントロール上でホバリングしました。 コントロール (PRIM_CTRL) より継承
Origin, Handled
MouseLeaveマウスがコントロールの境界から出ました。 コントロール (PRIM_CTRL) より継承
ScrollChanged複合コントロール内のスクロールバーが移動されると起動されます。
Orientation
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

メソッド

名前記述
Exportリストデータをテキストファイル、Excelスプレッドシート、またはPDFにエクスポートします
FileName, Type
FadeIn非表示から表示へのアニメーション コントロール (PRIM_CTRL) より継承
Duration, Delay
FadeOut表示から非表示へのアニメーション コントロール (PRIM_CTRL) より継承
Duration, Delay, Visible
FindItemすべてのリストアイテムのデザインインターフェースでOnFindメソッドを実行します。
Result, Key, StartItem
FindReferenceRelatedReferenceとして格納されたオブジェクトを検索します。
Result, RelatedReference, StartItem
MoveFromコントロールを指定位置から現在の位置に移動 コントロール (PRIM_CTRL) より継承
Left, Top, Duration, Delay
MoveTo指定されたピクセル数の移動をアニメーション化 コントロール (PRIM_CTRL) より継承
Left, Top, Duration, Delay
RealizeRealizeは動的にコンポーネントを作成するためのメソッドです。 コントロール (PRIM_CTRL) より継承
Scaleサイズの変化をアニメーション化 コントロール (PRIM_CTRL) より継承
ScaleWidth, ScaleHeight, Duration, Delay
SetFocusSetFocusはコンポーネントにフォーカスをするためのメソッドです。 コントロール (PRIM_CTRL) より継承
ShowMessagesLANSA内部専用 コントロール (PRIM_CTRL) より継承
SizeToサイズの変化をアニメーション化 コントロール (PRIM_CTRL) より継承
Width, Height, Duration, Delay
UnrealizeUnrealizeメソッドはコンポーネントを削除するためのメソッドです。 コントロール (PRIM_CTRL) より継承
UpdateDisplayUpdateDisplayメソッドは画面を直ちに更新します。 コントロール (PRIM_CTRL) より継承
VerticalScrollTo子コントロールを使用して、垂直スクロール位置を設定します。
Item, ScrollPosition

参照

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

テクニカルリファレンス

EPC150060 - December 2023