csharp/gui-cs.Terminal.Gui @ cc749bca1b9f2cace0abd55f3241c60ccb8389a8

Brak opisu

Tig cc749bca1b Merge branch 'v2_develop' of tig:gui-cs/Terminal.Gui into v2_develop		6 miesięcy temu
.devcontainer	651ee21ba5 Fixes #2323. The devcontainer.json settings isn't work with the current develop branch.	2 lat temu
.github	b8b440468d Upgrade gittools/actions from 2 to 3.	9 miesięcy temu
Benchmarks	bc8bf380b2 Reduce legacy Windows driver ANSI escape sequence intermediate string allocations (#3936)	6 miesięcy temu
CommunityToolkitExample	7ba6d638bc Fixes #3918 and #3913 - `Accepting` behavior (#3921)	6 miesięcy temu
Example	7ba6d638bc Fixes #3918 and #3913 - `Accepting` behavior (#3921)	6 miesięcy temu
FSharpExample	43994047ab fix the build issue of F# example	10 miesięcy temu
NativeAot	7ba6d638bc Fixes #3918 and #3913 - `Accepting` behavior (#3921)	6 miesięcy temu
ReactiveExample	78d0a8fc3b Accepted->Accepting	11 miesięcy temu
Scripts	e7a784b27c Moved scripts	6 miesięcy temu
SelfContained	7ba6d638bc Fixes #3918 and #3913 - `Accepting` behavior (#3921)	6 miesięcy temu
Terminal.Gui	98f70b2632 Adds `ViewportSettings.Transparent` (#3886)	6 miesięcy temu
UICatalog	98f70b2632 Adds `ViewportSettings.Transparent` (#3886)	6 miesięcy temu
UnitTests	98f70b2632 Adds `ViewportSettings.Transparent` (#3886)	6 miesięcy temu
docfx	c88c772462 Fixes #3692++ - Rearchitects drivers (#3837)	6 miesięcy temu
local_packages	98f70b2632 Adds `ViewportSettings.Transparent` (#3886)	6 miesięcy temu
.dockerignore	8ab759b30f Fixes #415 v2. Colors: OpenSUSE - The native method "COLOR_PAIRS" does not exist	2 lat temu
.editorconfig	c94c0567dd Fixes #3240: editorconfig and project documentation sync with reformatting (#3241)	1 rok temu
.filenesting.json	76d48f1fe8 Add solution default file nesting rules	1 rok temu
.gitattributes	98f70b2632 Adds `ViewportSettings.Transparent` (#3886)	6 miesięcy temu
.gitignore	79cd4e92b7 Adds Logging level control to UICatalog (#3938)	6 miesięcy temu
.vsconfig	1a68656d66 Add .vsconfig	1 rok temu
CODE_OF_CONDUCT.md	6144c9da66 added contribution guidelines, project layout docs, etc...	5 lat temu
CONTRIBUTING.md	d28e352c0a Addressed feedback #2	1 rok temu
GitVersion.yml	e6c8a58291 Merge branch 'v2_develop' into v2_develop	6 miesięcy temu
LICENSE	38af4cfcb8 Add	7 lat temu
NoSamples.slnf	b667c3de98 Remove analyzer projects from solution and project references	1 rok temu
README.md	dc004c4923 (Minor fix) Fix the link text, refer to the F# example too (#3901)	7 miesięcy temu
Release.slnf	b667c3de98 Remove analyzer projects from solution and project references	1 rok temu
Showcase.md	dd32717f78 Fix typo	9 miesięcy temu
Terminal.sln	e24bd67658 Rune extensions micro-optimizations (#3910)	6 miesięcy temu
Terminal.sln.DotSettings	98f70b2632 Adds `ViewportSettings.Transparent` (#3886)	6 miesięcy temu
Terminal.sln.ToDo.DotSettings	3f29a96b33 Split out the todo list items and unify their definitions	1 rok temu
example_config.json	dd88c392dd Added example user config.json	11 miesięcy temu
global.json	dcb3b359ad Fixes #2926 - Refactor KeyEvent and KeyEventEventArgs to simplify (#2927)	1 rok temu
nuget.config	9c6a3058d4 Fixes #3784. SelfContained and NativeAot projects should use the local package in the release mode. (#3785)	11 miesięcy temu
pull_request_template.md	b84862d0bd Fixes #3172. `Application.ResetState` wasn't resetting all it should (#3173)	1 rok temu
testenvironments.json	8ea6b105fc Fixes #2923. Ensures only clear Instances if they really was disposed. (#2924)	1 rok temu

The current, stable, release of Terminal.Gui v1 is .
The current prealpha release of Terminal.Gui v2 can be found on Nuget.
Developers starting new TUI projects are encouraged to target v2. The API is significantly changed, and significantly improved. There will be breaking changes in the API before Beta, but the core API is stable.
v1 is in maintenance mode and we will only accept PRs for issues impacting existing functionality.

Terminal.Gui: A toolkit for building rich console apps for Windows, the Mac, and Linux/Unix.

Quick Start

Paste these commands into your favorite terminal on Windows, Mac, or Linux. This will install the Terminal.Gui.Templates, create a new "Hello World" TUI app, and run it.

(Press CTRL-Q to exit the app)

dotnet new --install Terminal.Gui.templates
dotnet new tui -n myproj
cd myproj
dotnet run

There is also a visual designer (uses Terminal.Gui itself).

Documentation

The above documentation matches the most recent Nuget release from the v2_develop branch. Get the v1 documentation here.

See the Terminal.Gui/README for an overview of how the library is structured.

Showcase & Examples

Terminal.Gui can be used with any .Net language to create feature rich and robust applications.
Showcase is a place where you can find all kind of projects from simple examples to advanced real world apps that fully utilize capabilities of the toolkit.
The team is looking forward to seeing new amazing projects made by the community to be added there!

Sample Usage in C

The following example shows a basic Terminal.Gui application in C#:
Example (source)

When run the application looks as follows:

Sample usage in F#

F# examples are located here

Installing

Use NuGet to install the Terminal.Gui NuGet package: https://www.nuget.org/packages/Terminal.Gui

Installation in .NET Core Projects

To install Terminal.Gui into a .NET Core project, use the dotnet CLI tool with this command.

dotnet add package Terminal.Gui

Or, you can use the Terminal.Gui.Templates.

Contributing

See CONTRIBUTING.md.

Debates on architecture and design can be found in Issues tagged with design.

History

See gui-cs for how this project came to be.

README.md