mirror of
https://github.com/spectreconsole/spectre.console.git
synced 2025-12-27 08:17:57 +01:00
c3ec6a7363
* Add width to panels * Add height to panels * Replace RenderContext with RenderOptions * Remove exclusivity from alternative buffer * Add Layout widget * Add Align widget
107 lines
3.3 KiB
C#
107 lines
3.3 KiB
C#
namespace Spectre.Console.Extensions;
|
|
|
|
/// <summary>
|
|
/// Contains extension methods for <see cref="Align"/>.
|
|
/// </summary>
|
|
public static class AlignExtensions
|
|
{
|
|
/// <summary>
|
|
/// Sets the width.
|
|
/// </summary>
|
|
/// <param name="align">The <see cref="Align"/> object.</param>
|
|
/// <param name="width">The width, or <c>null</c> for no explicit width.</param>
|
|
/// <returns>The same instance so that multiple calls can be chained.</returns>
|
|
public static Align Width(this Align align, int? width)
|
|
{
|
|
if (align is null)
|
|
{
|
|
throw new ArgumentNullException(nameof(align));
|
|
}
|
|
|
|
align.Width = width;
|
|
return align;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Sets the height.
|
|
/// </summary>
|
|
/// <param name="align">The <see cref="Align"/> object.</param>
|
|
/// <param name="height">The height, or <c>null</c> for no explicit height.</param>
|
|
/// <returns>The same instance so that multiple calls can be chained.</returns>
|
|
public static Align Height(this Align align, int? height)
|
|
{
|
|
if (align is null)
|
|
{
|
|
throw new ArgumentNullException(nameof(align));
|
|
}
|
|
|
|
align.Height = height;
|
|
return align;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Sets the vertical alignment.
|
|
/// </summary>
|
|
/// <param name="align">The <see cref="Align"/> object.</param>
|
|
/// <param name="vertical">The vertical alignment, or <c>null</c> for no vertical alignment.</param>
|
|
/// <returns>The same instance so that multiple calls can be chained.</returns>
|
|
public static Align VerticalAlignment(this Align align, VerticalAlignment? vertical)
|
|
{
|
|
if (align is null)
|
|
{
|
|
throw new ArgumentNullException(nameof(align));
|
|
}
|
|
|
|
align.Vertical = vertical;
|
|
return align;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Sets the <see cref="Align"/> object to be top aligned.
|
|
/// </summary>
|
|
/// <param name="align">The <see cref="Align"/> object.</param>
|
|
/// <returns>The same instance so that multiple calls can be chained.</returns>
|
|
public static Align TopAligned(this Align align)
|
|
{
|
|
if (align is null)
|
|
{
|
|
throw new ArgumentNullException(nameof(align));
|
|
}
|
|
|
|
align.Vertical = Console.VerticalAlignment.Top;
|
|
return align;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Sets the <see cref="Align"/> object to be middle aligned.
|
|
/// </summary>
|
|
/// <param name="align">The <see cref="Align"/> object.</param>
|
|
/// <returns>The same instance so that multiple calls can be chained.</returns>
|
|
public static Align MiddleAligned(this Align align)
|
|
{
|
|
if (align is null)
|
|
{
|
|
throw new ArgumentNullException(nameof(align));
|
|
}
|
|
|
|
align.Vertical = Console.VerticalAlignment.Middle;
|
|
return align;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Sets the <see cref="Align"/> object to be bottom aligned.
|
|
/// </summary>
|
|
/// <param name="align">The <see cref="Align"/> object.</param>
|
|
/// <returns>The same instance so that multiple calls can be chained.</returns>
|
|
public static Align BottomAligned(this Align align)
|
|
{
|
|
if (align is null)
|
|
{
|
|
throw new ArgumentNullException(nameof(align));
|
|
}
|
|
|
|
align.Vertical = Console.VerticalAlignment.Bottom;
|
|
return align;
|
|
}
|
|
}
|