ツリービュー (PRIM_TRVW)

ツリービューはデータを階層的に表示するためのコンポーネントです。

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

詳細

TreeView は、項目内の項目を示すデータの階層表示です。
 
TreeView は、  ADD_ENTRY、 GET_ENTRY、 SELECTLIST などの LANSA リストコマンドによって管理される典型的な LANSA リストコントロールです。
 
ツリーに Columns が追加されます。それぞれに Source があり、アイテムが使用されるときにデータ値がリストの内外にマッピングされます。
 
TreeView には、 ViewStyle プロパティに基づいて 2 つのバリエーションがあります。
 
レベル付きツリーは、列の KeyPosition プロパティを使用して階層を決定します。データ値を変更すると、自動的に子アイテムがネストされます。ただし、ツリー内の各項目には 1 つの値しか表示されず、追加される列の数によってレベル数が管理されます。
 
Unlevelled ツリーには、そのような自動化がないため、ユーザーが ParentItem プロパティを使用して項目の入れ子を制御する必要があります。未評価のツリーは、多数のレベルを持つことができ、多くのデータの列を表示できます。それらは自動化されていませんが、はるかに柔軟で強力です。

この例では、展開されていないツリーは4つの子アイテムを展開アイテムに追加します。
 
最初の列はブランチの項目番号を示し、2番目の列は下位のリスト項目番号を示します。
Function Options(*DIRECT)
Begin_Com Role(*EXTENDS #PRIM_FORM) Clientwidth(480) Clientheight(398) Left(259) Top(261) Height(437) Width(496) 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(#TreeView1Item1) Column(#Column1) Manage(#Tree) Parent(#TableLayout1) Row(#Row1)
 
   Define_Com Class(#PRIM_TRVW) Name(#Tree) Columnbuttonheight(19) Componentversion(2) Displayposition(1) Height(398) Keyboardpositioning(SortColumn) Left(0) Parent(#COM_OWNER) Tabposition(1) Top(0) Width(480) Viewstyle(UnLevelled) Fullrowselect(True)
   Define_Com Class(#PRIM_TVCL) Name(#TreeViewColumn2) Displayposition(1) Level(2) Parent(#Tree) Source(#STD_NUM) Width(28) Captiontype(Caption) Caption('Item number')
   Define_Com Class(#PRIM_TVCL) Name(#TreeViewColumn3) Displayposition(2) Level(2) Parent(#Tree) Source(#STD_IDNO) Width(32) Captiontype(Caption) Caption('List Entry')
 
   Evtroutine Handling(#Com_owner.CreateInstance)
 
      #Com_Self.Add4Items
 
 Endroutine
 
   Mthroutine Name(Add4Items)
   Define_Map For(*input) Class(#Prim_tvit) Name(#ParentItem) Mandatory(*Null) Pass(*By_reference)
 
      Begin_Loop Using(#Std_num) To(4)
 
         Add_Entry To_List(#Tree)
         #std_idno := #Tree.CurrentItem.Entry
         Upd_Entry In_List(#Tree)
 
         #Tree.CurrentItem.ParentItem <= #ParentItem
         #Tree.CurrentItem.HasChildren := Unknown
 
 End_Loop
 
 Endroutine
 
   Evtroutine Handling(#Tree.ItemExpanding)
 
      If (#Tree.CurrentItem.HasChildren <> Yes)
         #Com_Self.Add4Items( #Tree.currentitem )
 Endif
 
 Endroutine
 
 End_Com

プロパティ

名前記述
BusyUpdatesBusyUpdatesはコントロールがそれ自身をどのようにしてアップデートするかを指定します。 コントロール (PRIM_CTRL) より継承
BusyUpdatesOfParentBusyUpdatesOfParentは親のコントロールが更新するかどうかを指定します。 コントロール (PRIM_CTRL) より継承
CanFocusCanFocusはコントロールがキーボードフォーカスを受け取れるかどうかを示す値を返します。 コントロール (PRIM_CTRL) より継承
ColumnButtonHeightリスト上部に表示されているボタンの高さを設定します
ColumnEllipses切り詰められたテキストに「・・・」という省略表示を追加します
ColumnHeadersColumnHeaders見出しを表示するためのプロパティです。
ColumnResize列を手動でサイズ調整可能かどうかを指定します
Columns列のプロパティにアクセスできるようにします
ComponentClassNameコンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承
ComponentMembersこのコンポーネントの全てにアクセスできるようにします。 オブジェクト (PRIM_OBJT) より継承
ComponentPatternNameコンポーネントのクラスを制限します。 オブジェクト (PRIM_OBJT) より継承
ComponentTagインスタンス用に値を格納できる汎用スペース オブジェクト (PRIM_OBJT) より継承
ComponentTypeComponentTypeではコンポーネントのタイプ情報にアクセスできます。 オブジェクト (PRIM_OBJT) より継承
ComponentTypeNameComponentTypeName十分適格なコンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承
ComponentVersion使用されているコントロールのバリアント
CurrentItemUIのタッチまたはリスト関連コマンド経由で最後に選択されたリスト内の項目
CursorCursorのイメージを指定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
DisplayPositionDisplayPositionに表示の位置を指定します。 コントロール (PRIM_CTRL) より継承
DragColumns列の順序変更を可能にします
DragStyleDragStyleはどのようにコンポーネントがドラッグされるかを決めます。 コントロール (PRIM_CTRL) より継承
EnabledEnabledはコンポーネントを使用可能/使用不可にするためのプロパティです。 コントロール (PRIM_CTRL) より継承
EntriesEntriesはリストの項目数を表示するためのプロパティです。
EntriesAtRootEntriesAtRootはツリービューのルートの項目数を確認するためのプロパティです。
FixedPosition親がスクールされても移動しないよう、コントロールを固定します コントロール (PRIM_CTRL) より継承
FocusFocusはコンポーネントにフォーカスがあるかどうかを判断するためのプロパティです。 コントロール (PRIM_CTRL) より継承
FocusedStyleコントロールにフォーカスがある時に適用するスタイルへの参照 コントロール (PRIM_CTRL) より継承
FocusedStylesコントロールにフォーカスがある時に適用するスタイルのコレクション コントロール (PRIM_CTRL) より継承
FocusItemFocusItemはフォーカスを持つ項目を判断/設定するためのプロパティです。
FullRowSelectFullRowSelectは全ての行の選択のオン/オフをセットします。
Handleデスクトップアプリケーション内のWindowsハンドルを返します コントロール (PRIM_CTRL) より継承
HasButtonsHasButtonsツリービューの+/-ボタンを表示するためのプロパティです。
HasLinesHasLinesツリービューの線を表示するためのプロパティです。
HeightHeightコンポーネントの高さを設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintHintはコンポーネントの記述を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintPopupHintPopupは省略値のポップアップテキストの代わりにポップアップパネル(#prim_ppnl)インスタンスが利用できるようにします。 コントロール (PRIM_CTRL) より継承
HintShowHintShowはヒントを表示するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintShowOfParentHintShowOfParentはコンテナのHintShowプロパティを参照するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintTitleHintTitleヒントウィンドウの上部に強調文字で表示されるテキストを指定します。 コントロール (PRIM_CTRL) より継承
IsAnimatingIsAnimatingは現在コントロールがアニメーションで表示されていることを示します。 コントロール (PRIM_CTRL) より継承
IsRealizedデザインインスタンスが実施されるとTRUEになります。 コントロール (PRIM_CTRL) より継承
ItemsItemsプロパティはコンポーネントのアイテムの属性にアクセスできるようにします
KeyboardPositioningキーボードから入力した文字によるリスト項目を検索する方法を設定します。
LeftLeftはコンポーネントの左側の位置を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
LinesAtRootツリービューのルートに線を表示するためにLinesAtRootプロパティを使用します。
ManageChildrenManageChildrenはツリービューの項目の子供を制御するためのプロパティです。
ModifiedModifiedはコントロールの内容が変更されていることを知らすためのプロパティです。 コントロール (PRIM_CTRL) より継承
ModifiedRulesModifiedプロパティをTRUEに設定する時を制御します。
MouseOverMouseOverマウスがコントロールの真上にあるかどうかを決定します。 コントロール (PRIM_CTRL) より継承
MouseOverPartカーソルが子コンポーネントの境界内にある場合TRUE
MouseOverStyleMouseOverStyleマウスが真上にある時にコントロールに適用するスタイル(#Prim_vs.Style)を定義します。 コントロール (PRIM_CTRL) より継承
MouseOverStylesMouseOverStylesマウスが真上にある時にコントロールに適用するスタイル集(#Prim_vs.Style)です。 コントロール (PRIM_CTRL) より継承
MultipleSelectStyleLinesAtRootは、複数選択のオン/オフを設定します
Nameコンポーネントの名前 オブジェクト (PRIM_OBJT) より継承
NotificationStyleNotificationStyleどのようにイベントが起動されるかをコントロールします
OpacityOpacityはコントロールと背景の表示関係を表します。 コントロール (PRIM_CTRL) より継承
Ownerコンポーネントのオーナーです。 オブジェクト (PRIM_OBJT) より継承
Parentこのコントロールがビジュアル的に位置しているコントロールへの参照 コントロール (PRIM_CTRL) より継承
PopupPopupは通常の右クリックのポップアップメニューの代わりにポップアップパネル(#prim_ppnl)インスタンスが利用できるようにします。 コントロール (PRIM_CTRL) より継承
PopupMenu右クリックで表示されるポップアップメニューへの参照 コントロール (PRIM_CTRL) より継承
PopupMenuFocusSelectコンテキストメニュー表示時にリストアイテムにフォーカス設定
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) より継承
SelectionStyleSelectionStyleは複数選択可能にするためのプロパティです。
ShowItemHint項目のヒントをオンまたはオフに設定するためのプロパティです。
ShowSelection選択されている項目を表示するかどうかを設定するためのプロパティです。
SkewLeftSkewLeftはコントロールを水平方向に傾ける角度を定義します。 コントロール (PRIM_CTRL) より継承
SkewOriginLeftSkewOriginLeftはコントロール傾斜時の想定開始地点の左座標を指定します。 コントロール (PRIM_CTRL) より継承
SkewOriginTopSkewOriginTopはコントロール傾斜時の想定開始地点の上座標を指定します。 コントロール (PRIM_CTRL) より継承
SkewTopSkewTopはコントロールを垂直方向に傾ける角度を定義します。 コントロール (PRIM_CTRL) より継承
SplitStyleSplitStyleはペインスクロールを独立させられます
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) より継承
TouchScrollスクロールでのタッチ入力に対して、コントロールがどう対応するか指定します。
TouchSizeコントロールをサイズ調整可能にするかどうかを決定します。 コントロール (PRIM_CTRL) より継承
ValueAt指定の位置の値
ViewPopupMenuViewpopupMenuは、ビューエリアのポップアップメニューを指定します
ViewStyleViewStyleはリストの表示モードを設定するためのプロパティです。
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) より継承
DoubleClickDoubleClickイベントはマウスをタブルクリックした時に実行されます。
ExpandItem
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
EditorChanged編集可能なセルでユーザーが値を変更した場合に起動されます
Value
EndDragEndDragはドラッグアンドドロップが完了した時に実行されます。 コントロール (PRIM_CTRL) より継承
Source, Payload, DragResult, AggregatedSource, Origin, Handled
EnterEnterイベントはフォーカスをもつ時に実行されます。
KeyCode, Char, IsAltDown, IsControlDown, IsShiftDown, Handled
GotFocusGotFocusイベントはフォーカスをもつ時に実行されます。
InitializeInitializeはコンポーネントをロードする時に実行されます。 コントロール (PRIM_CTRL) より継承
ItemChangedItemChangedイベントは項目が変更された時に実行されます。
ItemChangedAcceptItemChangedAcceptイベントはアイテムが変更されようとしている時に起動します
Accept, Reason, Continue, Value
ItemCollapsedItemCollapsedイベントはツリービューのレベルが閉じた時に実行されます。
ItemExpandingツリービューの下のレベルを表示する時にItemExpandingイベントが実行されます。
ItemGotFocusItemGotFocusイベントは項目がフォーカスがをもつと実行されます。
ItemGotFocusAcceptItemGotFocusAcceptはアイテムがフォーカスされた時に発生します
Accept, Reason
ItemGotSelectionItemGotSelectionイベントは項目が選択された時に実行されます。
ItemGotSelectionAcceptItemGotSelectionAcceptはアイテムがフォーカスされた時に発生します。
Accept, Reason
ItemHintTextヒントのテキストを取る時にItemHintTextが発行されます
Caption
ItemLostFocusItemLostFocus他の項目がフォーカスをもつとこのイベントが実行されます。
ItemLostFocusAcceptItemLostFocusAcceptはアイテムがフォーカスされた時に発生します。
Accept, Reason
ItemLostSelectionItemLostSelectionイベントは他の項目が選択された時に実行されます。
ItemLostSelectionAcceptItemLostSelectionAcceptアイテムがフォーカスされた時に発生します
Accept, Reason
ItemMouseEnterマウスがアイテムの境界に入りました。
ItemMouseHoverマウスがアイテム上でホバーリングしています。
ItemMouseLeaveマウスがアイテムの境界を出ました。
KeyPressKeyPressはキーが押された時に実行されます。
KeyCode, Char, IsAltDown, IsControlDown, IsShiftDown, Handled
LostFocusLostFocusイベントは他の項目がフォーカスを持つと実行されます。
MouseEnterコントロールの境界内にマウスが入りました。 コントロール (PRIM_CTRL) より継承
MouseHoverマウスがコントロール上でホバリングしました。 コントロール (PRIM_CTRL) より継承
Origin, Handled
MouseLeaveマウスがコントロールの境界から出ました。 コントロール (PRIM_CTRL) より継承
PrompterAccept値がプロンプターで選択されると起動
Form, ApplyValue, FocusAction, ReshowPrompter
PrompterActivateプロンプターイメージがクリックされると起動されます
Form, Continue
PrompterDeactivateプロンプターが閉じられた時に起動されます。
Form
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
ViewDoubleClickViewDoubleClickはユーザーがビューエリアでタブルクリックした時に発生します。

メソッド

名前記述
CollapseAllすべてのツリーノードを折りたたんで、子アイテムを隠します
ExpandAllツリーアイテムを展開して、子ノードを表示
FadeIn非表示から表示へのアニメーション コントロール (PRIM_CTRL) より継承
Duration, Delay
FadeOut表示から非表示へのアニメーション コントロール (PRIM_CTRL) より継承
Duration, Delay, Visible
FindItemアイテムのRelatedReferenceプロパティに格納されたオブジェクトを検索します
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) より継承
SetValueAt指定の位置に値を設定
Result, Row, Column, Value
ShowMessagesLANSA内部専用 コントロール (PRIM_CTRL) より継承
SizeToサイズの変化をアニメーション化 コントロール (PRIM_CTRL) より継承
Width, Height, Duration, Delay
StartEditStartEditメソッドは現在のアイテムの編集を開始するプログラム方法です。
StartSplitStartSplitは、ペインのスクロールを独立させることができます
UnrealizeUnrealizeメソッドはコンポーネントを削除するためのメソッドです。 コントロール (PRIM_CTRL) より継承
UpdateDisplayUpdateDisplayメソッドは画面を直ちに更新します。 コントロール (PRIM_CTRL) より継承

参照

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

テクニカルリファレンス

EPC150060 - December 2023