Udostępnij za pośrednictwem


about_PSReadLine_Functions

Short Description

Funkcja PSReadLine zapewnia ulepszone środowisko edytowania wiersza polecenia w konsoli programu PowerShell.

Długi opis

Program PowerShell 7.3 jest dostarczany z programem PSReadLine 2.2.6. Bieżąca wersja to PSReadLine 2.3.4. Bieżąca wersja programu PSReadLine może być zainstalowana i używana w programie Windows PowerShell 5.1 lub nowszym. W przypadku niektórych funkcji należy uruchomić program PowerShell w wersji 7.2 lub nowszej.

Ten artykuł zawiera dokumenty dotyczące funkcji udostępnianych przez program PSReadLine 2.3.4. Te funkcje można powiązać z naciśnięciami w celu łatwego dostępu i wywołania.

Używanie klasy Microsoft.PowerShell.PSConsoleReadLine

Następujące funkcje są dostępne w klasie Microsoft.PowerShell.PSConsoleReadLine.

Podstawowe funkcje edycji

Przerwij

Przerwij bieżącą akcję, na przykład: wyszukiwanie historii przyrostowej.

  • Tryb Emacs: Ctrl+g
  • Tryb wstawiania vi: Ctrl+g
  • Tryb polecenia Vi: <Ctrl+g>

AcceptAndGetNext

Spróbuj wykonać bieżące dane wejściowe. Jeśli można go wykonać (na przykład AcceptLine), przypomnij sobie następny element z historii przy następnym wywołaniu funkcji ReadLine.

  • Tryb Emacs: Ctrl+o

AcceptLine

Spróbuj wykonać bieżące dane wejściowe. Jeśli bieżące dane wejściowe są niekompletne (na przykład brakuje nawiasu zamykającego, nawiasu lub cudzysłowu), monit kontynuacji jest wyświetlany w następnym wierszu, a funkcja PSReadLine czeka na klucze, aby edytować bieżące dane wejściowe.

  • Tryb systemu Windows: Enter
  • Tryb Emacs: Enter
  • Tryb wstawiania vi: Enter

Dodaj linię

Monit kontynuacji jest wyświetlany w następnym wierszu, a funkcja PSReadLine czeka na edytowanie bieżących danych wejściowych przez klucze. Jest to przydatne do wprowadzania danych wejściowych w wielu wierszach jako pojedynczego polecenia nawet wtedy, gdy pojedynczy wiersz jest kompletnym wejściem.

  • Tryb systemu Windows: Shift+Enter
  • Tryb Emacs: Shift+Enter
  • Tryb wstawiania vi: Shift+Enter
  • Tryb polecenia Vi: <Shift+Enter>

WsteczDeleteChar

Usuń znak przed kursorem.

  • Tryb systemu Windows: Backspace, Ctrl+h
  • Tryb Emacs: Backspace, , Ctrl+BackspaceCtrl+h
  • Tryb wstawiania vi: Backspace
  • Tryb polecenia Vi: <X>, <d,h>

WsteczDeleteInput

Podobnie jak WsteczKillInput — usuwa tekst od punktu do początku danych wejściowych, ale nie umieszcza usuniętego tekstu w pierścieniu kill-ring.

  • Tryb systemu Windows: Ctrl+Home
  • Tryb wstawiania vi: Ctrl+u, Ctrl+Home
  • Tryb polecenia Vi: <Ctrl+u>, <Ctrl+Home>

WsteczDeleteLine

Podobnie jak WsteczKillLine — usuwa tekst od punktu do początku wiersza, ale nie umieszcza usuniętego tekstu w pierścieniu kill-ring.

  • Tryb polecenia Vi: <d,0>

WsteczDeleteWord

Usuwa poprzednie słowo.

  • Tryb polecenia Vi: <Ctrl+w>, <d,b>

WsteczKillInput

Wyczyść tekst od początku danych wejściowych do kursora. Wyczyszczonego tekstu znajduje się w pierścieniu kill-ring.

  • Tryb Emacs: Ctrl+u, Ctrl+x,Backspace

WsteczKillLine

Wyczyść tekst od początku bieżącego wiersza logicznego do kursora. Wyczyszczonego tekstu znajduje się w pierścieniu kill-ring.

  • Funkcja jest niezwiązana.

WsteczKillWord

Wyczyść dane wejściowe od początku bieżącego słowa do kursora. Jeśli kursor znajduje się między wyrazami, dane wejściowe są czyszczone od początku poprzedniego wyrazu do kursora. Wyczyszczonego tekstu znajduje się w pierścieniu kill-ring.

  • Tryb systemu Windows: Ctrl+Backspace, Ctrl+w
  • Tryb Emacs: Alt+Backspace, Escape,Backspace
  • Tryb wstawiania vi: Ctrl+Backspace
  • Tryb polecenia Vi: <Ctrl+Backspace>

WsteczReplaceChar

Zamienia znak przed kursorem.

  • Tryb polecenia Vi: <c,h>

Anuluj wiersz

Anuluj bieżące dane wejściowe, pozostawiając dane wejściowe na ekranie, ale wraca do hosta, aby ponownie ocenić monit.

  • Tryb wstawiania vi: Ctrl+c
  • Tryb polecenia Vi: <Ctrl+c>

Wielkie literyWord

Dodano element PSReadLine 2.3.0

Przekonwertuj pierwszy znak na następny wyraz na wielkie litery i pozostałe znaki na małe litery.

  • Tryb Emacs: Alt+c, Escape,c

Kopiuj

Skopiuj wybrany region do schowka systemowego. Jeśli nie wybrano żadnego regionu, skopiuj cały wiersz.

  • Tryb systemu Windows: Ctrl+C

CopyOrCancelLine

Jeśli tekst jest zaznaczony, skopiuj do schowka, w przeciwnym razie anuluj wiersz.

  • Tryb systemu Windows: Ctrl+c
  • Tryb Emacs: Ctrl+c

Wytnij

Usuń zaznaczony region, umieszczając usunięty tekst w schowku systemowym.

  • Tryb systemu Windows: Ctrl+x

DeleteChar

Usuń znak pod kursorem.

  • Tryb systemu Windows: Delete
  • Tryb Emacs: Delete
  • Tryb wstawiania vi: Delete
  • Tryb polecenia Vi: <Delete>, <x>, , <d,l><d,Spacebar>

DeleteCharOrExit

Usuń znak pod kursorem lub jeśli wiersz jest pusty, zakończ proces.

  • Tryb Emacs: Ctrl+d

DeleteEndOfBuffer

Usuwa na końcu buforu wielowierszowego.

  • Tryb polecenia Vi: <d,G>

DeleteEndOfWord

Usuń na końcu wyrazu.

  • Tryb polecenia Vi: <d,e>

DeleteLine

Usuwa bieżącą linię logiczną buforu wielowierszowego, włączając cofanie.

  • Tryb polecenia Vi: <d,d>, <d,_>

DeleteLineToFirstChar

Usuwa z pierwszego niepustego znaku bieżącego wiersza logicznego w buforze wielowierszowym.

  • Tryb polecenia Vi: <d,^>

DeleteNextLines

Usuwa bieżące i następne n wierszy logicznych w buforze wielowierszowym.

  • Tryb polecenia Vi: <d,j>

DeletePreviousLines

Usuwa poprzednie żądane wiersze logiczne i bieżącą linię logiczną w buforze wielowierszowym.

  • Tryb polecenia Vi: <d,k>

DeleteRelativeLines

Usuwa z początku buforu do bieżącego wiersza logicznego w buforze wielowierszowym.

Jak większość poleceń Vi, <d,g,g> polecenie można poprzedzać argumentem liczbowym określającym bezwzględny numer wiersza, który wraz z bieżącym numerem wiersza składa się z zakresu wierszy do usunięcia. Jeśli nie zostanie określony, argument liczbowy domyślnie ma wartość 1, która odwołuje się do pierwszego wiersza logicznego w buforze wielowierszowym.

Rzeczywista liczba wierszy do usunięcia z wielowierszowego jest obliczana jako różnica między bieżącym numerem wiersza logicznego a określonym argumentem liczbowym, co może być ujemne. Stąd względna część nazwy metody.

  • Tryb polecenia Vi: <d,g,g>

DeleteToEnd

Usuń na końcu wiersza.

  • Tryb polecenia Vi: <D>, <d,$>

DeleteWord

Usuń następny wyraz.

  • Tryb polecenia Vi: <d,w>

DowncaseWord

Dodano element PSReadLine 2.3.0

Przekonwertuj następny wyraz na małe litery.

  • Tryb Emacs: Alt+l, Escape,l

ForwardDeleteInput

Podobnie jak KillLine — usuwa tekst od punktu do końca danych wejściowych, ale nie umieszcza usuniętego tekstu w pierścieniu kill-ring.

  • Tryb systemu Windows: Ctrl+End
  • Tryb wstawiania vi: Ctrl+End
  • Tryb polecenia Vi: <Ctrl+End>

ForwardDeleteLine

Usuwa tekst od punktu do końca bieżącego wiersza logicznego, ale nie umieszcza usuniętego tekstu w pierścieniu kill-ring.

  • Funkcja jest niezwiązana

InsertLineAbove

Nowy pusty wiersz jest tworzony powyżej bieżącego wiersza niezależnie od tego, gdzie kursor znajduje się w bieżącym wierszu. Kursor przechodzi na początek nowego wiersza.

  • Tryb systemu Windows: Ctrl+Enter

InsertLineBelow

Nowy pusty wiersz jest tworzony poniżej bieżącego wiersza niezależnie od tego, gdzie kursor znajduje się w bieżącym wierszu. Kursor przechodzi na początek nowego wiersza.

  • Tryb systemu Windows: Shift+Ctrl+Enter

Odwrócone litery

Odwróć przypadek bieżącego znaku i przejdź do następnego.

  • Tryb polecenia Vi: <~>

KillLine

Wyczyść dane wejściowe z kursora na końcu danych wejściowych. Wyczyszczonego tekstu znajduje się w pierścieniu kill-ring.

  • Tryb Emacs: Ctrl+k

KillRegion

Zabij tekst między kursorem a znacznikem.

  • Funkcja jest niezwiązana.

KillWord

Wyczyść dane wejściowe z kursora na końcu bieżącego wyrazu. Jeśli kursor znajduje się między wyrazami, dane wejściowe są czyszczone z kursora na końcu następnego wyrazu. Wyczyszczonego tekstu znajduje się w pierścieniu kill-ring.

  • Tryb systemu Windows: Alt+d, Ctrl+Delete
  • Tryb Emacs: Alt+d, Escape,d
  • Tryb wstawiania vi: Ctrl+Delete
  • Tryb polecenia Vi: <Ctrl+Delete>

Wklej

Wklej tekst ze schowka systemowego.

  • Tryb systemu Windows: Ctrl+v, Shift+Insert
  • Tryb wstawiania vi: Ctrl+v
  • Tryb polecenia Vi: <Ctrl+v>

Ważne

W przypadku korzystania z funkcji Paste cała zawartość buforu schowka jest wklejona do buforu wejściowego elementu PSReadLine. Bufor wejściowy jest następnie przekazywany do analizatora programu PowerShell. Dane wejściowe wklejone przy użyciu metody wklejania prawym przyciskiem myszy aplikacji konsolowej są kopiowane do buforu wejściowego o jeden znak jednocześnie. Bufor wejściowy jest przekazywany do analizatora po skopiowaniu nowego znaku wiersza. W związku z tym dane wejściowe są analizowane po jednym wierszu naraz. Różnica między metodami wklejania powoduje różne zachowanie wykonywania.

Wklej po

Wklej schowek po kursorze, przenosząc kursor na koniec wklejonego tekstu.

  • Tryb polecenia Vi: <p>

PasteBefore

Wklej schowek przed kursorem, przenosząc kursor na koniec wklejonego tekstu.

  • Tryb polecenia Vi: <P>

PrependAndAccept

Poprzedzał ciąg "#" i akceptował wiersz.

  • Tryb polecenia Vi: <#>

Ponów

Cofanie cofania.

  • Tryb systemu Windows: Ctrl+y
  • Tryb wstawiania vi: Ctrl+y
  • Tryb polecenia Vi: <Ctrl+y>

RepeatLastCommand

Powtórz ostatnią modyfikację tekstu.

  • Tryb polecenia Vi: <.>

ReplaceChar

Zastąp bieżący znak następnym zestawem wpisanych znaków.

  • Tryb polecenia Vi: <c,l>, <c,Spacebar>

ReplaceCharInPlace

Zastąp bieżący znak tylko jednym znakiem.

  • Tryb polecenia Vi: <r>

RevertLine

Przywraca wszystkie dane wejściowe do bieżących danych wejściowych.

  • Tryb systemu Windows: Escape
  • Tryb Emacs: Alt+r, Escape,r

ShellBackwardKillWord

Wyczyść dane wejściowe od początku bieżącego słowa do kursora. Jeśli kursor znajduje się między wyrazami, dane wejściowe są czyszczone od początku poprzedniego wyrazu do kursora. Wyczyszczonego tekstu znajduje się w pierścieniu kill-ring.

Funkcja jest niezwiązana.

ShellKillWord

Wyczyść dane wejściowe z kursora na końcu bieżącego wyrazu. Jeśli kursor znajduje się między wyrazami, dane wejściowe są czyszczone z kursora na końcu następnego wyrazu. Wyczyszczonego tekstu znajduje się w pierścieniu kill-ring.

Funkcja jest niezwiązana.

SwapCharacters

Zamień bieżący znak i ten przed nim.

  • Tryb Emacs: Ctrl+t
  • Tryb wstawiania vi: Ctrl+t
  • Tryb polecenia Vi: <Ctrl+t>

Cofnij

Cofnij poprzednią edycję.

  • Tryb systemu Windows: Ctrl+z
  • Tryb Emacs: Ctrl+_, Ctrl+x,Ctrl+u
  • Tryb wstawiania vi: Ctrl+z
  • Tryb polecenia Vi: <Ctrl+z>, <u>

Cofnijwszywszy

Cofnij wszystkie poprzednie edycje dla wiersza.

  • Tryb polecenia Vi: <U>

UnixWordRubout

Wyczyść dane wejściowe od początku bieżącego słowa do kursora. Jeśli kursor znajduje się między wyrazami, dane wejściowe są czyszczone od początku poprzedniego wyrazu do kursora. Wyczyszczonego tekstu znajduje się w pierścieniu kill-ring.

  • Tryb Emacs: Ctrl+w

UpcaseWord

Dodano element PSReadLine 2.3.0

Przekonwertuj następny wyraz na wielkie litery.

  • Tryb Emacs: Alt+u, Escape,u

ValidateAndAcceptLine

Spróbuj wykonać bieżące dane wejściowe. Jeśli bieżące dane wejściowe są niekompletne (na przykład brakuje nawiasu zamykającego, nawiasu lub cudzysłowu), monit kontynuacji jest wyświetlany w następnym wierszu, a funkcja PSReadLine czeka na klucze, aby edytować bieżące dane wejściowe.

  • Tryb Emacs: Ctrl+m

ViAcceptLine

Zaakceptuj wiersz i przełącz tryb wstawiania.

  • Tryb polecenia Vi: <Enter>

ViAcceptLineOrExit

Podobnie jak DeleteCharOrExit w trybie Emacs, ale akceptuje wiersz zamiast usuwać znak.

  • Tryb wstawiania vi: Ctrl+d
  • Tryb polecenia Vi: <Ctrl+d>

ViAppendLine

Nowy wiersz jest wstawiany poniżej bieżącego wiersza.

  • Tryb polecenia Vi: <o>

ViBackwardDeleteGlob

Usuwa poprzednie słowo, używając tylko białych znaków jako ogranicznika wyrazów.

  • Tryb polecenia Vi: <d,B>

ViBackwardGlob

Przenosi kursor z powrotem na początek poprzedniego wyrazu, używając tylko białych znaków jako ograniczników.

  • Tryb polecenia Vi: <B>

ViBackwardReplaceGlob

Usuń z powrotem do początku poprzedniego wyrazu, zgodnie z podziałem na białe znaki, a następnie wprowadź tryb wstawiania.

  • Tryb polecenia Vi: <c,B>

ViBackwardReplaceLine

Zamienia lewy wiersz kursora i cały sposób na początek.

  • Tryb polecenia Vi: <c,0>

ViBackwardReplaceLineToFirstChar

Zamienia lewy wiersz kursora i wszystkie, ale jeden znak na początek wiersza.

  • Tryb polecenia Vi: <c,^>

ViBackwardReplaceWord

Zastąp poprzednie słowo.

  • Tryb polecenia Vi: <c,B>

ViDeleteBrace

Znajdź pasujący nawias klamrowy, nawias kwadratowy lub nawias kwadratowy i usuń całą zawartość, w tym nawias klamrowy.

  • Tryb polecenia Vi: <d,%>

ViDeleteEndOfGlob

Usuń na końcu wyrazu.

  • Tryb polecenia Vi: <d,E>

ViDeleteGlob

Usuń następny glob (rozdzielany odstępami wyrazów).

  • Tryb polecenia Vi: <d,W>

ViDeleteToBeforeChar

Usuwa do momentu, aż dany znak.

  • Tryb polecenia Vi: <d,t>

ViDeleteToBeforeCharBackward

Usuwa do momentu, aż dany znak.

  • Tryb polecenia Vi: <d,T>

ViDeleteToChar

Usuwa do momentu, aż dany znak.

  • Tryb polecenia Vi: <d,f>

ViDeleteToCharBackward

Usuwa do tyłu do danego znaku.

  • Tryb polecenia Vi: <d,F>

ViInsertAtBegining

Przełącz się do trybu wstawiania i umieść kursor na początku wiersza.

  • Tryb polecenia Vi: <I>

ViInsertAtEnd

Przełącz się do trybu wstawiania i umieść kursor na końcu wiersza.

  • Tryb polecenia Vi: <A>

ViInsertLine

Nowy wiersz jest wstawiany powyżej bieżącego wiersza.

  • Tryb polecenia Vi: <O>

ViInsertWithAppend

Dołącz z bieżącego położenia wiersza.

  • Tryb polecenia Vi: <a>

ViInsertWithDelete

Usuń bieżący znak i przełącz się do trybu wstawiania.

  • Tryb polecenia Vi: <s>

ViJoinLines

Łączy bieżący wiersz i następny wiersz.

  • Tryb polecenia Vi: <J>

ViReplaceBrace

Zastąp wszystkie znaki między bieżącym znakiem nawiasu klamrowego i pasującym partnerem.

  • Tryb polecenia Vi: <c,%>

ViReplaceEndOfGlob

Usuń na końcu wyrazu jako rozdzielany białym znakiem i wprowadź tryb wstawiania.

  • Tryb polecenia Vi: <c,E>

ViReplaceEndOfWord

Usuń na końcu wyrazu jako rozdzielany białym znakiem i typowymi ogranicznikami, a następnie wprowadź tryb wstawiania.

  • Tryb polecenia Vi: <c,E>

ViReplaceGlob

Usuń na początku na początku następnego wyrazu, zgodnie z podziałem na białe znaki, i wprowadź tryb wstawiania.

  • Tryb polecenia Vi: <c,W>

ViReplaceLine

Wymazywanie całego wiersza polecenia.

  • Tryb polecenia Vi: <S>, <c,c>

ViReplaceToBeforeChar

Zamienia się do danego znaku.

  • Tryb polecenia Vi: <c,t>

ViReplaceToBeforeCharBackward

Zamienia się do danego znaku.

  • Tryb polecenia Vi: <c,T>

ViReplaceToChar

Usuwa do momentu, aż dany znak.

  • Tryb polecenia Vi: <c,f>

ViReplaceToCharBackward

Zamienia się do danego znaku.

  • Tryb polecenia Vi: <c,F>

ViReplaceToEnd

Zastąp znaki z położenia kursora na końcu wiersza.

  • Tryb polecenia Vi: <c,$>, <C>

ViReplaceUntilEsc

Zastąp bieżący znak do momentu wprowadzenia ucieczki lub zaakceptowania wiersza.

  • Tryb polecenia Vi: <r>

ViReplaceWord

Zastąp bieżący wyraz.

  • Tryb polecenia Vi: <c,W>

ViYankBeginningOfLine

Yank od początku buforu do kursora.

  • Tryb polecenia Vi: <y,0>

ViYankEndOfGlob

Yank z kursora na końcu word(s).

  • Tryb polecenia Vi: <y,E>

ViYankEndOfWord

Yank z kursora na końcu wyrazów.

  • Tryb polecenia Vi: <y,e>

ViYankLeft

Znaki Yank z lewej strony kursora.

  • Tryb polecenia Vi: <y,h>

ViYankLine

Yank cały bufor.

  • Tryb polecenia Vi: <y,y>

ViYankNextGlob

Yank od kursora na początek następnych wyrazów.

  • Tryb polecenia Vi: <y,W>

ViYankNextWord

Yank wyrazy po kursorze.

  • Tryb polecenia Vi: <y,w>

ViYankPercent

Yank do/z pasującego nawiasu klamrowego.

  • Tryb polecenia Vi: <y,%>

ViYankPreviousGlob

Yank od początku word(s) do kursora.

  • Tryb polecenia Vi: <y,B>

ViYankPreviousWord

Yank wyrazy przed kursorem.

  • Tryb polecenia Vi: <y,b>

ViYankRight

Znaki Yank pod i po prawej stronie kursora.

  • Tryb polecenia Vi: <y,l>, <y,Spacebar>

ViYankToEndOfLine

Yank z kursora na końcu buforu.

  • Tryb polecenia Vi: <y,$>

ViYankToFirstChar

Yank od pierwszego znaku innego niż biały znak do kursora.

  • Tryb polecenia Vi: <y,^>

Yank

Dodaj ostatnio zabity tekst do danych wejściowych.

  • Tryb Emacs: Ctrl+y

YankLastArg

Yank ostatni argument z poprzedniej linii historii. Z argumentem, po raz pierwszy jest wywoływany, zachowuje się tak jak YankNthArg. Jeśli wywołano wiele razy, zamiast tego iteruje przez historię, arg ustawia kierunek (ujemny odwraca kierunek).

  • Tryb systemu Windows: Alt+.
  • Tryb Emacs: Alt+., , Escape,.Alt+_,Escape,_

YankNthArg

Yank pierwszy argument (po poleceniu) z poprzedniego wiersza historii. Z argumentem, yank nth argument (począwszy od 0), jeśli argument jest ujemny, zacznij od ostatniego argumentu.

  • Tryb Emacs: Ctrl+Alt+y, Escape,Ctrl+y

YankPop

Jeśli poprzednia operacja to Yank lub YankPop, zastąp wcześniej szarpany tekst następnym zabitym tekstem z kill-ring.

  • Tryb Emacs: Alt+y, Escape,y

Funkcje uzupełniania

Ukończ

Spróbuj wykonać uzupełnianie tekstu otaczającego kursor. Jeśli istnieje wiele możliwych uzupełnień, najdłuższy jednoznaczny prefiks jest używany do ukończenia. Jeśli próbujesz ukończyć najdłuższe jednoznaczne zakończenie, zostanie wyświetlona lista możliwych uzupełniania.

  • Tryb Emacs: Tab

Spróbuj wykonać uzupełnianie tekstu otaczającego kursor. Jeśli istnieje wiele możliwych uzupełnień, najdłuższy jednoznaczny prefiks jest używany do ukończenia. Jeśli próbujesz ukończyć najdłuższe jednoznaczne zakończenie, zostanie wyświetlona lista możliwych uzupełniania.

  • Tryb systemu Windows: Ctrl+@, Ctrl+Spacebar
  • Tryb Emacs: Ctrl+Spacebar

Możliwe uzupełnianie

Wyświetl listę możliwych uzupełnień.

  • Tryb Emacs: Alt+=
  • Tryb wstawiania vi: Ctrl+Spacebar
  • Tryb polecenia Vi: <Ctrl+Spacebar>

TabCompleteNext

Spróbuj ukończyć tekst wokół kursora z następnym dostępnym ukończeniem.

  • Tryb systemu Windows: Tab
  • Tryb polecenia Vi: <Tab>

TabCompletePrevious

Spróbuj ukończyć tekst otaczający kursor z poprzednim dostępnym uzupełnianiem.

  • Tryb systemu Windows: Shift+Tab
  • Tryb polecenia Vi: <Shift+Tab>

ViTabCompleteNext

Kończy bieżącą grupę edycji w razie potrzeby i wywołuje metodę TabCompleteNext.

  • Tryb wstawiania vi: Tab

ViTabCompletePrevious

Kończy bieżącą grupę edycji, jeśli jest to konieczne, i wywołuje element TabCompletePrevious.

  • Tryb wstawiania vi: Shift+Tab

Funkcje przenoszenia kursora

WsteczChar

Przenieś kursor jeden znak po lewej stronie. Może to spowodować przeniesienie kursora do poprzedniego wiersza danych wejściowych wielowierszowych.

  • Tryb systemu Windows: LeftArrow
  • Tryb Emacs: LeftArrow, Ctrl+b

Kolejność wstecz

Przenieś kursor z powrotem na początek bieżącego wyrazu lub jeśli między wyrazami, początek poprzedniego wyrazu. Granice wyrazów są definiowane przez konfigurowalny zestaw znaków.

  • Tryb systemu Windows: Ctrl+LeftArrow
  • Tryb Emacs: Alt+b, Escape,b
  • Tryb wstawiania vi: Ctrl+LeftArrow
  • Tryb polecenia Vi: <Ctrl+LeftArrow>

Znaki definiujące granice wyrazów są konfigurowane we właściwości WordDelimiters obiektu PSConsoleReadLineOptions. Aby wyświetlić lub zmienić właściwość WordDelimiters, zobacz Get-PSReadLineOption i Set-PSReadLineOption.

PoczątekOfLine

Jeśli dane wejściowe mają wiele wierszy, przejdź do początku bieżącego wiersza lub jeśli już na początku wiersza, przejdź do początku danych wejściowych. Jeśli dane wejściowe mają jeden wiersz, przejdź do początku danych wejściowych.

  • Tryb systemu Windows: Home
  • Tryb Emacs: Home, Ctrl+a
  • Tryb wstawiania vi: Home
  • Tryb polecenia Vi: <Home>

EndOfLine

Jeśli dane wejściowe mają wiele wierszy, przejdź na koniec bieżącego wiersza lub jeśli już na końcu wiersza, przejdź na koniec danych wejściowych. Jeśli dane wejściowe mają jeden wiersz, przejdź na koniec danych wejściowych.

  • Tryb systemu Windows: End
  • Tryb Emacs: End, Ctrl+e
  • Tryb wstawiania vi: End

ForwardChar

Przenieś kursor jeden znak po prawej stronie. Może to spowodować przeniesienie kursora do następnego wiersza danych wejściowych wielowierszowych.

  • Tryb systemu Windows: RightArrow
  • Tryb Emacs: RightArrow, Ctrl+f

Kolejność przesyłania dalej

Przesuń kursor do przodu na końcu bieżącego słowa lub , jeśli między wyrazami, na końcu następnego wyrazu. Granice wyrazów są definiowane przez konfigurowalny zestaw znaków.

  • Tryb Emacs: Alt+f, Escape,f

Znaki definiujące granice wyrazów są konfigurowane we właściwości WordDelimiters obiektu PSConsoleReadLineOptions. Aby wyświetlić lub zmienić właściwość WordDelimiters, zobacz Get-PSReadLineOption i Set-PSReadLineOption.

GotoBrace

Przejdź do pasującego nawiasu klamrowego, nawiasu lub nawiasu kwadratowego.

  • Tryb systemu Windows: Ctrl+]
  • Tryb wstawiania vi: Ctrl+]
  • Tryb polecenia Vi: <Ctrl+]>

GotoColumn

Przejdź do kolumny wskazanej przez element arg.

  • Tryb polecenia Vi: <|>

GotoFirstNonBlankOfLine

Przenieś kursor do pierwszego niepustego znaku w wierszu.

  • Tryb polecenia Vi: <^>, <_>

MoveToEndOfLine

Przenieś kursor na koniec danych wejściowych.

  • Tryb polecenia Vi: <End>, <$>

MoveToFirstLine

Przejdź do pierwszego wiersza w poleceniu wielowierszowym.

  • Tryb polecenia Vi: <g,g>

MoveToLastLine

Przejdź do ostatniego wiersza w poleceniu wielowierszowym.

  • Tryb polecenia Vi: <G>

Następna linia

Przenieś kursor do następnego wiersza.

  • Funkcja jest niezwiązana.

Kolejność

Przesuń kursor do przodu na początek następnego wyrazu. Granice wyrazów są definiowane przez konfigurowalny zestaw znaków.

  • Tryb systemu Windows: Ctrl+RightArrow
  • Tryb wstawiania vi: Ctrl+RightArrow
  • Tryb polecenia Vi: <Ctrl+RightArrow>

Znaki definiujące granice wyrazów są konfigurowane we właściwości WordDelimiters obiektu PSConsoleReadLineOptions. Aby wyświetlić lub zmienić właściwość WordDelimiters, zobacz Get-PSReadLineOption i Set-PSReadLineOption.

NextWordEnd

Przesuń kursor do przodu na końcu bieżącego słowa lub , jeśli między wyrazami, na końcu następnego wyrazu. Granice wyrazów są definiowane przez konfigurowalny zestaw znaków.

  • Tryb polecenia Vi: <e>

Znaki definiujące granice wyrazów są konfigurowane we właściwości WordDelimiters obiektu PSConsoleReadLineOptions. Aby wyświetlić lub zmienić właściwość WordDelimiters, zobacz Get-PSReadLineOption i Set-PSReadLineOption.

Poprzedni wiersz

Przenieś kursor do poprzedniego wiersza.

  • Funkcja jest niezwiązana.

ShellBackwardWord

Przenieś kursor z powrotem na początek bieżącego wyrazu lub jeśli między wyrazami, początek poprzedniego wyrazu. Granice programu Word są definiowane przez tokeny programu PowerShell.

  • Funkcja jest niezwiązana.

ShellForwardWord

Przesuń kursor do przodu na początek następnego wyrazu. Granice programu Word są definiowane przez tokeny programu PowerShell.

  • Funkcja jest niezwiązana.

ShellNextWord

Przesuń kursor do przodu na końcu bieżącego słowa lub , jeśli między wyrazami, na końcu następnego wyrazu. Granice programu Word są definiowane przez tokeny programu PowerShell.

  • Funkcja jest niezwiązana.

ViBackwardChar

Przenieś kursor jeden znak z lewej strony w trybie edycji Vi. Może to spowodować przeniesienie kursora do poprzedniego wiersza danych wejściowych wielowierszowych.

  • Tryb wstawiania vi: LeftArrow
  • Tryb polecenia Vi: <LeftArrow>, , <Backspace><h>

ViBackwardWord

Przenieś kursor z powrotem na początek bieżącego wyrazu lub jeśli między wyrazami, początek poprzedniego wyrazu. Granice wyrazów są definiowane przez konfigurowalny zestaw znaków.

  • Tryb polecenia Vi: <b>

Znaki definiujące granice wyrazów są konfigurowane we właściwości WordDelimiters obiektu PSConsoleReadLineOptions. Aby wyświetlić lub zmienić właściwość WordDelimiters, zobacz Get-PSReadLineOption i Set-PSReadLineOption.

ViEndOfGlob

Przenieś kursor na koniec tego wyrazu jako rozdzielany odstępem.

  • Tryb polecenia Vi: <E>

ViEndOfPreviousGlob

Przenosi się na koniec poprzedniego wyrazu, używając tylko białych znaków jako ogranicznika wyrazów.

  • Funkcja jest niezwiązana.

ViForwardChar

Przenieś kursor jeden znak po prawej stronie w trybie edycji Vi. Może to spowodować przeniesienie kursora do następnego wiersza danych wejściowych wielowierszowych.

  • Tryb wstawiania vi: RightArrow
  • Tryb polecenia Vi: <RightArrow>, , <Spacebar><l>

ViGotoBrace

Podobnie jak GotoBrace, ale jest oparty na znakach zamiast opartych na tokenach.

  • Tryb polecenia Vi: <%>

ViNextGlob

Przenosi się do następnego słowa, używając tylko białych znaków jako ogranicznika wyrazów.

  • Tryb polecenia Vi: <W>

ViNextWord

Przesuń kursor do przodu na początek następnego wyrazu. Granice wyrazów są definiowane przez konfigurowalny zestaw znaków.

  • Tryb polecenia Vi: <w>

Znaki definiujące granice wyrazów są konfigurowane we właściwości WordDelimiters obiektu PSConsoleReadLineOptions. Aby wyświetlić lub zmienić właściwość WordDelimiters, zobacz Get-PSReadLineOption i Set-PSReadLineOption.

Funkcje historii

PoczątekOfHistory

Przejdź do pierwszego elementu w historii.

  • Tryb Emacs: Alt+<

ClearHistory

Czyści historię w programie PSReadLine. Nie ma to wpływu na historię programu PowerShell.

  • Tryb systemu Windows: Alt+F7

EndOfHistory

Przejdź do ostatniego elementu (bieżące dane wejściowe) w historii.

  • Tryb Emacs: Alt+>

ForwardSearchHistory

Przeprowadź przyrostowe wyszukiwanie w przyszłości za pomocą historii.

  • Tryb systemu Windows: Ctrl+s
  • Tryb Emacs: Ctrl+s
  • Tryb wstawiania vi: Ctrl+s
  • Tryb polecenia Vi: <Ctrl+s>

HistoriaSearchBackward

Zastąp bieżące dane wejściowe elementem "previous" z historii PSReadLine, który pasuje do znaków między rozpoczęciem a wejściem i kursorem.

  • Tryb systemu Windows: F8

HistoriaSearchForward

Zastąp bieżące dane wejściowe elementem "next" z historii PSReadLine, który pasuje do znaków między rozpoczęciem a wejściem i kursorem.

  • Tryb systemu Windows: Shift+F8

NastępnyHistory

Zastąp bieżące dane wejściowe elementem "next" z historii PSReadLine.

  • Tryb systemu Windows: DownArrow
  • Tryb Emacs: DownArrow, Ctrl+n
  • Tryb wstawiania vi: DownArrow
  • Tryb polecenia Vi: <DownArrow>, , <j><+>

Poprzednihistory

Zastąp bieżące dane wejściowe elementem "previous" z historii PSReadLine.

  • Tryb systemu Windows: UpArrow
  • Tryb Emacs: UpArrow, Ctrl+p
  • Tryb wstawiania vi: UpArrow
  • Tryb polecenia Vi: <UpArrow>, , <k><->

ReverseSearchHistory

Przeprowadź przyrostowe wyszukiwanie wsteczne za pomocą historii.

  • Tryb systemu Windows: Ctrl+r
  • Tryb Emacs: Ctrl+r
  • Tryb wstawiania vi: Ctrl+r
  • Tryb polecenia Vi: <Ctrl+r>

ViSearchHistoryBackward

Monituje o ciąg wyszukiwania i inicjuje wyszukiwanie przy użyciu funkcji AcceptLine.

  • Tryb polecenia Vi: </>

Różne funkcje

CaptureScreen

Rozpocznij przechwytywanie ekranu interakcyjnego — strzałki w górę/w dół wybierają linie, wprowadź tekst zaznaczony do schowka jako tekst i kod HTML.

  • Funkcja jest niezwiązana.

ClearScreen

Wyczyść ekran i narysuj bieżący wiersz w górnej części ekranu.

  • Tryb systemu Windows: Ctrl+l
  • Tryb Emacs: Ctrl+l
  • Tryb wstawiania vi: Ctrl+l
  • Tryb polecenia Vi: <Ctrl+l>

DigitArgument

Uruchom nowy argument cyfry, aby przekazać go do innych funkcji. Można go użyć jako mnożnika dla następnej funkcji wywoływanej przez platformę keypress. Na przykład naciśnięcie <Alt+1> <Alt+0> ustawia wartość digit-argument na 10. Następnie naciśnięcie # powoduje wysłanie 10 # znaków (##########) do wiersza wejściowego. Podobnie możesz użyć tej funkcji z innymi operacjami, takimi jak <Delete> lub Left-Arrow.

  • Tryb systemu Windows: Alt+0, Alt+2Alt+5Alt+3Alt+1Alt+6Alt+7Alt+4Alt+8, , Alt+9Alt+-
  • Tryb Emacs: Alt+0, Alt+1, Alt+2Alt+6Alt+3Alt+5Alt+7Alt+4Alt+8, , Alt+9Alt+-
  • Tryb polecenia Vi: <0>, <1>, <2>, <3><8><4><5><6><7><9>

InvokePrompt

Usuwa bieżący monit i wywołuje funkcję monitu w celu ponownego redysponowania monitu. Przydatne w przypadku niestandardowych procedur obsługi kluczy, które zmieniają stan. Na przykład zmień bieżący katalog.

  • Funkcja jest niezwiązana.

ScrollDisplayDown

Przewiń ekran w dół o jeden ekran.

  • Tryb systemu Windows: PageDown
  • Tryb Emacs: PageDown

ScrollDisplayDownLine

Przewiń ekran w dół o jeden wiersz.

  • Tryb systemu Windows: Ctrl+PageDown
  • Tryb Emacs: Ctrl+PageDown

ScrollDisplayToCursor

Przewiń ekran do kursora.

  • Tryb Emacs: Ctrl+End

ScrollDisplayTop

Przewiń ekran do góry.

  • Tryb Emacs: Ctrl+Home

ScrollDisplayUp

Przewiń ekran w górę.

  • Tryb systemu Windows: PageUp
  • Tryb Emacs: PageUp

ScrollDisplayUpLine

Przewiń ekran w górę o jeden wiersz.

  • Tryb systemu Windows: Ctrl+PageUp
  • Tryb Emacs: Ctrl+PageUp

ShowCommandHelp

Zapewnia widok pełnej pomocy dotyczącej poleceń cmdlet. Gdy kursor znajduje się na końcu w pełni rozwiniętego parametru, naciśnięcie powoduje położenie <F1> wyświetlania pomocy w lokalizacji tego parametru.

Pomoc jest wyświetlana w alternatywnym buforze ekranu przy użyciu pagera z programu Microsoft.PowerShell.Pager. Po wyjściu z pagera zostanie zwrócona oryginalna pozycja kursora na oryginalnym ekranie. Ten pager działa tylko w nowoczesnych aplikacjach terminalowych, takich jak Terminal Windows.

  • Tryb systemu Windows: F1
  • Tryb Emacs: F1
  • Tryb wstawiania vi: F1
  • Tryb polecenia Vi: <F1>

ShowKeyBindings

Pokaż wszystkie powiązane klucze.

  • Tryb systemu Windows: Ctrl+Alt+?
  • Tryb Emacs: Ctrl+Alt+?
  • Tryb wstawiania vi: Ctrl+Alt+?

ShowParameterHelp

Zapewnia dynamiczną pomoc dla parametrów, pokazując ją poniżej bieżącego wiersza polecenia, takiego jak MenuComplete. Po naciśnięciu kursor musi znajdować się na końcu w pełni rozwiniętej nazwy parametru <Alt+h> .

  • Tryb systemu Windows: Alt+h
  • Tryb Emacs: Alt+h
  • Tryb wstawiania vi: Alt+h
  • Tryb polecenia Vi: <Alt+h>

ViCommandMode

Przełącz bieżący tryb operacyjny z Vi-Insert na Vi-Command.

  • Tryb wstawiania vi: Escape

ViDigitArgumentInChord

Rozpocznij nowy argument cyfry, aby przekazać do innych funkcji w jednym z akordów vi.

  • Funkcja jest niezwiązana.

ViEditVisually

Edytuj wiersz polecenia w edytorze tekstów określonym przez $env:EDITOR lub $env:VISUAL.

  • Tryb Emacs: Ctrl+x,Ctrl+e
  • Tryb polecenia Vi: <v>

ViExit

Zamyka powłokę.

  • Funkcja jest niezwiązana.

ViInsertMode

Przełącz się do trybu wstawiania.

  • Tryb polecenia Vi: <i>

WhatIsKey

Przeczytaj klucz i powiedz mi, z czym jest powiązany klucz.

  • Tryb systemu Windows: Alt+?
  • Tryb Emacs: Alt+?

Funkcje przewidywania

AcceptNextSuggestionWord

Zaakceptuj następne słowo w tekście lub wybranej sugestii

  • Funkcja jest niezwiązana.

AcceptSuggestion

W przypadku użycia InlineView jako stylu widoku do przewidywania zaakceptuj bieżącą sugestię śródliniową.

  • Funkcja jest niezwiązana.

NextSuggestion

W przypadku użycia ListView jako stylu widoku do przewidywania przejdź do następnej sugestii na liście.

  • Funkcja jest niezwiązana.

PreviousSuggestion

W przypadku użycia ListView jako stylu widoku do przewidywania przejdź do poprzedniej sugestii na liście.

  • Funkcja jest niezwiązana.

ShowFullPredictionTooltip

Pokaż etykietkę narzędzia aktualnie wybranego elementu listy w pełnym widoku.

  • Tryb systemu Windows: F4
  • Tryb Emacs: F4
  • Tryb wstawiania vi: F4

SwitchPredictionView

Przełącz styl widoku na potrzeby przewidywania między InlineView i ListView.

  • Tryb systemu Windows: F2
  • Tryb Emacs: F2
  • Tryb wstawiania vi: F2

Wyszukaj funkcje

Wyszukiwanie znaków

Odczytaj znak i wyszukaj dalej następne wystąpienie tego znaku. Jeśli zostanie określony argument, wyszukaj do przodu (lub wstecz, jeśli ujemne) dla nth wystąpienia.

  • Tryb systemu Windows: F3
  • Tryb Emacs: Ctrl+]
  • Tryb wstawiania vi: F3
  • Tryb polecenia Vi: <F3>

CharacterSearchBackward

Odczytaj znak i wyszukaj do tyłu następne wystąpienie tego znaku. Jeśli argument jest określony, wyszukaj do tyłu (lub do przodu, jeśli ujemne) dla nth wystąpienia.

  • Tryb systemu Windows: Shift+F3
  • Tryb Emacs: Ctrl+Alt+]
  • Tryb wstawiania vi: Shift+F3
  • Tryb polecenia Vi: <Shift+F3>

RepeatLastCharSearch

Powtórz ostatnie zarejestrowane wyszukiwanie znaków.

  • Tryb polecenia Vi: <;>

RepeatLastCharSearchBackwards

Powtórz ostatnie zarejestrowane wyszukiwanie znaków, ale w przeciwnym kierunku.

  • Tryb polecenia Vi: <,>

RepeatSearch

Powtórz ostatnie wyszukiwanie w tym samym kierunku co poprzednio.

  • Tryb polecenia Vi: <n>

RepeatSearchBackward

Powtórz ostatnie wyszukiwanie w tym samym kierunku co poprzednio.

  • Tryb polecenia Vi: <N>

SearchChar

Przeczytaj następny znak, a następnie znajdź go w przyszłości.

  • Tryb polecenia Vi: <f>

SearchCharBackward

Odczytaj następny znak, a następnie znajdź go, przechodząc do tyłu.

  • Tryb polecenia Vi: <F>

SearchCharBackwardWithBackoff

Odczytaj następny znak, a następnie znajdź go, przechodząc do tyłu, a następnie cofając znak.

  • Tryb polecenia Vi: <T>

SearchCharWithBackoff

Odczytaj następny znak, a następnie znajdź go, przechodząc do przodu, a następnie cofając znak.

  • Tryb polecenia Vi: <t>

SearchForward

Monituje o ciąg wyszukiwania i inicjuje wyszukiwanie przy użyciu funkcji AcceptLine.

  • Tryb polecenia Vi: <?>

Funkcje wyboru

ExchangePointAndMark

Kursor jest umieszczany w lokalizacji znacznika, a znacznik jest przenoszony do lokalizacji kursora.

  • Tryb Emacs: Ctrl+x,Ctrl+x

Wybierzwszystkie

Wybierz cały wiersz.

  • Tryb systemu Windows: Ctrl+a

Wybierz pozycjęBackwardChar

Dostosuj bieżące zaznaczenie, aby uwzględnić poprzedni znak.

  • Tryb systemu Windows: Shift+LeftArrow
  • Tryb Emacs: Shift+LeftArrow

Wybierz pozycjęBackwardsLine

Dostosuj bieżące zaznaczenie, aby uwzględnić kursor na początku wiersza.

  • Tryb systemu Windows: Shift+Home
  • Tryb Emacs: Shift+Home

Wybierz pozycjęBackwardWord

Dostosuj bieżące zaznaczenie, aby uwzględnić poprzednie słowo.

  • Tryb systemu Windows: Shift+Ctrl+LeftArrow
  • Tryb Emacs: Alt+B

Wybierz pozycjęCommandArgument

Umożliwia wybór wizualnych argumentów poleceń. Wybór argumentów jest zakresem w bloku skryptu. Na podstawie położenia kursora przeszukuje od najbardziej wewnętrznego bloku skryptu do najbardziej zaawansowanego bloku skryptu i zatrzymuje się po znalezieniu argumentów w zakresie bloku skryptu.

Ta funkcja honoruje funkcję DigitArgument. Traktuje dodatnie lub ujemne wartości argumentów jako przesunięcie do przodu lub do tyłu z aktualnie wybranego argumentu lub z bieżącego położenia kursora, gdy nie wybrano żadnego argumentu.

  • Tryb systemu Windows: Alt+a
  • Tryb Emacs: Alt+a

Wybierz pozycjęForwardChar

Dostosuj bieżące zaznaczenie, aby uwzględnić następny znak.

  • Tryb systemu Windows: Shift+RightArrow
  • Tryb Emacs: Shift+RightArrow

Wybierz pozycjęForwardWord

Dostosuj bieżące zaznaczenie, aby uwzględnić następny wyraz przy użyciu elementu ForwardWord.

  • Tryb Emacs: Alt+F

Wybierz linię

Dostosuj bieżące zaznaczenie, aby uwzględnić kursor na końcu wiersza.

  • Tryb systemu Windows: Shift+End
  • Tryb Emacs: Shift+End

Wybierz pozycjęDalejWord

Dostosuj bieżące zaznaczenie, aby uwzględnić następny wyraz.

  • Tryb systemu Windows: Shift+Ctrl+RightArrow

Wybierz pozycjęShellBackwardWord

Dostosuj bieżące zaznaczenie, aby uwzględnić poprzednie słowo za pomocą polecenia ShellBackwardWord.

  • Funkcja jest niezwiązana.

Wybierz pozycjęShellForwardWord

Dostosuj bieżące zaznaczenie, aby uwzględnić następny wyraz za pomocą polecenia ShellForwardWord.

  • Funkcja jest niezwiązana.

Wybierz kolejno pozycjeShellDalejWord

Dostosuj bieżące zaznaczenie, aby uwzględnić następny wyraz za pomocą polecenia ShellNextWord.

  • Funkcja jest niezwiązana.

SetMark

Oznacz bieżącą lokalizację kursora do użycia w kolejnym poleceniu edycji.

  • Tryb Emacs: Ctrl+@

Interfejsy API obsługi powiązań kluczy niestandardowych

Następujące funkcje są publiczne w elemecie Microsoft.PowerShell.PSConsoleReadLine, ale nie mogą być bezpośrednio powiązane z kluczem. Większość z tych elementów jest przydatna w powiązaniach kluczy niestandardowych.

void AddToHistory(string command)

Dodaj wiersz polecenia do historii bez jego wykonywania.

void ClearKillRing()

Wyczyść pierścień kill-ring. Jest to najczęściej używane do testowania.

void Delete(int start, int length)

Usuń znaki długości od początku. Ta operacja obsługuje cofanie/ponowne wykonanie.

void Ding()

Wykonaj akcję Ding na podstawie preferencji użytkownika.

void GetBufferState([ref] string input, [ref] int cursor)
void GetBufferState([ref] Ast ast, [ref] Token[] tokens,
  [ref] ParseError[] parseErrors, [ref] int cursor)

Te dwie funkcje pobierają przydatne informacje o bieżącym stanie buforu wejściowego. Pierwszy jest częściej używany w prostych przypadkach. Drugi jest używany, jeśli powiązanie wykonuje coś bardziej zaawansowanego za pomocą narzędzia Ast.

IEnumerable[Microsoft.PowerShell.KeyHandler]
  GetKeyHandlers(bool includeBound, bool includeUnbound)

IEnumerable[Microsoft.PowerShell.KeyHandler]
  GetKeyHandlers(string[] Chord)

Te dwie funkcje są używane przez Get-PSReadLineKeyHandlerprogram . Pierwszy służy do pobierania wszystkich powiązań kluczy. Drugi służy do pobierania określonych powiązań kluczy.

Microsoft.PowerShell.PSConsoleReadLineOptions GetOptions()

Ta funkcja jest używana przez polecenie Get-PSReadLineOption i prawdopodobnie nie jest zbyt przydatna w powiązaniu klucza niestandardowego.

void GetSelectionState([ref] int start, [ref] int length)

Jeśli w wierszu polecenia nie ma zaznaczenia, funkcja zwraca wartość -1 zarówno na początku, jak i długości. Jeśli w wierszu polecenia jest zaznaczony wybór, zwracany jest początek i długość zaznaczenia.

void Insert(char c)
void Insert(string s)

Wstaw znak lub ciąg na kursorze. Ta operacja obsługuje cofanie/ponowne wykonanie.

string ReadLine(runspace remoteRunspace,
  System.Management.Automation.EngineIntrinsics engineIntrinsics)

Jest to główny punkt wejścia do elementu PSReadLine. Nie obsługuje rekursji, więc nie jest przydatna w niestandardowym powiązaniu klucza.

void RemoveKeyHandler(string[] key)

Ta funkcja jest używana przez program Remove-PSReadLineKeyHandler i prawdopodobnie nie jest zbyt przydatna w powiązaniu klucza niestandardowego.

void Replace(int start, int length, string replacement)

Zastąp niektóre dane wejściowe. Ta operacja obsługuje cofanie/ponowne wykonanie. Jest to preferowane w przypadku operacji Usuń, a następnie Wstaw, ponieważ jest ona traktowana jako pojedyncza akcja do cofnięcia.

void SetCursorPosition(int cursor)

Przenieś kursor do danego przesunięcia. Ruch kursora nie jest śledzony w celu cofnięcia.

void SetOptions(Microsoft.PowerShell.SetPSReadLineOption options)

Ta funkcja jest metodą pomocnika używaną przez polecenie cmdlet Set-PSReadLineOption, ale może być przydatna dla niestandardowego powiązania klucza, które chce tymczasowo zmienić ustawienie.

bool TryGetArgAsInt(System.Object arg, [ref] int numericArg,
  int defaultNumericArg)

Ta metoda pomocnika jest używana w przypadku powiązań niestandardowych, które honoruje funkcję DigitArgument. Typowe wywołanie wygląda następująco:

[int]$numericArg = 0
[Microsoft.PowerShell.PSConsoleReadLine]::TryGetArgAsInt($arg,
  [ref]$numericArg, 1)

Uwagi

Zachowanie zdarzenia OnIdle

  • Gdy funkcja PSReadLine jest używana, zdarzenie OnIdle jest wyzwalane, gdy ReadKey() limit czasu jest wyświetlany (bez wpisywania w ciągu 300 ms). Zdarzenie może być zasygnalizowane, gdy użytkownik znajduje się w trakcie edytowania wiersza polecenia, na przykład użytkownik odczytuje pomoc, aby zdecydować, który parametr ma być używany.

    Począwszy od programu PSReadLine 2.2.0-beta4, zachowanie OnIdle zmieniło się w taki sposób, aby sygnalizować zdarzenie tylko wtedy, gdy występuje ReadKey() przekroczenie limitu czasu, a bieżący bufor edycji jest pusty.

Zobacz też