Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ein ISEEditor--Objekt ist eine Instanz der Microsoft.PowerShell.Host.ISEEditor-Klasse. Der Konsolenbereich ist ein ISEEditor--Objekt. Jedes ISEFile--Objekt verfügt über ein zugeordnetes ISEEditor--Objekt. In den folgenden Abschnitten werden die Methoden und Eigenschaften eines ISEEditor-Objekts aufgeführt.
Methodik
Clear()
Unterstützt in Windows PowerShell ISE 2.0 und höher.
Löscht den Text im Editor.
# Clears the text in the Console pane.
$psISE.CurrentPowerShellTab.ConsolePane.Clear()
EnsureVisible(int lineNumber)
Unterstützt in Windows PowerShell ISE 2.0 und höher.
Scrollt den Editor, sodass die Zeile, die dem angegebenen lineNumber Parameterwert entspricht, sichtbar ist. Es löst eine Ausnahme aus, wenn sich die angegebene Zeilennummer außerhalb des Bereichs von 1,letzte Zeilennummer befindet, wodurch die gültigen Zeilennummern definiert werden.
lineNumber Die Nummer der Zeile, die sichtbar gemacht werden soll.
# Scrolls the text in the Script pane so that the fifth line is in view.
$psISE.CurrentFile.Editor.EnsureVisible(5)
Focus()
Unterstützt in Windows PowerShell ISE 2.0 und höher.
Legt den Fokus auf den Editor fest.
# Sets focus to the Console pane.
$psISE.CurrentPowerShellTab.ConsolePane.Focus()
GetLineLength(int lineNumber)
Unterstützt in Windows PowerShell ISE 2.0 und höher.
Ruft die Zeilenlänge als ganze Zahl für die Zeile ab, die durch die Zeilennummer angegeben wird.
lineNumber Die Nummer der Zeile, deren Länge abgerufen werden soll.
Gibt Die Zeilenlänge für die Zeile an der angegebenen Zeilennummer zurück.
# Gets the length of the first line in the text of the Command pane.
$psISE.CurrentPowerShellTab.ConsolePane.GetLineLength(1)
GoToMatch()
Wird in Windows PowerShell ISE 3.0 und höher unterstützt und in früheren Versionen nicht vorhanden.
Verschiebt das Caret auf das übereinstimmende Zeichen, wenn die CanGoToMatch- Eigenschaft des Editorobjekts $trueist, was auftritt, wenn das Caret unmittelbar vor einer öffnenden Klammer, Klammer oder geschweifte Klammer liegt - (,[,{ - oder unmittelbar nach einer schließenden Klammer, Klammer oder geschweiften Klammer - ),],}. Das Caret wird vor einem öffnenden Zeichen oder nach einem schließenden Zeichen platziert. Wenn die CanGoToMatch-eigenschaft$falseist, führt diese Methode nichts aus.
# Goes to the matching character if CanGoToMatch() is $true
$psISE.CurrentPowerShellTab.ConsolePane.GoToMatch()
InsertText( text )
Unterstützt in Windows PowerShell ISE 2.0 und höher.
Ersetzt die Markierung durch Text oder fügt Text an der aktuellen Caretposition ein.
Text - Zeichenfolge Der einzufügende Text.
Weitere Informationen finden Sie im Scripting-Beispiel weiter unten in diesem Thema.
Select( startLine, startColumn, endLine, endColumn )
Unterstützt in Windows PowerShell ISE 2.0 und höher.
Markiert den Text aus dem startLine-, startColumn-, endLine-und endColumn Parameter.
startLine- - Ganze Zahl Die Zeile, in der die Auswahl beginnt.
startColumn - Ganze Zahl Die Spalte innerhalb der Startzeile, in der die Auswahl beginnt.
endLine- - Ganze Zahl Die Zeile, an der die Markierung endet.
endColumn - Ganze Zahl Die Spalte innerhalb der Endzeile, in der die Markierung endet.
Weitere Informationen finden Sie im Scripting-Beispiel weiter unten in diesem Thema.
SelectCaretLine()
Unterstützt in Windows PowerShell ISE 2.0 und höher.
Markiert die gesamte Textzeile, die derzeit das Caret enthält.
# 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 )
Unterstützt in Windows PowerShell ISE 2.0 und höher.
Legt die Caretposition an der Zeilennummer und die Spaltennummer fest. Es löst eine Ausnahme aus, wenn sich die Caretzeilennummer oder die Caretspaltennummer außerhalb der jeweiligen gültigen Bereiche befinden.
lineNumber - Ganze Zahl Die Caretzeilennummer.
columnNumber - Integer The caret column number.
# Set the CaretPosition.
$psISE.CurrentFile.Editor.SetCaretPosition(5,1)
ToggleOutliningExpansion()
Wird in Windows PowerShell ISE 3.0 und höher unterstützt und in früheren Versionen nicht vorhanden.
Bewirkt, dass alle Gliederungsabschnitte erweitert oder reduziert werden.
# Toggle the outlining expansion
$psISE.CurrentFile.Editor.ToggleOutliningExpansion()
Eigenschaften
CanGoToMatch
Wird in Windows PowerShell ISE 3.0 und höher unterstützt und in früheren Versionen nicht vorhanden.
Die schreibgeschützte boolesche Eigenschaft, die angibt, ob das Caret neben einer Klammer, Klammer oder geschweiften Klammer liegt – (), [], {}. Wenn das Caret unmittelbar vor dem öffnenden Zeichen oder unmittelbar nach dem schließenden Zeichen eines Paars liegt, wird dieser Eigenschaftswert $true. Andernfalls ist es $false.
# Test to see if the caret is next to a parenthesis, bracket, or brace
$psISE.CurrentFile.Editor.CanGoToMatch
CaretColumn
Unterstützt in Windows PowerShell ISE 2.0 und höher.
Die schreibgeschützte Eigenschaft, die die Spaltennummer abruft, die der Position des Carets entspricht.
# Get the CaretColumn.
$psISE.CurrentFile.Editor.CaretColumn
CaretLine
Unterstützt in Windows PowerShell ISE 2.0 und höher.
Die schreibgeschützte Eigenschaft, die die Nummer der Zeile abruft, die das Caret enthält.
# Get the CaretLine.
$psISE.CurrentFile.Editor.CaretLine
CaretLineText
Unterstützt in Windows PowerShell ISE 2.0 und höher.
Die schreibgeschützte Eigenschaft, die die vollständige Textzeile abruft, die das Caret enthält.
# Get all of the text on the line that contains the caret.
$psISE.CurrentFile.Editor.CaretLineText
LineCount
Unterstützt in Windows PowerShell ISE 2.0 und höher.
Die schreibgeschützte Eigenschaft, die die Zeilenanzahl aus dem Editor abruft.
# Get the LineCount.
$psISE.CurrentFile.Editor.LineCount
SelectedText
Unterstützt in Windows PowerShell ISE 2.0 und höher.
Die schreibgeschützte Eigenschaft, die den markierten Text aus dem Editor abruft.
Weitere Informationen finden Sie im Scripting-Beispiel weiter unten in diesem Thema.
Text
Unterstützt in Windows PowerShell ISE 2.0 und höher.
Die Lese-/Schreibeigenschaft, die den Text im Editor abruft oder festlegt.
Weitere Informationen finden Sie im Scripting-Beispiel weiter unten in diesem Thema.
Skriptbeispiel
# 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())
Siehe auch
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
