TileView.cs 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988
  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) {
  262. int posUs = value.Anchor (fullSpace);
  263. // Cannot move off screen right
  264. if (posUs >= fullSpace) {
  265. return false;
  266. }
  267. // Cannot move off screen left
  268. if (posUs <= 0) {
  269. return false;
  270. }
  271. // Do not allow splitter to move left of the one before
  272. if (idx > 0) {
  273. int posLeft = splitterDistances [idx - 1].Anchor (fullSpace);
  274. if (posUs <= posLeft) {
  275. return false;
  276. }
  277. }
  278. // Do not allow splitter to move right of the one after
  279. if (idx+1 < splitterDistances.Count) {
  280. int posLeft = splitterDistances [idx + 1].Anchor (fullSpace);
  281. if (posUs >= posLeft) {
  282. return false;
  283. }
  284. }
  285. }
  286. splitterDistances [idx] = value;
  287. GetRootTileView ().LayoutSubviews ();
  288. OnSplitterMoved (idx);
  289. return true;
  290. }
  291. /// <inheritdoc/>
  292. public override bool OnEnter (View view)
  293. {
  294. Driver.SetCursorVisibility (CursorVisibility.Invisible);
  295. return base.OnEnter (view);
  296. }
  297. /// <inheritdoc/>
  298. public override void Redraw (Rect bounds)
  299. {
  300. // TODO: We are getting passed stale bounds, does this only happen in TileView
  301. // or is it a larger problem? This line should not be required right?
  302. bounds = Bounds;
  303. Driver.SetAttribute (ColorScheme.Normal);
  304. Clear ();
  305. base.Redraw (bounds);
  306. var lc = new LineCanvas ();
  307. var allLines = GetAllLineViewsRecursively (this);
  308. var allTitlesToRender = GetAllTitlesToRenderRecursively(this);
  309. if (IsRootTileView ()) {
  310. if (HasBorder ()) {
  311. lc.AddLine (new Point (0, 0), bounds.Width - 1, Orientation.Horizontal, IntegratedBorder);
  312. lc.AddLine (new Point (0, 0), bounds.Height - 1, Orientation.Vertical, IntegratedBorder);
  313. lc.AddLine (new Point (bounds.Width - 1, bounds.Height - 1), -bounds.Width + 1, Orientation.Horizontal, IntegratedBorder);
  314. lc.AddLine (new Point (bounds.Width - 1, bounds.Height - 1), -bounds.Height + 1, Orientation.Vertical, IntegratedBorder);
  315. }
  316. foreach (var line in allLines) {
  317. bool isRoot = splitterLines.Contains (line);
  318. line.ViewToScreen (0, 0, out var x1, out var y1);
  319. var origin = ScreenToView (x1, y1);
  320. var length = line.Orientation == Orientation.Horizontal ?
  321. line.Frame.Width - 1 :
  322. line.Frame.Height - 1;
  323. if (!isRoot) {
  324. if (line.Orientation == Orientation.Horizontal) {
  325. origin.X -= 1;
  326. } else {
  327. origin.Y -= 1;
  328. }
  329. length += 2;
  330. }
  331. lc.AddLine (origin, length, line.Orientation, IntegratedBorder);
  332. }
  333. }
  334. Driver.SetAttribute (ColorScheme.Normal);
  335. lc.Draw (this, bounds);
  336. // Redraw the lines so that focus/drag symbol renders
  337. foreach (var line in allLines) {
  338. line.DrawSplitterSymbol ();
  339. }
  340. // Draw Titles over Border
  341. foreach(var titleToRender in allTitlesToRender)
  342. {
  343. var renderAt = titleToRender.GetLocalCoordinateForTitle(this);
  344. if(renderAt.Y < 0)
  345. {
  346. // If we have no border then root level tiles
  347. // have nowhere to render their titles.
  348. continue;
  349. }
  350. // TODO: Render with focus color if focused
  351. var title = titleToRender.Tile.Title;
  352. for(int i=0;i<title.Length;i++)
  353. {
  354. AddRune(renderAt.X+i,renderAt.Y,title[i]);
  355. }
  356. }
  357. }
  358. /// <summary>
  359. /// Converts <see cref="Tile.View"/> of <see cref="Tiles"/> element <paramref name="idx"/>
  360. /// from a regular <see cref="View"/> to a new nested <see cref="TileView"/> with <paramref name="panels"/>
  361. /// number of panels. Returns false if the element already contains a nested view.
  362. /// </summary>
  363. /// <remarks>After successful splitting, the <paramref name="result"/> <see cref="TileView"/>
  364. /// will contain the previous (replaced) <see cref="Tile.View"/> at element 0.</remarks>
  365. /// <param name="idx">The element of <see cref="Tiles"/> that is to be subdivided.</param>
  366. /// <param name="panels">The number of panels that the <see cref="Tile"/> should be split into</param>
  367. /// <param name="result">The new nested <see cref="TileView"/>.</param>
  368. /// <returns><see langword="true"/> if a <see cref="View"/> was converted to a new nested
  369. /// <see cref="TileView"/>. <see langword="false"/> if it was already a nested
  370. /// <see cref="TileView"/></returns>
  371. public bool TrySplitTile(int idx, int panels, out TileView result)
  372. {
  373. // when splitting a view into 2 sub views we will need to migrate
  374. // the title too
  375. var tile = tiles [idx];
  376. // TODO: migrate the title too right?
  377. var title = tile.Title;
  378. View toMove = tile.View;
  379. if (toMove is TileView existing) {
  380. result = existing;
  381. return false;
  382. }
  383. var newContainer = new TileView(panels) {
  384. Width = Dim.Fill (),
  385. Height = Dim.Fill (),
  386. parentTileView = this,
  387. };
  388. // Take everything out of the View we are moving
  389. var childViews = toMove.Subviews.ToArray();
  390. toMove.RemoveAll ();
  391. // Remove the view itself and replace it with the new TileView
  392. Remove (toMove);
  393. Add (newContainer);
  394. tile.View = newContainer;
  395. var newTileView1 = newContainer.tiles [0].View;
  396. // Add the original content into the first view of the new container
  397. foreach (var childView in childViews) {
  398. newTileView1.Add (childView);
  399. }
  400. result = newContainer;
  401. return true;
  402. }
  403. private List<TileViewLineView> GetAllLineViewsRecursively (View v)
  404. {
  405. var lines = new List<TileViewLineView> ();
  406. foreach (var sub in v.Subviews) {
  407. if (sub is TileViewLineView s) {
  408. if (s.Visible && s.Parent.GetRootTileView () == this) {
  409. lines.Add (s);
  410. }
  411. } else {
  412. if(sub.Visible) {
  413. lines.AddRange (GetAllLineViewsRecursively (sub));
  414. }
  415. }
  416. }
  417. return lines;
  418. }
  419. private List<TileTitleToRender> GetAllTitlesToRenderRecursively (TileView v, int depth = 0)
  420. {
  421. var titles = new List<TileTitleToRender> ();
  422. foreach (var sub in v.Tiles) {
  423. // Don't render titles for invisible stuff!
  424. if(!sub.View.Visible)
  425. {
  426. continue;
  427. }
  428. if(sub.View is TileView subTileView)
  429. {
  430. // Panels with sub split tiles in them can never
  431. // have their Titles rendered. Instead we dive in
  432. // and pull up their children as titles
  433. titles.AddRange (GetAllTitlesToRenderRecursively (subTileView,depth+1));
  434. }
  435. else
  436. {
  437. if(sub.Title.Length > 0)
  438. {
  439. titles.Add(new TileTitleToRender(sub,depth));
  440. }
  441. }
  442. }
  443. return titles;
  444. }
  445. /// <summary>
  446. /// <para>
  447. /// <see langword="true"/> if <see cref="TileView"/> is nested within a parent <see cref="TileView"/>
  448. /// e.g. via the <see cref="TrySplitTile"/>. <see langword="false"/> if it is a root level <see cref="TileView"/>.
  449. /// </para>
  450. /// </summary>
  451. /// <remarks>Note that manually adding one <see cref="TileView"/> to another will not result in a parent/child
  452. /// relationship and both will still be considered 'root' containers. Always use
  453. /// <see cref="TrySplitTile(int, int, out TileView)"/> if you want to subdivide a <see cref="TileView"/>.</remarks>
  454. /// <returns></returns>
  455. public bool IsRootTileView ()
  456. {
  457. // TODO: don't want to layout subviews since the parent recursively lays them all out
  458. return parentTileView == null;
  459. }
  460. /// <summary>
  461. /// Returns the immediate parent <see cref="TileView"/> of this. Note that in case
  462. /// of deep nesting this might not be the root <see cref="TileView"/>. Returns null
  463. /// if this instance is not a nested child (created with
  464. /// <see cref="TrySplitTile(int, int, out TileView)"/>)
  465. /// </summary>
  466. /// <remarks>
  467. /// Use <see cref="IsRootTileView"/> to determine if the returned value is the root.
  468. /// </remarks>
  469. /// <returns></returns>
  470. public TileView GetParentTileView ()
  471. {
  472. return this.parentTileView;
  473. }
  474. private TileView GetRootTileView ()
  475. {
  476. TileView root = this;
  477. while (root.parentTileView != null) {
  478. root = root.parentTileView;
  479. }
  480. return root;
  481. }
  482. private void Setup (Rect bounds)
  483. {
  484. if (bounds.IsEmpty || bounds.Height <= 0 || bounds.Width <= 0) {
  485. return;
  486. }
  487. for (int i = 0; i < splitterLines.Count; i++) {
  488. var line = splitterLines[i];
  489. line.Orientation = Orientation;
  490. line.Width = orientation == Orientation.Vertical
  491. ? 1 : Dim.Fill ();
  492. line.Height = orientation == Orientation.Vertical
  493. ? Dim.Fill () : 1;
  494. line.LineRune = orientation == Orientation.Vertical ?
  495. Driver.VLine : Driver.HLine;
  496. if (orientation == Orientation.Vertical) {
  497. line.X = splitterDistances [i];
  498. line.Y = 0;
  499. }
  500. else {
  501. line.Y = splitterDistances [i];
  502. line.X = 0;
  503. }
  504. }
  505. HideSplittersBasedOnTileVisibility ();
  506. var visibleTiles = tiles.Where (t => t.View.Visible).ToArray ();
  507. var visibleSplitterLines = splitterLines.Where (l => l.Visible).ToArray ();
  508. for (int i = 0; i < visibleTiles.Length; i++) {
  509. var tile = visibleTiles [i];
  510. // TODO: Deal with lines being Visibility false
  511. if (Orientation == Orientation.Vertical) {
  512. tile.View.X = i == 0 ? bounds.X : Pos.Right (visibleSplitterLines [i - 1]);
  513. tile.View.Y = bounds.Y;
  514. tile.View.Height = bounds.Height;
  515. tile.View.Width = GetTileWidthOrHeight(i, Bounds.Width, visibleTiles,visibleSplitterLines);
  516. } else {
  517. tile.View.X = bounds.X;
  518. tile.View.Y = i == 0 ? 0 : Pos.Bottom (visibleSplitterLines [i - 1]);
  519. tile.View.Width = bounds.Width;
  520. tile.View.Height = GetTileWidthOrHeight(i, Bounds.Height, visibleTiles, visibleSplitterLines);
  521. }
  522. }
  523. }
  524. private void HideSplittersBasedOnTileVisibility ()
  525. {
  526. if(splitterLines.Count == 0) {
  527. return;
  528. }
  529. foreach(var line in splitterLines) {
  530. line.Visible = true;
  531. }
  532. for(int i=0;i<tiles.Count;i++) {
  533. if (!tiles [i].View.Visible) {
  534. // when a tile is not visible, prefer hiding
  535. // the splitter on it's left
  536. var candidate = splitterLines [Math.Max (0, i - 1)];
  537. // unless that splitter is already hidden
  538. // e.g. when hiding panels 0 and 1 of a 3 panel
  539. // container
  540. if (candidate.Visible) {
  541. candidate.Visible = false;
  542. }
  543. else {
  544. splitterLines [Math.Min(i,splitterLines.Count-1)].Visible = false;
  545. }
  546. }
  547. }
  548. }
  549. private Dim GetTileWidthOrHeight (int i, int space, Tile[] visibleTiles, TileViewLineView [] visibleSplitterLines)
  550. {
  551. // last tile
  552. if(i + 1 >= visibleTiles.Length)
  553. {
  554. return Dim.Fill (HasBorder () ? 1 : 0);
  555. }
  556. var nextSplitter = visibleSplitterLines [i];
  557. var nextSplitterPos = Orientation == Orientation.Vertical ?
  558. nextSplitter.X : nextSplitter.Y;
  559. var nextSplitterDistance = nextSplitterPos.Anchor (space);
  560. var lastSplitter = i >= 1 ? visibleSplitterLines [i-1]:null;
  561. var lastSplitterPos = Orientation == Orientation.Vertical ?
  562. lastSplitter?.X : lastSplitter?.Y;
  563. var lastSplitterDistance = lastSplitterPos?.Anchor (space) ?? 0;
  564. var distance = nextSplitterDistance - lastSplitterDistance;
  565. if(i>0) {
  566. return distance - 1;
  567. }
  568. return distance - (HasBorder() ? 1 : 0);
  569. }
  570. private class TileTitleToRender
  571. {
  572. public Tile Tile {get;}
  573. public int Depth {get;}
  574. public TileTitleToRender(Tile tile, int depth)
  575. {
  576. Tile = tile;
  577. Depth = depth;
  578. }
  579. /// <summary>
  580. /// Translates the <see cref="Tile"/> title location from its local
  581. /// coordinate space <paramref name="intoCoordinateSpace"/>.
  582. /// </summary>
  583. public Point GetLocalCoordinateForTitle(TileView intoCoordinateSpace)
  584. {
  585. Tile.View.ViewToScreen(0,0, out var screenCol, out var screenRow);
  586. screenRow--;
  587. return intoCoordinateSpace.ScreenToView(screenCol,screenRow);
  588. }
  589. }
  590. private class TileViewLineView : LineView {
  591. public TileView Parent { get; private set; }
  592. public int Idx { get; }
  593. Point? dragPosition;
  594. Pos dragOrignalPos;
  595. public Point? moveRuneRenderLocation;
  596. public TileViewLineView (TileView parent, int idx)
  597. {
  598. CanFocus = true;
  599. TabStop = true;
  600. this.Parent = parent;
  601. Idx = idx;
  602. base.AddCommand (Command.Right, () => {
  603. return MoveSplitter (1, 0);
  604. });
  605. base.AddCommand (Command.Left, () => {
  606. return MoveSplitter (-1, 0);
  607. });
  608. base.AddCommand (Command.LineUp, () => {
  609. return MoveSplitter (0, -1);
  610. });
  611. base.AddCommand (Command.LineDown, () => {
  612. return MoveSplitter (0, 1);
  613. });
  614. AddKeyBinding (Key.CursorRight, Command.Right);
  615. AddKeyBinding (Key.CursorLeft, Command.Left);
  616. AddKeyBinding (Key.CursorUp, Command.LineUp);
  617. AddKeyBinding (Key.CursorDown, Command.LineDown);
  618. }
  619. public override bool ProcessKey (KeyEvent kb)
  620. {
  621. if (!CanFocus || !HasFocus) {
  622. return base.ProcessKey (kb);
  623. }
  624. var result = InvokeKeybindings (kb);
  625. if (result != null)
  626. return (bool)result;
  627. return base.ProcessKey (kb);
  628. }
  629. public override void PositionCursor ()
  630. {
  631. base.PositionCursor ();
  632. var location = moveRuneRenderLocation ??
  633. new Point (Bounds.Width / 2, Bounds.Height / 2);
  634. Move (location.X, location.Y);
  635. }
  636. public override bool OnEnter (View view)
  637. {
  638. Driver.SetCursorVisibility (CursorVisibility.Default);
  639. PositionCursor ();
  640. return base.OnEnter (view);
  641. }
  642. public override void Redraw (Rect bounds)
  643. {
  644. base.Redraw (bounds);
  645. DrawSplitterSymbol ();
  646. }
  647. public void DrawSplitterSymbol ()
  648. {
  649. if (CanFocus && HasFocus) {
  650. var location = moveRuneRenderLocation ??
  651. new Point (Bounds.Width / 2, Bounds.Height / 2);
  652. AddRune (location.X, location.Y, Driver.Diamond);
  653. }
  654. }
  655. public override bool MouseEvent (MouseEvent mouseEvent)
  656. {
  657. if (!CanFocus) {
  658. return true;
  659. }
  660. if (!dragPosition.HasValue && (mouseEvent.Flags == MouseFlags.Button1Pressed)) {
  661. // Start a Drag
  662. SetFocus ();
  663. Application.EnsuresTopOnFront ();
  664. if (mouseEvent.Flags == MouseFlags.Button1Pressed) {
  665. dragPosition = new Point (mouseEvent.X, mouseEvent.Y);
  666. dragOrignalPos = Orientation == Orientation.Horizontal ? Y : X;
  667. Application.GrabMouse (this);
  668. if (Orientation == Orientation.Horizontal) {
  669. } else {
  670. moveRuneRenderLocation = new Point (0, Math.Max (1, Math.Min (Bounds.Height - 2, mouseEvent.Y)));
  671. }
  672. }
  673. return true;
  674. } else if (
  675. dragPosition.HasValue &&
  676. (mouseEvent.Flags == (MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition))) {
  677. // Continue Drag
  678. // how far has user dragged from original location?
  679. if (Orientation == Orientation.Horizontal) {
  680. int dy = mouseEvent.Y - dragPosition.Value.Y;
  681. Parent.SetSplitterPos (Idx, Offset (Y, dy));
  682. moveRuneRenderLocation = new Point (mouseEvent.X, 0);
  683. } else {
  684. int dx = mouseEvent.X - dragPosition.Value.X;
  685. Parent.SetSplitterPos (Idx, Offset (X, dx));
  686. moveRuneRenderLocation = new Point (0, Math.Max (1, Math.Min (Bounds.Height - 2, mouseEvent.Y)));
  687. }
  688. Parent.SetNeedsDisplay ();
  689. return true;
  690. }
  691. if (mouseEvent.Flags.HasFlag (MouseFlags.Button1Released) && dragPosition.HasValue) {
  692. // End Drag
  693. Application.UngrabMouse ();
  694. Driver.UncookMouse ();
  695. FinalisePosition (
  696. dragOrignalPos,
  697. Orientation == Orientation.Horizontal ? Y : X);
  698. dragPosition = null;
  699. moveRuneRenderLocation = null;
  700. }
  701. return false;
  702. }
  703. private bool MoveSplitter (int distanceX, int distanceY)
  704. {
  705. if (Orientation == Orientation.Vertical) {
  706. // Cannot move in this direction
  707. if (distanceX == 0) {
  708. return false;
  709. }
  710. var oldX = X;
  711. return FinalisePosition (oldX, Offset (X, distanceX));
  712. } else {
  713. // Cannot move in this direction
  714. if (distanceY == 0) {
  715. return false;
  716. }
  717. var oldY = Y;
  718. return FinalisePosition (oldY, (Pos)Offset (Y, distanceY));
  719. }
  720. }
  721. private Pos Offset (Pos pos, int delta)
  722. {
  723. var posAbsolute = pos.Anchor (Orientation == Orientation.Horizontal ?
  724. Parent.Bounds.Height : Parent.Bounds.Width);
  725. return posAbsolute + delta;
  726. }
  727. /// <summary>
  728. /// <para>
  729. /// Moves <see cref="Parent"/> <see cref="TileView.SplitterDistances"/> to
  730. /// <see cref="Pos"/> <paramref name="newValue"/> preserving <see cref="Pos"/> format
  731. /// (absolute / relative) that <paramref name="oldValue"/> had.
  732. /// </para>
  733. /// <remarks>This ensures that if splitter location was e.g. 50% before and you move it
  734. /// to absolute 5 then you end up with 10% (assuming a parent had 50 width). </remarks>
  735. /// </summary>
  736. /// <param name="oldValue"></param>
  737. /// <param name="newValue"></param>
  738. private bool FinalisePosition (Pos oldValue, Pos newValue)
  739. {
  740. if (oldValue is Pos.PosFactor) {
  741. if (Orientation == Orientation.Horizontal) {
  742. return Parent.SetSplitterPos(Idx, ConvertToPosFactor (newValue, Parent.Bounds.Height));
  743. } else {
  744. return Parent.SetSplitterPos (Idx, ConvertToPosFactor (newValue, Parent.Bounds.Width));
  745. }
  746. } else {
  747. return Parent.SetSplitterPos (Idx, newValue);
  748. }
  749. }
  750. /// <summary>
  751. /// <para>
  752. /// Determines the absolute position of <paramref name="p"/> and
  753. /// returns a <see cref="Pos.PosFactor"/> that describes the percentage of that.
  754. /// </para>
  755. /// <para>Effectively turning any <see cref="Pos"/> into a <see cref="Pos.PosFactor"/>
  756. /// (as if created with <see cref="Pos.Percent(float)"/>)</para>
  757. /// </summary>
  758. /// <param name="p">The <see cref="Pos"/> to convert to <see cref="Pos.Percent(float)"/></param>
  759. /// <param name="parentLength">The Height/Width that <paramref name="p"/> lies within</param>
  760. /// <returns></returns>
  761. private Pos ConvertToPosFactor (Pos p, int parentLength)
  762. {
  763. // calculate position in the 'middle' of the cell at p distance along parentLength
  764. float position = p.Anchor (parentLength) + 0.5f;
  765. return new Pos.PosFactor (position / parentLength);
  766. }
  767. }
  768. private bool HasBorder ()
  769. {
  770. return IntegratedBorder != BorderStyle.None;
  771. }
  772. }
  773. /// <summary>
  774. /// Provides data for <see cref="TileView"/> events.
  775. /// </summary>
  776. public class SplitterEventArgs : EventArgs {
  777. /// <summary>
  778. /// Creates a new instance of the <see cref="SplitterEventArgs"/> class.
  779. /// </summary>
  780. /// <param name="tileView"><see cref="TileView"/> in which splitter is being moved.</param>
  781. /// <param name="idx">Index of the splitter being moved in <see cref="TileView.SplitterDistances"/>.</param>
  782. /// <param name="splitterDistance">The new <see cref="Pos"/> of the splitter line.</param>
  783. public SplitterEventArgs (TileView tileView, int idx, Pos splitterDistance)
  784. {
  785. SplitterDistance = splitterDistance;
  786. TileView = tileView;
  787. Idx = idx;
  788. }
  789. /// <summary>
  790. /// New position of the splitter line (see <see cref="TileView.SplitterDistances"/>).
  791. /// </summary>
  792. public Pos SplitterDistance { get; }
  793. /// <summary>
  794. /// Container (sender) of the event.
  795. /// </summary>
  796. public TileView TileView { get; }
  797. /// <summary>
  798. /// Gets the index of the splitter that is being moved. This can be
  799. /// used to index <see cref="TileView.SplitterDistances"/>
  800. /// </summary>
  801. public int Idx { get; }
  802. }
  803. /// <summary>
  804. /// Represents a method that will handle splitter events.
  805. /// </summary>
  806. public delegate void SplitterEventHandler (object sender, SplitterEventArgs e);
  807. }