Obiekt ISEEditorThe ISEEditor Object

ISEEditor obiekt jest wystąpieniem klasy Microsoft.PowerShell.Host.ISE.ISEEditor.An ISEEditor object is an instance of the Microsoft.PowerShell.Host.ISE.ISEEditor class. W okienku konsoli jest ISEEditor obiektu.The Console pane is an ISEEditor object. Każdy ISEFile ma skojarzony obiekt ISEEditor obiektu.Each ISEFile object has an associated ISEEditor object. Poniższe sekcje zawierają listę metod i właściwości ISEEditor obiektu.The following sections list the methods and properties of an ISEEditor object.

MetodyMethods

Wyczyść()Clear()

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Usuwa tekst w edytorze.Clears the text in the editor.

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

EnsureVisible(int numer wiersza)EnsureVisible(int lineNumber)

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Przewija edytora, tak aby wiersz, który odpowiada określonym numer wiersza wartość parametru jest widoczna.Scrolls the editor so that the line that corresponds to the specified lineNumber parameter value is visible. Jeśli numer wiersza określony jest spoza zakresu 1, ostatni numer wiersza, który definiuje prawidłowe numery zgłasza wyjątek.It throws an exception if the specified line number is outside the range of 1,last line number, which defines the valid line numbers.

numer wiersza numer wiersza, który ma być widoczne.lineNumber The number of the line that is to be made visible.

# Scrolls the text in the Script pane so that the fifth line is in view.
$psISE.CurrentFile.Editor.EnsureVisible(5)

Fokus()Focus()

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Ustawia fokus do edytora.Sets the focus to the editor.

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

GetLineLength(int numer wiersza )GetLineLength(int lineNumber )

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Pobiera długość wiersza jako liczba całkowita dla wiersza, który jest określony przez numer wiersza.Gets the line length as an integer for the line that is specified by the line number.

numer wiersza numer wiersza, którego można pobrać długości.lineNumber The number of the line of which to get the length.

Zwraca długość wiersza dla wiersza na określony numer wiersza.Returns The line length for the line at the specified line number.

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

GoToMatch()GoToMatch()

Obsługiwane w programie Windows PowerShell ISE 3.0 i nowszych i nie znajduje się w starszych wersjach.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

Przenosi karetkę do pasującego znaku, jeśli CanGoToMatch jest właściwością obiektu edytor $true, który występuje, gdy karetka znajduje się bezpośrednio przed nawiasem otwierającym, nawias kwadratowy lub klamrowy - (,[, {- lub bezpośrednio po zamykającym, nawias kwadratowy lub nawias klamrowy - ),],}.Moves the caret to the matching character if the CanGoToMatch property of the editor object is $true, which occurs when the caret is immediately before an opening parenthesis, bracket, or brace - (,[,{ - or immediately after a closing parenthesis, bracket, or brace - ),],}. Daszek znajduje się przed znakiem otwierania lub po znaku zamknięcia.The caret is placed before an opening character or after a closing character. Jeśli CanGoToMatch właściwość jest $false, a następnie ta metoda nie działa.If the CanGoToMatch property is $false, then this method does nothing.

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

InsertText( tekstu )InsertText( text )

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Zamienia zaznaczenie tekstu lub wstawia tekst w bieżącym położeniu karetki.Replaces the selection with text or inserts text at the current caret position.

tekst -String tekst do wstawienia.text - String The text to insert.

Zobacz przykładowe skrypty dalszej części tego tematu.See the Scripting Example later in this topic.

Wybierz( startLine, startColumn, endLine, wartość endColumn )Select( startLine, startColumn, endLine, endColumn )

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Wybiera tekst ze startLine, startColumn, endLine, i wartość endColumn parametrów.Selects the text from the startLine, startColumn, endLine, and endColumn parameters.

startLine — liczba całkowita wiersza, w którym rozpoczyna się zaznaczenie.startLine - Integer The line where the selection starts.

startColumn — liczba całkowita kolumny wiersza start, gdy rozpoczyna się zaznaczenie.startColumn - Integer The column within the start line where the selection starts.

endLine — liczba całkowita wiersza, w którym kończy się zaznaczenie.endLine - Integer The line where the selection ends.

wartość endColumn — liczba całkowita kolumny zakończyć wiersza, w którym kończy się zaznaczenie.endColumn - Integer The column within the end line where the selection ends.

Zobacz przykładowe skrypty dalszej części tego tematu.See the Scripting Example later in this topic.

SelectCaretLine()SelectCaretLine()

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Zaznacza cały wiersz tekstu zawierającego karetki.Selects the entire line of text that currently contains the caret.

# 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( numer wiersza, columnNumber )SetCaretPosition( lineNumber, columnNumber )

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Ustawia położenie karetki na numer wiersza i kolumny.Sets the caret position at the line number and the column number. Jeśli numer wiersza karetki lub numer kolumny karetki są poza ich odpowiednich prawidłowych zakresów, zgłasza wyjątek.It throws an exception if either the caret line number or the caret column number are out of their respective valid ranges.

numer wiersza — całkowitą numer wiersza karetki.lineNumber - Integer The caret line number.

columnNumber — całkowitą liczbę kolumn karetki.columnNumber - Integer The caret column number.

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

ToggleOutliningExpansion()ToggleOutliningExpansion()

Obsługiwane w programie Windows PowerShell ISE 3.0 i nowszych i nie znajduje się w starszych wersjach.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

Powoduje, że wszystkie sekcje konspektu rozwinąć lub zwinąć.Causes all the outline sections to expand or collapse.

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

WłaściwościProperties

CanGoToMatchCanGoToMatch

Obsługiwane w programie Windows PowerShell ISE 3.0 i nowszych i nie znajduje się w starszych wersjach.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

Tylko do odczytu właściwości typu Boolean wskazująca, czy karetki obok nawias, nawias kwadratowy lub klamrowy - ( ), [ ], {}.The read-only Boolean property to indicate whether the caret is next to a parenthesis, bracket, or brace - (), [], {}. Jeśli karetka znajduje się bezpośrednio przed znakiem otwierania lub bezpośrednio po znaku zamknięcia pary, a następnie wartość tej właściwości jest $true.If the caret is immediately before the opening character or immediately after the closing character of a pair, then this property value is $true. W przeciwnym razie jest $false.Otherwise, it is $false.

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

CaretColumnCaretColumn

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Właściwość tylko do odczytu, która pobiera numer kolumny, która odpowiada położeniu karetki.The read-only property that gets the column number that corresponds to the position of the caret.

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

CaretLineCaretLine

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Właściwość tylko do odczytu, która pobiera numer wiersza, który zawiera karetki.The read-only property that gets the number of the line that contains the caret.

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

CaretLineTextCaretLineText

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Właściwość tylko do odczytu, która pobiera cały wiersz tekstu, który zawiera karetki.The read-only property that gets the complete line of text that contains the caret.

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

LineCountLineCount

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Właściwość tylko do odczytu, która pobiera liczba wierszy w edytorze.The read-only property that gets the line count from the editor.

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

SelectedTextSelectedText

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Właściwość tylko do odczytu, która pobiera zaznaczony tekst w edytorze.The read-only property that gets the selected text from the editor.

Zobacz przykładowe skrypty dalszej części tego tematu.See the Scripting Example later in this topic.

TekstText

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Właściwości odczytu/zapisu, która pobiera lub ustawia tekst w edytorze.The read/write property that gets or sets the text in the editor.

Zobacz przykładowe skrypty dalszej części tego tematu.See the Scripting Example later in this topic.

Przykład skryptówScripting Example

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