TileView.cs 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995
  1. using System;
  2. using System.Collections.Generic;
  3. using System.Linq;
  4. using Terminal.Gui.Graphs;
  5. namespace Terminal.Gui {
  6. /// <summary>
  7. /// A <see cref="View"/> consisting of a moveable bar that divides
  8. /// the display area into resizeable <see cref="Tiles"/>.
  9. /// </summary>
  10. public class TileView : View {
  11. TileView parentTileView;
  12. /// <summary>
  13. /// Use this field instead of Border to create an integrated
  14. /// Border in which lines connect with subviews and splitters
  15. /// seamlessly
  16. /// </summary>
  17. public BorderStyle IntegratedBorder { get; set; }
  18. /// <summary>
  19. /// A single <see cref="View"/> presented in a <see cref="TileView"/>. To create
  20. /// new instances use <see cref="TileView.RebuildForTileCount(int)"/>
  21. /// or <see cref="TileView.InsertTile(int)"/>.
  22. /// </summary>
  23. public class Tile {
  24. /// <summary>
  25. /// The <see cref="View"/> that is showing in this <see cref="TileView"/>.
  26. /// You should add new child views to this member if you want multiple
  27. /// <see cref="View"/> within the <see cref="Tile"/>.
  28. /// </summary>
  29. public View View { get; internal set; }
  30. /// <summary>
  31. /// Gets or Sets the minimum size you to allow when splitter resizing along
  32. /// parent <see cref="TileView.Orientation"/> direction.
  33. /// </summary>
  34. public int MinSize { get; set; }
  35. /// <summary>
  36. /// The text that should be displayed above the <see cref="View"/>. This
  37. /// will appear over the splitter line or border (above the view client area).
  38. /// </summary>
  39. /// <remarks>
  40. /// Title are not rendered for root level tiles if there is no
  41. /// <see cref="TileView.IntegratedBorder"/> to render into.
  42. ///</remarks>
  43. public string Title { get; set; }
  44. /// <summary>
  45. /// Creates a new instance of the <see cref="Tile"/> class.
  46. /// </summary>
  47. internal Tile ()
  48. {
  49. View = new View () { Width = Dim.Fill (), Height = Dim.Fill () };
  50. Title = string.Empty;
  51. MinSize = 0;
  52. }
  53. }
  54. List<Tile> tiles;
  55. private List<Pos> splitterDistances;
  56. private List<TileViewLineView> splitterLines;
  57. /// <summary>
  58. /// The sub sections hosted by the view
  59. /// </summary>
  60. public IReadOnlyCollection<Tile> Tiles => tiles.AsReadOnly ();
  61. /// <summary>
  62. /// The splitter locations. Note that there will be N-1 splitters where
  63. /// N is the number of <see cref="Tiles"/>.
  64. /// </summary>
  65. public IReadOnlyCollection<Pos> SplitterDistances => splitterDistances.AsReadOnly ();
  66. private Orientation orientation = Orientation.Vertical;
  67. /// <summary>
  68. /// Creates a new instance of the <see cref="TileView"/> class with
  69. /// 2 tiles (i.e. left and right).
  70. /// </summary>
  71. public TileView () : this (2)
  72. {
  73. }
  74. /// <summary>
  75. /// Creates a new instance of the <see cref="TileView"/> class with
  76. /// <paramref name="tiles"/> number of tiles.
  77. /// </summary>
  78. /// <param name="tiles"></param>
  79. public TileView (int tiles)
  80. {
  81. CanFocus = true;
  82. RebuildForTileCount (tiles);
  83. }
  84. /// <summary>
  85. /// Invoked when any of the <see cref="SplitterDistances"/> is changed.
  86. /// </summary>
  87. public event SplitterEventHandler SplitterMoved;
  88. /// <summary>
  89. /// Raises the <see cref="SplitterMoved"/> event
  90. /// </summary>
  91. protected virtual void OnSplitterMoved (int idx)
  92. {
  93. SplitterMoved?.Invoke (this, new SplitterEventArgs (this, idx, splitterDistances [idx]));
  94. }
  95. /// <summary>
  96. /// Scraps all <see cref="Tiles"/> and creates <paramref name="count"/> new tiles
  97. /// in orientation <see cref="Orientation"/>
  98. /// </summary>
  99. /// <param name="count"></param>
  100. public void RebuildForTileCount (int count)
  101. {
  102. tiles = new List<Tile> ();
  103. splitterDistances = new List<Pos> ();
  104. splitterLines = new List<TileViewLineView> ();
  105. RemoveAll ();
  106. tiles.Clear ();
  107. splitterDistances.Clear ();
  108. if (count == 0) {
  109. return;
  110. }
  111. for (int i = 0; i < count; i++) {
  112. if (i > 0) {
  113. var currentPos = Pos.Percent ((100 / count) * i);
  114. splitterDistances.Add (currentPos);
  115. var line = new TileViewLineView (this, i - 1);
  116. Add (line);
  117. splitterLines.Add (line);
  118. }
  119. var tile = new Tile ();
  120. tiles.Add (tile);
  121. Add (tile.View);
  122. }
  123. LayoutSubviews ();
  124. }
  125. /// <summary>
  126. /// Adds a new <see cref="Tile"/> to the collection at <paramref name="idx"/>.
  127. /// This will also add another splitter line
  128. /// </summary>
  129. /// <param name="idx"></param>
  130. /// <exception cref="NotImplementedException"></exception>
  131. public Tile InsertTile (int idx)
  132. {
  133. var oldTiles = Tiles.ToArray ();
  134. RebuildForTileCount (oldTiles.Length + 1);
  135. Tile toReturn = null;
  136. for(int i=0;i<tiles.Count;i++) {
  137. if(i != idx) {
  138. var oldTile = oldTiles [i > idx ? i - 1 : i];
  139. // remove the new empty View
  140. Remove (tiles [i].View);
  141. // restore old Tile and View
  142. tiles [i] = oldTile;
  143. Add (tiles [i].View);
  144. }
  145. else
  146. {
  147. toReturn = tiles[i];
  148. }
  149. }
  150. SetNeedsDisplay ();
  151. LayoutSubviews ();
  152. return toReturn;
  153. }
  154. /// <summary>
  155. /// Removes a <see cref="Tiles"/> at the provided <paramref name="idx"/> from
  156. /// the view. Returns the removed tile or null if already empty.
  157. /// </summary>
  158. /// <param name="idx"></param>
  159. /// <returns></returns>
  160. public Tile RemoveTile (int idx)
  161. {
  162. var oldTiles = Tiles.ToArray ();
  163. if (idx < 0 || idx >= oldTiles.Length) {
  164. return null;
  165. }
  166. var removed = Tiles.ElementAt (idx);
  167. RebuildForTileCount (oldTiles.Length - 1);
  168. for (int i = 0; i < tiles.Count; i++) {
  169. int oldIdx = i >= idx ? i + 1: i;
  170. var oldTile = oldTiles [oldIdx];
  171. // remove the new empty View
  172. Remove (tiles [i].View);
  173. // restore old Tile and View
  174. tiles [i] = oldTile;
  175. Add (tiles [i].View);
  176. }
  177. SetNeedsDisplay ();
  178. LayoutSubviews ();
  179. return removed;
  180. }
  181. ///<summary>
  182. /// Returns the index of the first <see cref="Tile"/> in
  183. /// <see cref="Tiles"/> which contains <paramref name="toFind"/>.
  184. ///</summary>
  185. public int IndexOf(View toFind, bool recursive = false)
  186. {
  187. for(int i = 0 ;i < tiles.Count; i++)
  188. {
  189. var v = tiles[i].View;
  190. if(v == toFind)
  191. {
  192. return i;
  193. }
  194. if(v.Subviews.Contains(toFind))
  195. {
  196. return i;
  197. }
  198. if(recursive)
  199. {
  200. if(RecursiveContains(v.Subviews,toFind))
  201. {
  202. return i;
  203. }
  204. }
  205. }
  206. return -1;
  207. }
  208. private bool RecursiveContains (IEnumerable<View> haystack, View needle)
  209. {
  210. foreach(var v in haystack)
  211. {
  212. if(v == needle)
  213. {
  214. return true;
  215. }
  216. if(RecursiveContains(v.Subviews,needle))
  217. {
  218. return true;
  219. }
  220. }
  221. return false;
  222. }
  223. /// <summary>
  224. /// Orientation of the dividing line (Horizontal or Vertical).
  225. /// </summary>
  226. public Orientation Orientation {
  227. get { return orientation; }
  228. set {
  229. orientation = value;
  230. LayoutSubviews ();
  231. }
  232. }
  233. /// <inheritdoc/>
  234. public override void LayoutSubviews ()
  235. {
  236. var contentArea = Bounds;
  237. if (HasBorder ()) {
  238. // TODO: Bound with Max/Min
  239. contentArea = new Rect (
  240. contentArea.X + 1,
  241. contentArea.Y + 1,
  242. Math.Max (0, contentArea.Width - 2),
  243. Math.Max (0, contentArea.Height - 2));
  244. }
  245. Setup (contentArea);
  246. base.LayoutSubviews ();
  247. }
  248. /// <summary>
  249. /// <para>Distance Horizontally or Vertically to the splitter line when
  250. /// neither view is collapsed.
  251. /// </para>
  252. /// <para>Only absolute values (e.g. 10) and percent values (i.e. <see cref="Pos.Percent(float)"/>)
  253. /// are supported for this property.</para>
  254. /// </summary>
  255. public bool SetSplitterPos (int idx, Pos value)
  256. {
  257. if (!(value is Pos.PosAbsolute) && !(value is Pos.PosFactor)) {
  258. throw new ArgumentException ($"Only Percent and Absolute values are supported. Passed value was {value.GetType ().Name}");
  259. }
  260. var fullSpace = orientation == Orientation.Vertical ? Bounds.Width : Bounds.Height;
  261. if(fullSpace != 0 && !IsValidNewSplitterPos(idx,value,fullSpace)) {
  262. return false;
  263. }
  264. splitterDistances [idx] = value;
  265. GetRootTileView ().LayoutSubviews ();
  266. OnSplitterMoved (idx);
  267. return true;
  268. }
  269. /// <inheritdoc/>
  270. public override bool OnEnter (View view)
  271. {
  272. Driver.SetCursorVisibility (CursorVisibility.Invisible);
  273. return base.OnEnter (view);
  274. }
  275. /// <inheritdoc/>
  276. public override void Redraw (Rect bounds)
  277. {
  278. // TODO: We are getting passed stale bounds, does this only happen in TileView
  279. // or is it a larger problem? This line should not be required right?
  280. bounds = Bounds;
  281. Driver.SetAttribute (ColorScheme.Normal);
  282. Clear ();
  283. base.Redraw (bounds);
  284. var lc = new LineCanvas ();
  285. var allLines = GetAllLineViewsRecursively (this);
  286. var allTitlesToRender = GetAllTitlesToRenderRecursively(this);
  287. if (IsRootTileView ()) {
  288. if (HasBorder ()) {
  289. lc.AddLine (new Point (0, 0), bounds.Width - 1, Orientation.Horizontal, IntegratedBorder);
  290. lc.AddLine (new Point (0, 0), bounds.Height - 1, Orientation.Vertical, IntegratedBorder);
  291. lc.AddLine (new Point (bounds.Width - 1, bounds.Height - 1), -bounds.Width + 1, Orientation.Horizontal, IntegratedBorder);
  292. lc.AddLine (new Point (bounds.Width - 1, bounds.Height - 1), -bounds.Height + 1, Orientation.Vertical, IntegratedBorder);
  293. }
  294. foreach (var line in allLines) {
  295. bool isRoot = splitterLines.Contains (line);
  296. line.ViewToScreen (0, 0, out var x1, out var y1);
  297. var origin = ScreenToView (x1, y1);
  298. var length = line.Orientation == Orientation.Horizontal ?
  299. line.Frame.Width - 1 :
  300. line.Frame.Height - 1;
  301. if (!isRoot) {
  302. if (line.Orientation == Orientation.Horizontal) {
  303. origin.X -= 1;
  304. } else {
  305. origin.Y -= 1;
  306. }
  307. length += 2;
  308. }
  309. lc.AddLine (origin, length, line.Orientation, IntegratedBorder);
  310. }
  311. }
  312. Driver.SetAttribute (ColorScheme.Normal);
  313. lc.Draw (this, bounds);
  314. // Redraw the lines so that focus/drag symbol renders
  315. foreach (var line in allLines) {
  316. line.DrawSplitterSymbol ();
  317. }
  318. // Draw Titles over Border
  319. foreach(var titleToRender in allTitlesToRender)
  320. {
  321. var renderAt = titleToRender.GetLocalCoordinateForTitle(this);
  322. if(renderAt.Y < 0)
  323. {
  324. // If we have no border then root level tiles
  325. // have nowhere to render their titles.
  326. continue;
  327. }
  328. // TODO: Render with focus color if focused
  329. var title = titleToRender.Tile.Title;
  330. for(int i=0;i<title.Length;i++)
  331. {
  332. AddRune(renderAt.X+i,renderAt.Y,title[i]);
  333. }
  334. }
  335. }
  336. /// <summary>
  337. /// Converts <see cref="Tile.View"/> of <see cref="Tiles"/> element <paramref name="idx"/>
  338. /// from a regular <see cref="View"/> to a new nested <see cref="TileView"/> with <paramref name="panels"/>
  339. /// number of panels. Returns false if the element already contains a nested view.
  340. /// </summary>
  341. /// <remarks>After successful splitting, the <paramref name="result"/> <see cref="TileView"/>
  342. /// will contain the previous (replaced) <see cref="Tile.View"/> at element 0.</remarks>
  343. /// <param name="idx">The element of <see cref="Tiles"/> that is to be subdivided.</param>
  344. /// <param name="panels">The number of panels that the <see cref="Tile"/> should be split into</param>
  345. /// <param name="result">The new nested <see cref="TileView"/>.</param>
  346. /// <returns><see langword="true"/> if a <see cref="View"/> was converted to a new nested
  347. /// <see cref="TileView"/>. <see langword="false"/> if it was already a nested
  348. /// <see cref="TileView"/></returns>
  349. public bool TrySplitTile(int idx, int panels, out TileView result)
  350. {
  351. // when splitting a view into 2 sub views we will need to migrate
  352. // the title too
  353. var tile = tiles [idx];
  354. // TODO: migrate the title too right?
  355. var title = tile.Title;
  356. View toMove = tile.View;
  357. if (toMove is TileView existing) {
  358. result = existing;
  359. return false;
  360. }
  361. var newContainer = new TileView(panels) {
  362. Width = Dim.Fill (),
  363. Height = Dim.Fill (),
  364. parentTileView = this,
  365. };
  366. // Take everything out of the View we are moving
  367. var childViews = toMove.Subviews.ToArray();
  368. toMove.RemoveAll ();
  369. // Remove the view itself and replace it with the new TileView
  370. Remove (toMove);
  371. Add (newContainer);
  372. tile.View = newContainer;
  373. var newTileView1 = newContainer.tiles [0].View;
  374. // Add the original content into the first view of the new container
  375. foreach (var childView in childViews) {
  376. newTileView1.Add (childView);
  377. }
  378. result = newContainer;
  379. return true;
  380. }
  381. private bool IsValidNewSplitterPos (int idx, Pos value, int fullSpace)
  382. {
  383. int newSize = value.Anchor (fullSpace);
  384. bool isGettingBigger = newSize > splitterDistances [idx].Anchor (fullSpace);
  385. // Cannot move off screen right
  386. if (newSize >= fullSpace - (HasBorder () ? 1 : 0)) {
  387. return false;
  388. }
  389. // Cannot move off screen left
  390. if (newSize < (HasBorder()?1:0)) {
  391. return false;
  392. }
  393. // Do not allow splitter to move left of the one before
  394. if (idx > 0) {
  395. int posLeft = splitterDistances [idx - 1].Anchor (fullSpace);
  396. if (newSize <= posLeft) {
  397. return false;
  398. }
  399. }
  400. // Do not allow splitter to move right of the one after
  401. if (idx + 1 < splitterDistances.Count) {
  402. int posLeft = splitterDistances [idx + 1].Anchor (fullSpace);
  403. if (newSize >= posLeft) {
  404. return false;
  405. }
  406. }
  407. return true;
  408. }
  409. private List<TileViewLineView> GetAllLineViewsRecursively (View v)
  410. {
  411. var lines = new List<TileViewLineView> ();
  412. foreach (var sub in v.Subviews) {
  413. if (sub is TileViewLineView s) {
  414. if (s.Visible && s.Parent.GetRootTileView () == this) {
  415. lines.Add (s);
  416. }
  417. } else {
  418. if(sub.Visible) {
  419. lines.AddRange (GetAllLineViewsRecursively (sub));
  420. }
  421. }
  422. }
  423. return lines;
  424. }
  425. private List<TileTitleToRender> GetAllTitlesToRenderRecursively (TileView v, int depth = 0)
  426. {
  427. var titles = new List<TileTitleToRender> ();
  428. foreach (var sub in v.Tiles) {
  429. // Don't render titles for invisible stuff!
  430. if(!sub.View.Visible)
  431. {
  432. continue;
  433. }
  434. if(sub.View is TileView subTileView)
  435. {
  436. // Panels with sub split tiles in them can never
  437. // have their Titles rendered. Instead we dive in
  438. // and pull up their children as titles
  439. titles.AddRange (GetAllTitlesToRenderRecursively (subTileView,depth+1));
  440. }
  441. else
  442. {
  443. if(sub.Title.Length > 0)
  444. {
  445. titles.Add(new TileTitleToRender(sub,depth));
  446. }
  447. }
  448. }
  449. return titles;
  450. }
  451. /// <summary>
  452. /// <para>
  453. /// <see langword="true"/> if <see cref="TileView"/> is nested within a parent <see cref="TileView"/>
  454. /// e.g. via the <see cref="TrySplitTile"/>. <see langword="false"/> if it is a root level <see cref="TileView"/>.
  455. /// </para>
  456. /// </summary>
  457. /// <remarks>Note that manually adding one <see cref="TileView"/> to another will not result in a parent/child
  458. /// relationship and both will still be considered 'root' containers. Always use
  459. /// <see cref="TrySplitTile(int, int, out TileView)"/> if you want to subdivide a <see cref="TileView"/>.</remarks>
  460. /// <returns></returns>
  461. public bool IsRootTileView ()
  462. {
  463. // TODO: don't want to layout subviews since the parent recursively lays them all out
  464. return parentTileView == null;
  465. }
  466. /// <summary>
  467. /// Returns the immediate parent <see cref="TileView"/> of this. Note that in case
  468. /// of deep nesting this might not be the root <see cref="TileView"/>. Returns null
  469. /// if this instance is not a nested child (created with
  470. /// <see cref="TrySplitTile(int, int, out TileView)"/>)
  471. /// </summary>
  472. /// <remarks>
  473. /// Use <see cref="IsRootTileView"/> to determine if the returned value is the root.
  474. /// </remarks>
  475. /// <returns></returns>
  476. public TileView GetParentTileView ()
  477. {
  478. return this.parentTileView;
  479. }
  480. private TileView GetRootTileView ()
  481. {
  482. TileView root = this;
  483. while (root.parentTileView != null) {
  484. root = root.parentTileView;
  485. }
  486. return root;
  487. }
  488. private void Setup (Rect bounds)
  489. {
  490. if (bounds.IsEmpty || bounds.Height <= 0 || bounds.Width <= 0) {
  491. return;
  492. }
  493. for (int i = 0; i < splitterLines.Count; i++) {
  494. var line = splitterLines[i];
  495. line.Orientation = Orientation;
  496. line.Width = orientation == Orientation.Vertical
  497. ? 1 : Dim.Fill ();
  498. line.Height = orientation == Orientation.Vertical
  499. ? Dim.Fill () : 1;
  500. line.LineRune = orientation == Orientation.Vertical ?
  501. Driver.VLine : Driver.HLine;
  502. if (orientation == Orientation.Vertical) {
  503. line.X = splitterDistances [i];
  504. line.Y = 0;
  505. }
  506. else {
  507. line.Y = splitterDistances [i];
  508. line.X = 0;
  509. }
  510. }
  511. HideSplittersBasedOnTileVisibility ();
  512. var visibleTiles = tiles.Where (t => t.View.Visible).ToArray ();
  513. var visibleSplitterLines = splitterLines.Where (l => l.Visible).ToArray ();
  514. for (int i = 0; i < visibleTiles.Length; i++) {
  515. var tile = visibleTiles [i];
  516. // TODO: Deal with lines being Visibility false
  517. if (Orientation == Orientation.Vertical) {
  518. tile.View.X = i == 0 ? bounds.X : Pos.Right (visibleSplitterLines [i - 1]);
  519. tile.View.Y = bounds.Y;
  520. tile.View.Height = bounds.Height;
  521. tile.View.Width = GetTileWidthOrHeight(i, Bounds.Width, visibleTiles,visibleSplitterLines);
  522. } else {
  523. tile.View.X = bounds.X;
  524. tile.View.Y = i == 0 ? 0 : Pos.Bottom (visibleSplitterLines [i - 1]);
  525. tile.View.Width = bounds.Width;
  526. tile.View.Height = GetTileWidthOrHeight(i, Bounds.Height, visibleTiles, visibleSplitterLines);
  527. }
  528. }
  529. }
  530. private void HideSplittersBasedOnTileVisibility ()
  531. {
  532. if(splitterLines.Count == 0) {
  533. return;
  534. }
  535. foreach(var line in splitterLines) {
  536. line.Visible = true;
  537. }
  538. for(int i=0;i<tiles.Count;i++) {
  539. if (!tiles [i].View.Visible) {
  540. // when a tile is not visible, prefer hiding
  541. // the splitter on it's left
  542. var candidate = splitterLines [Math.Max (0, i - 1)];
  543. // unless that splitter is already hidden
  544. // e.g. when hiding panels 0 and 1 of a 3 panel
  545. // container
  546. if (candidate.Visible) {
  547. candidate.Visible = false;
  548. }
  549. else {
  550. splitterLines [Math.Min(i,splitterLines.Count-1)].Visible = false;
  551. }
  552. }
  553. }
  554. }
  555. private Dim GetTileWidthOrHeight (int i, int space, Tile[] visibleTiles, TileViewLineView [] visibleSplitterLines)
  556. {
  557. // last tile
  558. if(i + 1 >= visibleTiles.Length)
  559. {
  560. return Dim.Fill (HasBorder () ? 1 : 0);
  561. }
  562. var nextSplitter = visibleSplitterLines [i];
  563. var nextSplitterPos = Orientation == Orientation.Vertical ?
  564. nextSplitter.X : nextSplitter.Y;
  565. var nextSplitterDistance = nextSplitterPos.Anchor (space);
  566. var lastSplitter = i >= 1 ? visibleSplitterLines [i-1]:null;
  567. var lastSplitterPos = Orientation == Orientation.Vertical ?
  568. lastSplitter?.X : lastSplitter?.Y;
  569. var lastSplitterDistance = lastSplitterPos?.Anchor (space) ?? 0;
  570. var distance = nextSplitterDistance - lastSplitterDistance;
  571. if(i>0) {
  572. return distance - 1;
  573. }
  574. return distance - (HasBorder() ? 1 : 0);
  575. }
  576. private class TileTitleToRender
  577. {
  578. public Tile Tile {get;}
  579. public int Depth {get;}
  580. public TileTitleToRender(Tile tile, int depth)
  581. {
  582. Tile = tile;
  583. Depth = depth;
  584. }
  585. /// <summary>
  586. /// Translates the <see cref="Tile"/> title location from its local
  587. /// coordinate space <paramref name="intoCoordinateSpace"/>.
  588. /// </summary>
  589. public Point GetLocalCoordinateForTitle(TileView intoCoordinateSpace)
  590. {
  591. Tile.View.ViewToScreen(0,0, out var screenCol, out var screenRow);
  592. screenRow--;
  593. return intoCoordinateSpace.ScreenToView(screenCol,screenRow);
  594. }
  595. }
  596. private class TileViewLineView : LineView {
  597. public TileView Parent { get; private set; }
  598. public int Idx { get; }
  599. Point? dragPosition;
  600. Pos dragOrignalPos;
  601. public Point? moveRuneRenderLocation;
  602. public TileViewLineView (TileView parent, int idx)
  603. {
  604. CanFocus = true;
  605. TabStop = true;
  606. this.Parent = parent;
  607. Idx = idx;
  608. base.AddCommand (Command.Right, () => {
  609. return MoveSplitter (1, 0);
  610. });
  611. base.AddCommand (Command.Left, () => {
  612. return MoveSplitter (-1, 0);
  613. });
  614. base.AddCommand (Command.LineUp, () => {
  615. return MoveSplitter (0, -1);
  616. });
  617. base.AddCommand (Command.LineDown, () => {
  618. return MoveSplitter (0, 1);
  619. });
  620. AddKeyBinding (Key.CursorRight, Command.Right);
  621. AddKeyBinding (Key.CursorLeft, Command.Left);
  622. AddKeyBinding (Key.CursorUp, Command.LineUp);
  623. AddKeyBinding (Key.CursorDown, Command.LineDown);
  624. }
  625. public override bool ProcessKey (KeyEvent kb)
  626. {
  627. if (!CanFocus || !HasFocus) {
  628. return base.ProcessKey (kb);
  629. }
  630. var result = InvokeKeybindings (kb);
  631. if (result != null)
  632. return (bool)result;
  633. return base.ProcessKey (kb);
  634. }
  635. public override void PositionCursor ()
  636. {
  637. base.PositionCursor ();
  638. var location = moveRuneRenderLocation ??
  639. new Point (Bounds.Width / 2, Bounds.Height / 2);
  640. Move (location.X, location.Y);
  641. }
  642. public override bool OnEnter (View view)
  643. {
  644. Driver.SetCursorVisibility (CursorVisibility.Default);
  645. PositionCursor ();
  646. return base.OnEnter (view);
  647. }
  648. public override void Redraw (Rect bounds)
  649. {
  650. base.Redraw (bounds);
  651. DrawSplitterSymbol ();
  652. }
  653. public void DrawSplitterSymbol ()
  654. {
  655. if (CanFocus && HasFocus) {
  656. var location = moveRuneRenderLocation ??
  657. new Point (Bounds.Width / 2, Bounds.Height / 2);
  658. AddRune (location.X, location.Y, Driver.Diamond);
  659. }
  660. }
  661. public override bool MouseEvent (MouseEvent mouseEvent)
  662. {
  663. if (!CanFocus) {
  664. return true;
  665. }
  666. if (!dragPosition.HasValue && (mouseEvent.Flags == MouseFlags.Button1Pressed)) {
  667. // Start a Drag
  668. SetFocus ();
  669. Application.EnsuresTopOnFront ();
  670. if (mouseEvent.Flags == MouseFlags.Button1Pressed) {
  671. dragPosition = new Point (mouseEvent.X, mouseEvent.Y);
  672. dragOrignalPos = Orientation == Orientation.Horizontal ? Y : X;
  673. Application.GrabMouse (this);
  674. if (Orientation == Orientation.Horizontal) {
  675. } else {
  676. moveRuneRenderLocation = new Point (0, Math.Max (1, Math.Min (Bounds.Height - 2, mouseEvent.Y)));
  677. }
  678. }
  679. return true;
  680. } else if (
  681. dragPosition.HasValue &&
  682. (mouseEvent.Flags == (MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition))) {
  683. // Continue Drag
  684. // how far has user dragged from original location?
  685. if (Orientation == Orientation.Horizontal) {
  686. int dy = mouseEvent.Y - dragPosition.Value.Y;
  687. Parent.SetSplitterPos (Idx, Offset (Y, dy));
  688. moveRuneRenderLocation = new Point (mouseEvent.X, 0);
  689. } else {
  690. int dx = mouseEvent.X - dragPosition.Value.X;
  691. Parent.SetSplitterPos (Idx, Offset (X, dx));
  692. moveRuneRenderLocation = new Point (0, Math.Max (1, Math.Min (Bounds.Height - 2, mouseEvent.Y)));
  693. }
  694. Parent.SetNeedsDisplay ();
  695. return true;
  696. }
  697. if (mouseEvent.Flags.HasFlag (MouseFlags.Button1Released) && dragPosition.HasValue) {
  698. // End Drag
  699. Application.UngrabMouse ();
  700. Driver.UncookMouse ();
  701. FinalisePosition (
  702. dragOrignalPos,
  703. Orientation == Orientation.Horizontal ? Y : X);
  704. dragPosition = null;
  705. moveRuneRenderLocation = null;
  706. }
  707. return false;
  708. }
  709. private bool MoveSplitter (int distanceX, int distanceY)
  710. {
  711. if (Orientation == Orientation.Vertical) {
  712. // Cannot move in this direction
  713. if (distanceX == 0) {
  714. return false;
  715. }
  716. var oldX = X;
  717. return FinalisePosition (oldX, Offset (X, distanceX));
  718. } else {
  719. // Cannot move in this direction
  720. if (distanceY == 0) {
  721. return false;
  722. }
  723. var oldY = Y;
  724. return FinalisePosition (oldY, (Pos)Offset (Y, distanceY));
  725. }
  726. }
  727. private Pos Offset (Pos pos, int delta)
  728. {
  729. var posAbsolute = pos.Anchor (Orientation == Orientation.Horizontal ?
  730. Parent.Bounds.Height : Parent.Bounds.Width);
  731. return posAbsolute + delta;
  732. }
  733. /// <summary>
  734. /// <para>
  735. /// Moves <see cref="Parent"/> <see cref="TileView.SplitterDistances"/> to
  736. /// <see cref="Pos"/> <paramref name="newValue"/> preserving <see cref="Pos"/> format
  737. /// (absolute / relative) that <paramref name="oldValue"/> had.
  738. /// </para>
  739. /// <remarks>This ensures that if splitter location was e.g. 50% before and you move it
  740. /// to absolute 5 then you end up with 10% (assuming a parent had 50 width). </remarks>
  741. /// </summary>
  742. /// <param name="oldValue"></param>
  743. /// <param name="newValue"></param>
  744. private bool FinalisePosition (Pos oldValue, Pos newValue)
  745. {
  746. if (oldValue is Pos.PosFactor) {
  747. if (Orientation == Orientation.Horizontal) {
  748. return Parent.SetSplitterPos(Idx, ConvertToPosFactor (newValue, Parent.Bounds.Height));
  749. } else {
  750. return Parent.SetSplitterPos (Idx, ConvertToPosFactor (newValue, Parent.Bounds.Width));
  751. }
  752. } else {
  753. return Parent.SetSplitterPos (Idx, newValue);
  754. }
  755. }
  756. /// <summary>
  757. /// <para>
  758. /// Determines the absolute position of <paramref name="p"/> and
  759. /// returns a <see cref="Pos.PosFactor"/> that describes the percentage of that.
  760. /// </para>
  761. /// <para>Effectively turning any <see cref="Pos"/> into a <see cref="Pos.PosFactor"/>
  762. /// (as if created with <see cref="Pos.Percent(float)"/>)</para>
  763. /// </summary>
  764. /// <param name="p">The <see cref="Pos"/> to convert to <see cref="Pos.Percent(float)"/></param>
  765. /// <param name="parentLength">The Height/Width that <paramref name="p"/> lies within</param>
  766. /// <returns></returns>
  767. private Pos ConvertToPosFactor (Pos p, int parentLength)
  768. {
  769. // calculate position in the 'middle' of the cell at p distance along parentLength
  770. float position = p.Anchor (parentLength) + 0.5f;
  771. return new Pos.PosFactor (position / parentLength);
  772. }
  773. }
  774. private bool HasBorder ()
  775. {
  776. return IntegratedBorder != BorderStyle.None;
  777. }
  778. }
  779. /// <summary>
  780. /// Provides data for <see cref="TileView"/> events.
  781. /// </summary>
  782. public class SplitterEventArgs : EventArgs {
  783. /// <summary>
  784. /// Creates a new instance of the <see cref="SplitterEventArgs"/> class.
  785. /// </summary>
  786. /// <param name="tileView"><see cref="TileView"/> in which splitter is being moved.</param>
  787. /// <param name="idx">Index of the splitter being moved in <see cref="TileView.SplitterDistances"/>.</param>
  788. /// <param name="splitterDistance">The new <see cref="Pos"/> of the splitter line.</param>
  789. public SplitterEventArgs (TileView tileView, int idx, Pos splitterDistance)
  790. {
  791. SplitterDistance = splitterDistance;
  792. TileView = tileView;
  793. Idx = idx;
  794. }
  795. /// <summary>
  796. /// New position of the splitter line (see <see cref="TileView.SplitterDistances"/>).
  797. /// </summary>
  798. public Pos SplitterDistance { get; }
  799. /// <summary>
  800. /// Container (sender) of the event.
  801. /// </summary>
  802. public TileView TileView { get; }
  803. /// <summary>
  804. /// Gets the index of the splitter that is being moved. This can be
  805. /// used to index <see cref="TileView.SplitterDistances"/>
  806. /// </summary>
  807. public int Idx { get; }
  808. }
  809. /// <summary>
  810. /// Represents a method that will handle splitter events.
  811. /// </summary>
  812. public delegate void SplitterEventHandler (object sender, SplitterEventArgs e);
  813. }