Het ISEEditor-object
Een ISEEditor--object is een exemplaar van de klasse Microsoft.PowerShell.Host.ISE.ISEEditor. Het consoledeelvenster 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 lineNumber parameterwaarde 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 lijnlengte op als een geheel getal voor de regel die is opgegeven door het regelnummer.
lineNumber Het nummer van de regel waarvan u de lengte wilt bepalen.
retourneert De lijnlengte 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 $trueis, wat optreedt wanneer de caret direct voor een haakje openen, haakje of accolade - (,[,{ - of direct na een haakje sluiten, haak 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 voorbeeld van scripts verderop in dit onderwerp.
Select( startLine, startColumn, endLine, endColumn )
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Selecteert de tekst in de startLine, startColumn, endLineen endColumn parameters.
startLine - Integer De regel waar de selectie wordt gestart.
startColumn - Integer De kolom binnen de beginregel waar de selectie wordt gestart.
endLine - Integer De regel waar de selectie eindigt.
endColumn - Integer De kolom binnen de eindregel waar de selectie eindigt.
Zie het voorbeeld van scripts verderop in dit onderwerp.
SelectCaretLine()
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee selecteert u de hele 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 caretpositie 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 - Geheel getal het tekenlijnnummer.
columnNumber - Integer Het caret-kolomnummer.
# Set the CaretPosition.
$psISE.CurrentFile.Editor.SetCaretPosition(5,1)
WisselknopOutliningExpansion()
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 direct vóór het openingsteken staat of direct na het sluiten van een paar, wordt deze eigenschapswaarde $true. Anders is het $false.
# 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 aantal regels uit 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 voorbeeld van scripts verderop in dit onderwerp.
Sms
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 voorbeeld van scripts 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())
