Get-PSReadline Key Handler

Gets the key bindings for the PSReadline module.

Syntax

Get-PSReadlineKeyHandler
   [-Bound]
   [-Unbound]
   [<CommonParameters>]

Description

The Get-PSReadlineKeyHandler cmdlet gets key bindings. If you specify the Bound and Unbound parameters, this cmdlet returns all bound keys and unbound functions. If you specify Bound , but not Unbound , the cmdlet returns only bound keys. If you specify Unbound , but not Bound , the cmdlet returns only unbound keys.

Examples

Example 1: Get all key mappings

PS C:\> Get-PSReadlineKeyHandler

Key                   Function                Description

---                   --------                -----------

Enter                 AcceptLine              Accept the input or move to the next line if input is missing a closing token.

Shift+Enter           AddLine                 Move the cursor to the next line without attempting to execute the input

Escape                RevertLine              Equivalent to undo all edits (clears the line except lines imported from history)

LeftArrow             BackwardChar            Move the cursor back one character

RightArrow            ForwardChar             Move the cursor forward one character

Ctrl+LeftArrow        BackwardWord            Move the cursor to the beginning of the current or previous word

Ctrl+RightArrow       NextWord                Move the cursor forward to the start of the next word

Shift+LeftArrow       SelectBackwardChar      Adjust the current selection to include the previous character

Shift+RightArrow      SelectForwardChar       Adjust the current selection to include the next character

Ctrl+Shift+LeftArrow  SelectBackwardWord      Adjust the current selection to include the previous word

Ctrl+Shift+RightArrow SelectNextWord          Adjust the current selection to include the next word

UpArrow               PreviousHistory         Replace the input with the previous item in the history

DownArrow             NextHistory             Replace the input with the next item in the history

Home                  BeginningOfLine         Move the cursor to the beginning of the line

End                   EndOfLine               Move the cursor to the end of the line

Shift+Home            SelectBackwardsLine     Adjust the current selection to include from the cursor to the end of the line

Shift+End             SelectLine              Adjust the current selection to include from the cursor to the start of the line

Delete                DeleteChar              Delete the character under the cursor

Backspace             BackwardDeleteChar      Delete the charcter before the cursor

Ctrl+Spacebar         MenuComplete            Complete the input if there is a single completion, otherwise complete the input by selecting from a menu o...

Tab                   TabCompleteNext         Complete the input using the next completion

Shift+Tab             TabCompletePrevious     Complete the input using the previous completion

Ctrl+a                SelectAll               Select the entire line. Moves the cursor to the end of the line

Ctrl+c                CopyOrCancelLine        Either copy selected text to the clipboard, or if no text is selected, cancel editing the line with Cancel...

Ctrl+C                Copy                    Copy selected region to the system clipboard.  If no region is selected, copy the whole line

Ctrl+l                ClearScreen             Clear the screen and redraw the current line at the top of the screen

Ctrl+r                ReverseSearchHistory    Search history backwards interactively

…

This command returns all key mappings, bound and unbound.

Example 2: Get bound keys

PS C:\> Get-PSReadlineKeyHandler -Bound

Key                   Function                Description

---                   --------                -----------

Enter                 AcceptLine              Accept the input or move to the next line if input is missing a closing token.

Shift+Enter           AddLine                 Move the cursor to the next line without attempting to execute the input

Escape                RevertLine              Equivalent to undo all edits (clears the line except lines imported from history)

LeftArrow             BackwardChar            Move the cursor back one character

RightArrow            ForwardChar             Move the cursor forward one character

Ctrl+LeftArrow        BackwardWord            Move the cursor to the beginning of the current or previous word

Ctrl+RightArrow       NextWord                Move the cursor forward to the start of the next word

Shift+LeftArrow       SelectBackwardChar      Adjust the current selection to include the previous character

Shift+RightArrow      SelectForwardChar       Adjust the current selection to include the next character

Ctrl+Shift+LeftArrow  SelectBackwardWord      Adjust the current selection to include the previous word

Ctrl+Shift+RightArrow SelectNextWord          Adjust the current selection to include the next word

UpArrow               PreviousHistory         Replace the input with the previous item in the history

DownArrow             NextHistory             Replace the input with the next item in the history

Home                  BeginningOfLine         Move the cursor to the beginning of the line

End                   EndOfLine               Move the cursor to the end of the line

Shift+Home            SelectBackwardsLine     Adjust the current selection to include from the cursor to the end of the line

Shift+End             SelectLine              Adjust the current selection to include from the cursor to the start of the line

Delete                DeleteChar              Delete the character under the cursor

Backspace             BackwardDeleteChar      Delete the charcter before the cursor

Ctrl+Spacebar         MenuComplete            Complete the input if there is a single completion, otherwise complete the input by selecting from a menu o...

Tab                   TabCompleteNext         Complete the input using the next completion

…

This command returns only bound keys and key combinations.

Optional Parameters

-Bound

Indicates that this cmdlet returns functions that are bound.

Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Unbound

Indicates that this cmdlet returns functions that are unbound.

Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Inputs

None

You cannot pipe objects to this cmdlet.

Outputs

PSConsoleUtilities.KeyHandler

This cmdlet returns one entry for each key binding, or chord, for bound functions and one entry for each unbound function.