Windows

A UIWindow is a window as the game's own: a frame, its title and close button, in the middle of the screen over it dimmed. While it's open nothing under it takes the mouse or the game's hotkeys, and Escape closes it.

A settings-style window

UISettingsWindow is laid out as the game's Settings menu: tabs down its left, a scrolling page on its right and buttons along its bottom.

public class ExampleWindow : UISettingsWindow
{
    private readonly ModContext _context;

    public ExampleWindow(ModContext context) : base("Example Mod") => _context = context;

    protected override void OnOpen()
    {
        SetTabs("About", "Options");
        AddButton("Say hello").Clicked += _ => _context.Log("Hello!");
        AddCloseButton();
        Tabs.Tabs[0].Open();
    }

    protected override void OnTabOpened(UITab tab)
    {
        Page.Clear();
        Page.AddHeader(tab.Text);
        if (tab.Index == 0)
            Page.AddText("Drawn by StoneForge in the game's look.");
        else
            Page.AddCheckbox("Sparks", true).Changed += on => _context.Log($"Sparks: {on}");
    }
}

Put it on a screen and open it, from a main menu button for instance:

var window = context.UI.MainMenu.Add(new ExampleWindow(context));
MainMenu.AddButton(context, "Example Mod", window.Open);

Each Open builds it anew: OnOpen runs every time.

Any frame

A plain UIWindow takes any sprite as its frame - the game's or your own - or none (a plain panel). What goes in it is added to Content: the frame's inside, less its borders.

public class JournalWindow : UIWindow
{
    public JournalWindow() : base("Journal")
    {
        FrameSprite = (int)Sprite.s_journal_window;
        ContentInsets = new UIInsets(20, 30, 20, 20);
    }

    protected override void OnOpen()
    {
        var page = Content.Add(new UIScrollArea(0, 0, Content.Width, Content.Height - 34));
        page.AddText("Hello");
        var buttons = Content.Add(new UIButtonRow(0, Content.Height - 26, Content.Width));
        buttons.Add("Close", Close);
    }
}

A dialog in the game's confirm panel

public class ConfirmWindow : UIWindow
{
    public ConfirmWindow()
    {
        FrameSprite = (int)Sprite.s_skill_confirm_panel;
        ContentInsets = new UIInsets(26, 26, 26, 7);
        CloseButton.Visible = false;
    }

    protected override void OnOpen()
    {
        Content.Add(new UILabel("Are you sure?", 0, 20) { Width = Content.Width, Align = Draw.AlignCenter });
        // The two button places drawn in the panel's picture.
        var buttons = Content.Add(new UIButtonRow(0, 64, Content.Width) { Positions = new double[] { 27, 129 } });
        buttons.Add("Yes", Close);
        buttons.Add("No", Close);
    }
}

A frame 9-sliced bigger

FrameSprite = (int)Sprite.s_skill_confirm_panel;
Slice = new UIInsets(24, 26, 24, 40);   // left, top, right, bottom borders
FrameWidth = 360;
FrameHeight = 220;

Layout helpers

var tabs = Content.Add(new UITabStrip(0, 0, 100, Content.Height));
tabs.TabOpened += tab => ShowPage(tab.Index);
tabs.SetTabs("General", "Advanced");
tabs.Tabs[0].Open();