Het ISEEditor-object
Een ISEEditor-object is een exemplaar van de klasse Microsoft.PowerShell.Host.ISE.ISEEditor. Het deelvenster Console is een ISEEditor-object . Elk ISEFile-object heeft een gekoppeld ISEEditor-object . De volgende secties bevatten de methoden en eigenschappen van een ISEEditor-object .
Methoden
Clear()
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee wist u de tekst in de editor.
# Clears the text in the Console pane.
$psISE.CurrentPowerShellTab.ConsolePane.Clear()
EnsureVisible(int lineNumber)
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Schuift door de editor zodat de lijn die overeenkomt met de opgegeven parameterwaarde lineNumber zichtbaar is. Er wordt een uitzondering gegenereerd als het opgegeven regelnummer buiten het bereik van 1,laatste regelnummer valt, waarmee de geldige regelnummers worden gedefinieerd.
lineNumber Het nummer van de regel die zichtbaar moet worden gemaakt.
# Scrolls the text in the Script pane so that the fifth line is in view.
$psISE.CurrentFile.Editor.EnsureVisible(5)
Focus()
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee stelt u de focus in op de editor.
# Sets focus to the Console pane.
$psISE.CurrentPowerShellTab.ConsolePane.Focus()
GetLineLength(int lineNumber)
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee haalt u de lengte van de lijn op als een geheel getal voor de regel die is opgegeven door het regelnummer.
lineNumber Het nummer van de regel waarvan de lengte moet worden bereikt.
Retourneert De regellengte voor de regel op het opgegeven regelnummer.
# Gets the length of the first line in the text of the Command pane.
$psISE.CurrentPowerShellTab.ConsolePane.GetLineLength(1)
GoToMatch()
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee verplaatst u de caret naar het overeenkomende teken als de eigenschap CanGoToMatch van het editorobject is$true, wat zich voordoet wanneer de caret direct vóór een haakje openen, haakje of accolade - (,[{ of direct na een haakje sluiten, haakje of accolade - ),],}. De caret wordt vóór een openingsteken of na een sluitend teken geplaatst. Als de eigenschap CanGoToMatch is $false, doet deze methode niets.
# Goes to the matching character if CanGoToMatch() is $true
$psISE.CurrentPowerShellTab.ConsolePane.GoToMatch()
InsertText( tekst )
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee vervangt u de selectie door tekst of voegt u tekst in op de huidige caretpositie.
tekst - Tekenreeks De tekst die moet worden ingevoegd.
Zie het scriptvoorbeeld verderop in dit onderwerp.
Select( startLine, startColumn, endLine, endColumn )
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Selecteert de tekst in de parameters startLine, startColumn, endLine en endColumn .
startLine - Geheel getal De regel waar de selectie wordt gestart.
startColumn - Geheel getal De kolom binnen de beginregel waar de selectie wordt gestart.
endLine - Geheel getal De regel waar de selectie eindigt.
endColumn : geheel getal De kolom binnen de eindregel waar de selectie eindigt.
Zie het scriptvoorbeeld verderop in dit onderwerp.
SelectCaretLine()
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee selecteert u de volledige tekstregel die momenteel de caret bevat.
# 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 )
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee stelt u de positie van de caret in op het regelnummer en het kolomnummer. Er wordt een uitzondering gegenereerd als het regelnummer van de caret of het kolomnummer van de caret buiten de respectieve geldige bereiken vallen.
lineNumber - Integer Het regelnummer van de caret.
columnNumber - Integer Het kolomnummer van de caret.
# Set the CaretPosition.
$psISE.CurrentFile.Editor.SetCaretPosition(5,1)
ToggleOutliningExpansion()
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee worden alle overzichtssecties uitgevouwen of samengevouwen.
# Toggle the outlining expansion
$psISE.CurrentFile.Editor.ToggleOutliningExpansion()
Eigenschappen
CanGoToMatch
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
De alleen-lezen Booleaanse eigenschap om aan te geven of de caret zich naast een haakje, haakje of accolade bevindt - (), [], . {} Als de caret zich direct vóór het openingsteken of direct na het sluiten van een paar bevindt, is $truedeze eigenschapswaarde. Anders is $falsehet .
# Test to see if the caret is next to a parenthesis, bracket, or brace
$psISE.CurrentFile.Editor.CanGoToMatch
CaretColumn
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
De eigenschap Alleen-lezen die het kolomnummer ophaalt dat overeenkomt met de positie van de caret.
# Get the CaretColumn.
$psISE.CurrentFile.Editor.CaretColumn
CaretLine
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
De eigenschap Alleen-lezen die het nummer van de regel met de caret ophaalt.
# Get the CaretLine.
$psISE.CurrentFile.Editor.CaretLine
CaretLineText
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
De eigenschap Alleen-lezen die de volledige tekstregel met de caret ophaalt.
# Get all of the text on the line that contains the caret.
$psISE.CurrentFile.Editor.CaretLineText
LineCount
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
De eigenschap Alleen-lezen waarmee het regelaantal van de editor wordt opgehaald.
# Get the LineCount.
$psISE.CurrentFile.Editor.LineCount
SelectedText
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
De eigenschap Alleen-lezen waarmee de geselecteerde tekst uit de editor wordt opgehaald.
Zie het scriptvoorbeeld verderop in dit onderwerp.
Tekst
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
De eigenschap lezen/schrijven waarmee de tekst in de editor wordt opgeslagen of ingesteld.
Zie het scriptvoorbeeld verderop in dit onderwerp.
Voorbeeld van scripting
# 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())