Table of Contents

Method Begin

Namespace
Terminal.Gui.App
Assembly
Terminal.Gui.dll

Begin(Toplevel)

Building block API: Creates a RunnableSessionToken and prepares the provided IRunnable for execution. Not usually called directly by applications. Use Run(IRunnable, Func<Exception, bool>?) instead.

[Obsolete("The legacy static Application object is going away.")]
public static SessionToken Begin(Toplevel toplevel)

Parameters

toplevel Toplevel

Returns

SessionToken

The RunnableSessionToken that needs to be passed to the End(RunnableSessionToken) method upon completion.

Remarks

This method prepares the provided IRunnable for running. It adds this to the RunnableSessionStack, lays out the SubViews, focuses the first element, and draws the runnable on the screen. This is usually followed by starting the main loop, and then the End(RunnableSessionToken) method upon termination which will undo these changes.

Raises the IsRunningChanging, IsRunningChanged, IsModalChanging, and IsModalChanged events.