Ein ISEEditor-Objekt ist eine Instanz der Microsoft.PowerShell.Host.ISE.ISEEditor-Klasse. Der Ausgabebereich-Editor und der Befehlsbereich-Editor sind ISEEditor-Objekte. Jedem ISEFile-Objekt ist ein ISEEditor-Objekt zugeordnet. In den folgenden Abschnitten werden die Methoden und Eigenschaften eines ISEEditor-Objekts aufgeführt.

Methoden

Clear()

Löscht den Text im Editor. 

# Clears the text in the Output pane.
$psIse.CurrentPowerShellTab.Output.Clear()

EnsureVisible (int lineNumber)

Führt einen Bildlauf im Editor durch, damit die Zeile, die der angegebenen lineNumber entspricht, sichtbar ist. Eine Ausnahme wird ausgelöst, wenn sich die angegebene lineNumber außerhalb des Intervalls (1, letzte Zeilennummer) befindet, das den Bereich gültiger Zeilennummern definiert.

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

Verschiebt den Fokus auf den Editor. 

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

GetLineLength (int lineNumber)

Ruft die Zeilenlänge für die von lineNumber angegebene Zeile als ganze Zahl ab.

lineNumber
Die Nummer der Zeile, deren Länge abgerufen werden soll.

Rückgabe
Die Zeilenlänge für die Zeile mit der angegebenen lineNumber. 

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

InsertText(string text)

Ersetzt die Auswahl durch Text, oder fügt an der aktuellen Position der Einfügemarke Text ein.

text
Der Text, der eingefügt werden soll.

Siehe das Scripting Example weiter unten in diesem Thema.

Select(int startLine, int startColumn, int endLine, int endColumn)

Wählt den Text von startLine, startColumn bis endLine, endColumn aus.

startLine
Die Zeile, in der die Auswahl beginnt.

startColumn
Die Spalte in startLine, in der die Auswahl beginnt.

endLine
Die Zeile, in der die Auswahl endet.

endColumn
Die Spalte in endLine, in der die Auswahl endet.

Siehe das Scripting Example weiter unten in diesem Thema.

SetCaretPosition(int lineNumber, int columnNumber)

Legt die Position der Einfügemarke bei lineNumber und columnNumber fest. Es wird eine Ausnahme ausgelöst, wenn sich die lineNumber oder die columnNumber außerhalb des jeweils gültigen Bereichs befindet.

lineNumber
Die Zeilennummer des Caretzeichens.

columnNumber
Die Spaltennummer des Caretzeichens.

# Set the CaretPosition.
$firstfile=$psIse.CurrentFile
$firstFile.Editor.SetCaretPosition(5,1)

Eigenschaften

CaretColumn

Schreibgeschützte Eigenschaft, die die Spaltennummer abruft, die der Position des Caretzeichens entspricht. 

# Get the CaretColumn.
$firstfile=$psIse.CurrentFile
$firstFile.Editor.CaretColumn

CaretLine

Schreibgeschützte Eigenschaft, die die Nummer der Zeile abruft, die das Caretzeichen enthält.

# Get the CaretLine.
$firstfile=$psIse.CurrentFile
$firstFile.Editor.CaretLine

LineCount

Schreibgeschützte Eigenschaft, die die Zeilenanzahl für den Editor abruft.

# Get the LineCount.
$firstfile=$psIse.CurrentFile
$firstFile.Editor.LineCount

SelectedText

Schreibgeschützte Eigenschaft, die den markierten Text vom Editor abruft.

Siehe das Scripting Example weiter unten in diesem Thema.

Text

Eigenschaft mit Lese-/Schreibzugriff, die den Text im Editor abruft.

Siehe das Scripting Example weiter unten in diesem Thema.

Beispielskript 

# This illustrates how you can use the length of a line to select the entire line and shows how you can make it lowercase.
$myfile=$psIse.CurrentFile
# Start with clearing the text in the current file editor.
$myfile.Editor.Clear()

# Make sure the file has at least two lines of text.
$myfile.Editor.InsertText("LINE1 `n")
$myfile.Editor.InsertText("LINE2 `n")
$myfile.Editor.InsertText("LINE3 `n")
$myfile.Editor.InsertText("LINE4 `n")
$myfile.Editor.InsertText("LINE5 `n")

# You can use the GetLineLength method to get the length of the third line. 
$endColumn= $myfile.Editor.GetLineLength(3)
# Select the text in the first three lines.
$myfile.Editor.Select(1,1,3,$endColumn + 1)
$selection = $myfile.Editor.SelectedText
# Clear all the text in the editor.
$myfile.Editor.Clear()
# Add the selected text back, but in lower case.
$myFile.Editor.InsertText($selection.ToLower())

Siehe auch



Inhaltsverzeichnis