mirror of
https://github.com/gui-cs/Terminal.Gui.git
synced 2025-12-29 01:07:58 +01:00
e2feeefa93
* Move all public nested classes out into own files * Move more nested classes out * Tidy up and treat CA1034 as an error. Fix remaining nested classes. * Remove partial keyword from ThemeManager as it is no longer needed * Rename Bar to BarSeriesBar to more clearly indicate it is part of GraphView subsystem * Fix xmldoc references * Revert nesting changes to ConsoleDrivers * Change to file scoped namespaces and revert renames - LineCanvasCell back to just Cell - ApplicationRunState back to just RunState * Switch to file scoped namespaces
95 lines
3.1 KiB
C#
95 lines
3.1 KiB
C#
using System;
|
|
|
|
namespace Terminal.Gui;
|
|
|
|
/// <summary>
|
|
/// A single <see cref="ContentView"/> presented in a <see cref="TileView"/>. To create
|
|
/// new instances use <see cref="TileView.RebuildForTileCount(int)"/>
|
|
/// or <see cref="TileView.InsertTile(int)"/>.
|
|
/// </summary>
|
|
public class Tile {
|
|
/// <summary>
|
|
/// The <see cref="ContentView"/> that is contained in this <see cref="TileView"/>.
|
|
/// Add new child views to this member for multiple
|
|
/// <see cref="ContentView"/>s within the <see cref="Tile"/>.
|
|
/// </summary>
|
|
public View ContentView { get; internal set; }
|
|
|
|
/// <summary>
|
|
/// Gets or Sets the minimum size you to allow when splitter resizing along
|
|
/// parent <see cref="TileView.Orientation"/> direction.
|
|
/// </summary>
|
|
public int MinSize { get; set; }
|
|
|
|
/// <summary>
|
|
/// The text that should be displayed above the <see cref="ContentView"/>. This
|
|
/// will appear over the splitter line or border (above the view client area).
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Title are not rendered for root level tiles
|
|
/// <see cref="Gui.LineStyle"/> is <see cref="LineStyle.None"/>.
|
|
///</remarks>
|
|
public string Title {
|
|
get => _title;
|
|
set {
|
|
if (!OnTitleChanging (_title, value)) {
|
|
var old = _title;
|
|
_title = value;
|
|
OnTitleChanged (old, _title);
|
|
return;
|
|
}
|
|
_title = value;
|
|
}
|
|
}
|
|
|
|
private string _title = string.Empty;
|
|
|
|
/// <summary>
|
|
/// Called before the <see cref="Title"/> changes. Invokes the <see cref="TitleChanging"/> event, which can be cancelled.
|
|
/// </summary>
|
|
/// <param name="oldTitle">The <see cref="Title"/> that is/has been replaced.</param>
|
|
/// <param name="newTitle">The new <see cref="Title"/> to be replaced.</param>
|
|
/// <returns><c>true</c> if an event handler cancelled the Title change.</returns>
|
|
public virtual bool OnTitleChanging (string oldTitle, string newTitle)
|
|
{
|
|
var args = new TitleEventArgs (oldTitle, newTitle);
|
|
TitleChanging?.Invoke (this, args);
|
|
return args.Cancel;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Event fired when the <see cref="Title"/> is changing. Set <see cref="TitleEventArgs.Cancel"/> to
|
|
/// <c>true</c> to cancel the Title change.
|
|
/// </summary>
|
|
public event EventHandler<TitleEventArgs> TitleChanging;
|
|
|
|
/// <summary>
|
|
/// Called when the <see cref="Title"/> has been changed. Invokes the <see cref="TitleChanged"/> event.
|
|
/// </summary>
|
|
/// <param name="oldTitle">The <see cref="Title"/> that is/has been replaced.</param>
|
|
/// <param name="newTitle">The new <see cref="Title"/> to be replaced.</param>
|
|
public virtual void OnTitleChanged (string oldTitle, string newTitle)
|
|
{
|
|
var args = new TitleEventArgs (oldTitle, newTitle);
|
|
TitleChanged?.Invoke (this, args);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Event fired after the <see cref="Title"/> has been changed.
|
|
/// </summary>
|
|
public event EventHandler<TitleEventArgs> TitleChanged;
|
|
|
|
/// <summary>
|
|
/// Creates a new instance of the <see cref="Tile"/> class.
|
|
/// </summary>
|
|
public Tile ()
|
|
{
|
|
ContentView = new View () { Width = Dim.Fill (), Height = Dim.Fill () };
|
|
#if DEBUG_IDISPOSABLE
|
|
ContentView.Data = "Tile.ContentView";
|
|
#endif
|
|
Title = string.Empty;
|
|
MinSize = 0;
|
|
}
|
|
}
|