mirror of
https://github.com/gui-cs/Terminal.Gui.git
synced 2025-12-27 00:07:58 +01:00
e7a4df492d
* Initial plan
* Rename Command.Select to Command.Activate and Selecting to Activating
Co-authored-by: tig <585482+tig@users.noreply.github.com>
* Add Activating event propagation to SuperView
Co-authored-by: tig <585482+tig@users.noreply.github.com>
* Update all comments and docs referencing Select to Activate
Co-authored-by: tig <585482+tig@users.noreply.github.com>
* Fix event log messages in examples to use Activating/Activate
Co-authored-by: tig <585482+tig@users.noreply.github.com>
* Revert automatic Activating event propagation that broke tests
Co-authored-by: tig <585482+tig@users.noreply.github.com>
* Update docfx documentation to use Activate/Activating terminology
Co-authored-by: tig <585482+tig@users.noreply.github.com>
* renames
* Revert "Add Activating event propagation to SuperView"
This reverts commit 6d82bee9ad.
* added command diagrams
* mermaid
* updated level 3
* again
* Select->Activate in MouseTests.cs
* Update Terminal.Gui/Views/Selectors/FlagSelector.cs
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Refactor: Rename Selecting to Activating in View APIs
Renamed the `Selecting` event and `OnSelecting` method to
`Activating` and `OnActivating` to better reflect their purpose.
Updated all related comments, test method names, variables,
and assertions in `View` and `ViewCommandTests` to align with
the new terminology.
Improved code clarity by using `_` for unused parameters in
lambda expressions. Renamed properties like `HandleSelecting`
to `HandleActivating` and adjusted naming conventions for
consistency (e.g., `OnactivatingCount` to `OnActivatingCount`).
These changes enhance readability, maintainability, and
terminology consistency across the codebase.
* Update Terminal.Gui/Views/Selectors/OptionSelector.cs
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Typos
---------
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: tig <585482+tig@users.noreply.github.com>
Co-authored-by: Tig <tig@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
50 lines
3.1 KiB
Markdown
50 lines
3.1 KiB
Markdown
# Terminal.Gui Documentation
|
|
|
|
> [!IMPORTANT]
|
|
> Terminal.Gui v2 "Alpha" has been released.
|
|
|
|
Welcome to the Terminal.Gui documentation! This comprehensive guide covers everything you need to know about building modern terminal user interfaces with Terminal.Gui.
|
|
|
|
> [!NOTE]
|
|
> This is the v2 API documentation. For v1 go here: https://gui-cs.github.io/Terminal.GuiV1Docs/
|
|
|
|
## Getting Started
|
|
|
|
- [Getting Started](~/docs/getting-started.md) - Quick start guide to create your first Terminal.Gui application
|
|
- [Migrating from v1 to v2](~/docs/migratingfromv1.md) - Complete guide for upgrading existing applications
|
|
- [What's New in v2](~/docs/newinv2.md) - Overview of new features and improvements
|
|
- [Showcase](~/docs/showcase.md) - Showcase of TUI apps built with Terminal.Gui
|
|
|
|
## Deep Dives
|
|
|
|
- [ANSI Response Parser](~/docs/ansiparser.md) - Terminal sequence parsing and state management
|
|
- [Application](~/docs/application.md) - Application lifecycle, initialization, and main loop
|
|
- [Arrangement](~/docs/arrangement.md) - View arrangement and positioning strategies
|
|
- [Cancellable Work Pattern](~/docs/cancellable-work-pattern.md) - Core design pattern for extensible workflows
|
|
- [Character Map Scenario](~/docs/CharacterMap.md) - Complex drawing, scrolling, and Unicode rendering example
|
|
- [Command System](~/docs/command.md) - Command execution, key bindings, and the Activating/Accepting concepts
|
|
- [Configuration Management](~/docs/config.md) - Persistent settings, themes, and configuration scopes
|
|
- [Cross-Platform Driver Model](~/docs/drivers.md) - Platform abstraction and console driver architecture
|
|
- [Cursor System](~/docs/cursor.md) - Modern cursor management and positioning (proposed design)
|
|
- [Dim.Auto](~/docs/dimauto.md) - Automatic view sizing based on content
|
|
- [Drawing](~/docs/drawing.md) - Drawing primitives, rendering, and graphics operations
|
|
- [Events](~/docs/events.md) - Event patterns and handling throughout the framework
|
|
- [Keyboard Input](~/docs/keyboard.md) - Key handling, bindings, commands, and shortcuts
|
|
- [Layout System](~/docs/layout.md) - View positioning, sizing, and arrangement
|
|
- [Lexicon & Taxonomy](~/docs/lexicon.md) - Terminology and concepts used throughout Terminal.Gui
|
|
- [Logging & Metrics](~/docs/logging.md) - Comprehensive logging and performance monitoring
|
|
- [Multitasking](~/docs/multitasking.md) - Application lifecycle and event dispatching
|
|
- [Mouse Input](~/docs/mouse.md) - Mouse event handling and interaction patterns
|
|
- [Navigation](~/docs/navigation.md) - Focus management, keyboard navigation, and accessibility
|
|
- [Popovers](~/docs/Popovers.md) - Drawing outside viewport boundaries for menus and popups
|
|
- [Scheme](~/docs/scheme.md) - Color schemes, styling, and visual theming
|
|
- [Scrolling](~/docs/scrolling.md) - Built-in scrolling, virtual content areas, and scroll bars
|
|
- [TableView](~/docs/tableview.md) - Table view component, data binding, and column management
|
|
- [TreeView](~/docs/treeview.md) - Tree view component, hierarchical data, and node management
|
|
- [View](~/docs/View.md) - Base view class, view hierarchy, and core view functionality
|
|
|
|
## API Reference
|
|
|
|
For detailed API documentation, see the [API Reference](~/api/Terminal.Gui.App.yml).
|
|
|