ツリー ビュー (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コントロールに適用するテーマの DrawStyle の名前 コントロール (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) より継承
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) より継承
StartEditStartEdit メソッドは現在のアイテムの編集を開始するプログラム方法です。
StartSplitStartSplit は、ペインのスクロールを独立させることができます
UnrealizeUnrealize メソッドはコンポーネントを削除するためのメソッドです。 コントロール (PRIM_CTRL) より継承
UpdateDisplayUpdateDisplay メソッドは画面を直ちに更新します。 コントロール (PRIM_CTRL) より継承

参照

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

テクニカルリファレンス

2018 - V14SP1