Het Object ISEEditorThe ISEEditor Object

Een ISEEditor object is een exemplaar van de klasse Microsoft.PowerShell.Host.ISE.ISEEditor.An ISEEditor object is an instance of the Microsoft.PowerShell.Host.ISE.ISEEditor class. Het consolevenster is een ISEEditor object.The Console pane is an ISEEditor object. Elke ISEFile -object heeft een bijbehorende ISEEditor object.Each ISEFile object has an associated ISEEditor object. De volgende secties worden de methoden en eigenschappen van een ISEEditor object.The following sections list the methods and properties of an ISEEditor object.

MethodenMethods

Wissen()Clear()

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

Hiermee wist u de tekst in de editor.Clears the text in the editor.

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

EnsureVisible(int lineNumber)EnsureVisible(int lineNumber)

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

De editor schuift zodat de regel die overeenkomt met de opgegeven lineNumber parameterwaarde zichtbaar is.Scrolls the editor so that the line that corresponds to the specified lineNumber parameter value is visible. Het genereert een uitzondering als het opgegeven regelnummer valt buiten het bereik van 1, laatste regelnummer, waarmee de geldige regelnummers zijn gedefinieerd.It throws an exception if the specified line number is outside the range of 1,last line number, which defines the valid line numbers.

lineNumber het nummer van de regel die moet zichtbaar worden gemaakt.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)

Focus()Focus()

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

Hiermee stelt u de focus naar de editor.Sets the focus to the editor.

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

GetLineLength(int lineNumber)GetLineLength(int lineNumber )

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

Hiermee wordt de lengte van de als een geheel getal voor de regel die is opgegeven door het regelnummer.Gets the line length as an integer for the line that is specified by the line number.

lineNumber het nummer van de regel waarvan de lengte ophalen.lineNumber The number of the line of which to get the length.

Retourneert de lengte van de regels voor de regel aan het opgegeven regelnummer.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()

Ondersteunde Windows PowerShell ISE 3.0 en hoger, en niet aanwezig in eerdere versies.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

De caret verplaatst naar het overeenkomende teken als de CanGoToMatch eigenschap van de editor-object is $true, die wordt weergegeven wanneer de caret direct vóór een openingshaakje, een accolade of haakje - (,[, {- of direct na een sluithaakje, een accolade of haakje - ),],}.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 - ),],}. De caret wordt geplaatst voor een teken openen of na een teken sluiten.The caret is placed before an opening character or after a closing character. Als de CanGoToMatch eigenschap is $false, en vervolgens deze methode geen effect.If the CanGoToMatch property is $false, then this method does nothing.

# Test to see if the caret is next to a parenthesis, bracket, or brace.

InsertText( tekst)InsertText( text )

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

De selectie vervangen door de tekst of tekst op de huidige invoegpositie ingevoegd.Replaces the selection with text or inserts text at the current caret position.

tekst -tekenreeks van de tekst om in te voegen.text - String The text to insert.

Zie de voorbeeld Scripting verderop in dit onderwerp.See the Scripting Example later in this topic.

Selecteer( beginregel, beginkolom, eindregel, eindkolom)Select( startLine, startColumn, endLine, endColumn )

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

Hiermee selecteert u de tekst van de beginregel, beginkolom, eindregel, en eindkolom parameters.Selects the text from the startLine, startColumn, endLine, and endColumn parameters.

Beginregel -geheel getal van de regel waarbij de selectie wordt gestart.startLine - Integer The line where the selection starts.

Beginkolom -geheel getal van de kolom in de begin-regel waarbij de selectie wordt gestart.startColumn - Integer The column within the start line where the selection starts.

endLine -geheel getal van de regel waar de selectie eindigt.endLine - Integer The line where the selection ends.

eindkolom -geheel getal van de kolom in de end-regel waar de selectie eindigt.endColumn - Integer The column within the end line where the selection ends.

Zie de voorbeeld Scripting verderop in dit onderwerp.See the Scripting Example later in this topic.

SelectCaretLine()SelectCaretLine()

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

De volledige regel van de tekst die momenteel de caret bevat selecteert.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( lineNumber, columnNumber)SetCaretPosition( lineNumber, columnNumber )

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

Hiermee stelt u de invoegpositie op het regelnummer en nummer van de kolom.Sets the caret position at the line number and the column number. Het genereert een uitzondering als het regelnummer caret of het kolomnummer caret aanwezig buiten hun respectieve geldig bereiken zijn.It throws an exception if either the caret line number or the caret column number are out of their respective valid ranges.

lineNumber -Integer het regelnummer caret.lineNumber - Integer The caret line number.

columnNumber -het kolomnummer caret geheel getal zijn.columnNumber - Integer The caret column number.

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

ToggleOutliningExpansion()ToggleOutliningExpansion()

Ondersteunde Windows PowerShell ISE 3.0 en hoger, en niet aanwezig in eerdere versies.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

Zorgt ervoor dat alle overzichtssecties wilt uitvouwen of samenvouwen.Causes all the outline sections to expand or collapse.

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

EigenschappenProperties

CanGoToMatchCanGoToMatch

Ondersteunde Windows PowerShell ISE 3.0 en hoger, en niet aanwezig in eerdere versies.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

De alleen-lezen Boole-eigenschap om aan te geven of de caret naast een haakje-openen, een accolade of haakje - ( ), [ ], {}.The read-only Boolean property to indicate whether the caret is next to a parenthesis, bracket, or brace - (), [], {}. Als de caret direct vóór het teken dat openen of direct na het teken van het sluiten van een paar, wordt de waarde van deze eigenschap $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. Anders is de $false.Otherwise, it is $false.

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

CaretColumnCaretColumn

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

De alleen-lezen eigenschap die het kolomnummer opgehaald die overeenkomt met de positie van de caret.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

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

De alleen-lezen eigenschap die het nummer van de regel met de caret opgehaald.The read-only property that gets the number of the line that contains the caret.

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

CaretLineTextCaretLineText

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

De alleen-lezen eigenschap die de volledige regel van de tekst waarin de caret opgehaald.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

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

De alleen-lezen eigenschap die het aantal regels opgehaald van de editor.The read-only property that gets the line count from the editor.

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

SelectedTextSelectedText

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

De alleen-lezen eigenschap die de geselecteerde tekst opgehaald van de editor.The read-only property that gets the selected text from the editor.

Zie de voorbeeld Scripting verderop in dit onderwerp.See the Scripting Example later in this topic.

TekstText

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

De eigenschap lezen/schrijven die opgehaald of ingesteld van de tekst in de editor.The read/write property that gets or sets the text in the editor.

Zie de voorbeeld Scripting verderop in dit onderwerp.See the Scripting Example later in this topic.

Voorbeeld ScriptingScripting 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())

Zie ookSee Also