Share via

Obiekt ISEEditor

  • Artykuł

Obiekt ISEEditor jest wystąpieniem klasy Microsoft.PowerShell.Host.ISE.ISEEditor. Okienko Konsola jest obiektem ISEEditor . Każdy obiekt ISEFile ma skojarzony obiekt ISEEditor . W poniższych sekcjach wymieniono metody i właściwości obiektu ISEEditor .

Metody

Clear()

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Czyści tekst w edytorze.

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

EnsureVisible(int lineNumber)

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Przewija edytor tak, aby wiersz odpowiadający określonej wartości parametru lineNumber był widoczny. Zgłasza wyjątek, jeśli określony numer wiersza znajduje się poza zakresem 1,ostatniego numeru wiersza, który definiuje prawidłowe numery wierszy.

lineNumber numer wiersza, 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 programie Windows PowerShell ISE 2.0 lub nowszym.

Ustawia fokus na edytor.

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

GetLineLength(int lineNumber )

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Pobiera długość wiersza jako liczbę całkowitą dla wiersza określonego przez numer wiersza.

lineNumber liczba wierszy, której długość ma być pobierana.

Zwraca długość wiersza dla wiersza w określonym numerze wiersza.

# Gets the length of the first line in the text of the Command pane.
$psISE.CurrentPowerShellTab.ConsolePane.GetLineLength(1)

GoToMatch()

Obsługiwane w programie Windows PowerShell ISE 3.0 lub nowszym i nie są obecne we wcześniejszych wersjach.

Przenosi daszek do pasującego znaku, jeśli właściwość CanGoToMatch obiektu edytora to $true, która występuje, gdy daszek znajduje się bezpośrednio przed nawiasem otwierającym, nawiasem lub nawiasem klamrowym — (,{[ lub bezpośrednio po nawiasie zamykającym, nawiasie lub nawiasie klamrowym — ),,]}. Daszek jest umieszczany przed znakiem otwierającym lub po znaku zamykającym. Jeśli właściwość CanGoToMatch to $false, ta metoda nic nie robi.

# Goes to the matching character if CanGoToMatch() is $true
$psISE.CurrentPowerShellTab.ConsolePane.GoToMatch()

InsertText( tekst )

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Zamienia zaznaczenie tekstem lub wstawia tekst w bieżącej pozycji karetki.

text — ciąg tekst do wstawienia.

Zobacz przykład skryptu w dalszej części tego tematu.

Select( startLine, startColumn, endLine, endColumn )

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Wybiera tekst z parametrów startLine, startColumn, endLine i endColumn.

startLine — liczba całkowita wiersz, w którym rozpoczyna się zaznaczenie.

startColumn — liczba całkowita Kolumna w wierszu początkowym, w którym rozpoczyna się zaznaczenie.

endLine — liczba całkowita— wiersz, w którym kończy się zaznaczenie.

endColumn — liczba całkowita Kolumna w wierszu końcowym, w którym kończy się zaznaczenie.

Zobacz przykład skryptu w dalszej części tego tematu.

SelectCaretLine()

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Zaznacza cały wiersz tekstu, który obecnie zawiera daszek.

# 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 programie Windows PowerShell ISE 2.0 lub nowszym.

Ustawia położenie karetki w numerze wiersza i numerze kolumny. Zgłasza wyjątek, jeśli numer wiersza karetki lub numer kolumny karetki są poza odpowiednimi prawidłowymi zakresami.

lineNumber — liczba całkowita numer wiersza karetki.

columnNumber — liczba całkowita numer kolumny karetki.

# Set the CaretPosition.
$psISE.CurrentFile.Editor.SetCaretPosition(5,1)

PrzełączoutliningExpansion()

Obsługiwane w programie Windows PowerShell ISE 3.0 lub nowszym i nie są obecne we wcześniejszych wersjach.

Powoduje rozwinięcie lub zwinięcie wszystkich sekcji konspektu.

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

Właściwości

CanGoToMatch

Obsługiwane w programie Windows PowerShell ISE 3.0 lub nowszym i nie są obecne we wcześniejszych wersjach.

Właściwość logiczna tylko do odczytu wskazująca, czy daszek znajduje się obok nawiasu, nawiasu lub nawiasu klamrowego — (), , []{}. Jeśli daszek znajduje się bezpośrednio przed znakiem otwierającym lub bezpośrednio po znaku zamykającym pary, ta wartość właściwości to $true. W przeciwnym razie jest to $false.

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

Daszekkolumny

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

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

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

Linia daszka

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Właściwość tylko do odczytu, która pobiera liczbę wierszy, która zawiera daszek.

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

DaszeklineText

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Właściwość tylko do odczytu, która pobiera pełny wiersz tekstu, który zawiera daszek.

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

LineCount

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

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

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

SelectedText

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

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

Zobacz przykład skryptu w dalszej części tego tematu.

Text

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

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

Zobacz przykład skryptu w dalszej części tego tematu.

Przykład tworzenia skryptów

# 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ż