Udostępnij za pomocą

Obiekt ISEEditor

Obiekt ISEEditor to instancja klasy Microsoft.PowerShell.Host.ISE.ISEEditor. Panel konsoli to obiekt ISEEditor . Każdy obiekt ISEFile ma przypisany obiekt ISEEditor . Poniższe sekcje wymieniają metody i właściwości obiektu ISEEditor .

Methods

Clear()

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Usuwa tekst w edytorze.

# Clears the text in the Console pane.
$psISE.CurrentPowerShellTab.ConsolePane.Clear()

EnsureVisible(int lineNumber)

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Przewija edytor tak, aby linia odpowiadająca podanej wartości parametru liniiNumer była widoczna. Wyrzuca wyjątek, jeśli podana liczba linii wykracza poza zakres 1, ostatniego numeru linii, który definiuje prawidłowe numery linii.

  • liniaNumer – Numer linii, który ma być widoczny.
# Scrolls the text in the Script pane so that the fifth line is in view.
$psISE.CurrentFile.Editor.EnsureVisible(5)

Focus()

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Skupia się na edytorze.

# Sets focus to the Console pane.
$psISE.CurrentPowerShellTab.ConsolePane.Focus()

GetLineLength(int lineNumber )

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Otrzymuje długość linii jako liczbę całkowitą dla linii określonej przez numer linii.

  • liniaNumer – Numer linii, której długość należy wyznaczyć.
  • Returns – długość linii linii o określonym numerze linii.
# Gets the length of the first line in the text of the Command pane.
$psISE.CurrentPowerShellTab.ConsolePane.GetLineLength(1)

GoToMatch()

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Przenosi karetę do znaku pasującego, jeśli właściwość CanGoToMatch obiektu edytora to , co następuje $true, gdy karetka znajduje się bezpośrednio przed nawiasem otwierającym, nawiasem lub nawiasem

  • (,[, -{ lub bezpośrednio po nawiasie zamykającym, nawiasie lub nawiasie - ),],.} Kurz umieszcza się przed znakiem otwierającym lub po znaku końcowym. Jeśli własność CanGoToMatch to $false, to ta metoda nic nie robi.
# Goes to the matching character if CanGoToMatch() is $true
$psISE.CurrentPowerShellTab.ConsolePane.GoToMatch()

InsertText( text )

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Zastępuje zaznaczenie tekstem lub wstawia tekst w aktualnej pozycji kursówki.

  • tekst - Ciąg tekstu - Tekst do wstawienia.

Zobacz przykład skryptowania później w tym temacie.

Select( startLine, startColumn, endLine, endColumn )

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Wybiera tekst z parametrów StartLine, startColumn, endLine oraz endColumn .

  • startLine: - Liczba całkowita - Linia, na której zaczyna się zaznaczenie.
  • startColumn - Liczba całkowita - Kolumna w linii startowej, gdzie zaczyna się zaznaczenie.
  • endLine - Liczba całkowita - linia, na której kończy się zaznaczenie.
  • endColumn - Liczba całkowita - Kolumna w linii końcowej, gdzie kończy się zaznaczenie.

Zobacz przykład skryptowania później w tym temacie.

SelectCaretLine()

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Wybiera całą linijkę tekstu, która obecnie zawiera kursorę.

# First, set the caret position on line 5.
$psISE.CurrentFile.Editor.SetCaretPosition(5,1)
# Now select that entire line of text
$psISE.CurrentFile.Editor.SelectCaretLine()

SetCaretPosition( lineNumber, columnNumber )

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Ustawia pozycję karetu na numer linii i numer kolumny. Tworzy wyjątek, jeśli numer linii karetu lub kolumny karetu wykraczają poza swoje prawidłowe zakresy.

  • linia Numer - Liczba całkowita - Numer linii kursowej.
  • columnNumber - Liczba całkowita - Numer kolumny karety.
# Set the CaretPosition.
$psISE.CurrentFile.Editor.SetCaretPosition(5,1)

ToggleOutliningExpansion()

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Powoduje to rozszerzanie lub zapadanie się wszystkich sekcji konspektu.

# Toggle the outlining expansion
$psISE.CurrentFile.Editor.ToggleOutliningExpansion()

Właściwości

CanGoToMatch

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Właściwość boolowska tylko do odczytu, aby wskazać, czy karet znajduje się obok nawiasu, nawiasu czy nawiasu - (), [], . {} Jeśli karat znajduje się bezpośrednio przed znakiem otwierającym lub zaraz po znaku zamykającym pary, to wartość tej właściwości wynosi $true. W przeciwnym razie $false.

# Test to see if the caret is next to a parenthesis, bracket, or brace
$psISE.CurrentFile.Editor.CanGoToMatch

CaretColumn

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Właściwość tylko do odczytu, która nadaje numer kolumny odpowiadający pozycji karety.

# Get the CaretColumn.
$psISE.CurrentFile.Editor.CaretColumn

CaretLine

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Właściwość tylko do odczytu, która otrzymuje numer linii zawierającej karemat.

# Get the CaretLine.
$psISE.CurrentFile.Editor.CaretLine

CaretLineText

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Właściwość tylko do odczytu, która otrzymuje pełną linię tekstu zawierającą karematkę.

# Get all of the text on the line that contains the caret.
$psISE.CurrentFile.Editor.CaretLineText

LineCount

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Właściwość tylko do odczytu, która pobiera liczbę linii od edytora.

# Get the LineCount.
$psISE.CurrentFile.Editor.LineCount

SelectedText

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Właściwość tylko do odczytu, która pobiera wybrany tekst z edytora.

Zobacz przykład skryptowania później w tym temacie.

Tekst

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Właściwość czytania/zapisu, która pobiera lub ustawia tekst w edytorze.

Zobacz przykład skryptowania później w tym temacie.

Przykład skryptowania

# This illustrates how you can use the length of a line to
# select the entire line and shows how you can make it lowercase.
# You must run this in the Console pane. It will not run in the Script pane.
# Begin by getting a variable that points to the editor.
$myEditor = $psISE.CurrentFile.Editor
# Clear the text in the current file editor.
$myEditor.Clear()

# Make sure the file has five lines of text.
$myEditor.InsertText("LINE1 `n")
$myEditor.InsertText("LINE2 `n")
$myEditor.InsertText("LINE3 `n")
$myEditor.InsertText("LINE4 `n")
$myEditor.InsertText("LINE5 `n")

# Use the GetLineLength method to get the length of the third line.
$endColumn = $myEditor.GetLineLength(3)
# Select the text in the first three lines.
$myEditor.Select(1, 1, 3, $endColumn + 1)
$selection = $myEditor.SelectedText
# Clear all the text in the editor.
$myEditor.Clear()
# Add the selected text back, but in lower case.
$myEditor.InsertText($selection.ToLower())

Zobacz też

  • Last updated on