Aptivi - Stable Manuals
ProjectsWebsiteBlog
Terminaux 5.x - Manual
Terminaux 5.x - Manual
  • Welcome!
  • Breaking changes
    • API v1.0
    • API v2.0
    • API v3.0
    • API v4.0
    • API v5.0
  • Usage
    • Preface
    • Console Tools
      • Console Checker
        • Console Size Requirements
      • Image Rendering
        • Icons
      • Console Writers
        • Informational Boxes
      • Console Wrapper
      • Console Colors
      • Color Templates
      • Console Screen
      • Console Resize Listener
      • Presentation System
      • VT Sequences
      • Console Extensions
      • Interactive TUI
      • Geometric Shapes
      • Nerd Fonts
      • Terminal Info
      • Wide Characters
    • Input Reader
      • Custom Bindings
      • Reader State
      • Reader Settings
      • Syntax Highlighting
      • Pointer Events
      • Other Input
        • Keybindings
        • Choice-based inputs
        • Editors and Viewers
        • Figlet Font Selector
        • Color Wheel
    • Color Sequences
      • Color Model Conversions
      • Color Model Parsing
      • Interop with System.Drawing.Color
  • Report an issue
  • Source code
  • API Reference
Powered by GitBook
On this page
Edit on GitHub
  1. Usage
  2. Input Reader

Reader Settings

In case you want to set things up

The reader currently has a global settings instance session-wide. However, it can get overridden if you make a new instance of TermReaderSettings with some available properties mentioned below set. They get read each time you call this function or you activate a keybinding that uses one of these settings.

Here are the available settings that you can set:

  • PasswordMaskChar

    • Sets the password masking character.

  • HistoryEnabled

    • Whether the history is enabled or not.

  • HistoryName

    • Select what history to use

  • LeftMargin

    • Sets the left margin of the input.

  • RightMargin

    • Sets the right margin of the input.

  • InputForegroundColor

    • The foreground color for the input text, as well as the input prompt.

  • InputBackgroundColor

    • The background color for the input text, as well as the input prompt.

  • Suggestions

    • Sets a function that you could use to return an array of strings containing auto completion data.

  • SuggestionsDelimiters

    • Delimiters to split the current input within a function that returns a list of suggestions.

  • TreatCtrlCAsInput

    • Whether to treat Ctrl + C as input or not. If enabled, TermRead will process this keybinding as aborting the current input.

  • PlaceholderText

    • This is the text that the terminal reader shows when there is no input text. This is used to give users hints on what they should write to the prompt.

  • PrintDefaultValue

    • Whether to print the default value or not.

  • DefaultValueFormat

    • The default value format to print if PrintDefaultValue is enabled and there is a prompt.

You can copy the above settings in one line using the overload of the TermReaderSettings constructor that allows you to specify another TermReaderSettings instance to copy the settings from that instance to the new one. This is useful if you want to use the global settings without affecting future reads. This is a simple example of how to copy the global settings and to set the password mask without affecting the global password mask:

// Doesn't affect future reads
var settings = new TermReaderSettings(TermReader.GlobalReaderSettings)
{
    PasswordMaskChar = '#'
};

// Affects future reads
TermReader.GlobalReaderSettings.PasswordMaskChar = '#';