Un oggetto ISEEditor è un'istanza della classe Microsoft.PowerShell.Host.ISE.ISEEditor. Gli editor del riquadro Output e del riquadro Comando sono oggetti ISEEditor. Ogni oggetto ISEFile dispone di un oggetto ISEEditor associato. Nelle sezioni seguenti vengono elencati i metodi e le proprietà di un oggetto ISEEditor.

Metodi

Clear()

Cancella il testo in editor.fre

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

EnsureVisible(int lineNumber)

Scorre l'editor in modo che la riga corrispondente all'elemento lineNumber specificato sia visibile. Genera un'eccezione se l'elemento lineNumber specificato è fuori dall'intervallo (1, ultimo numero di riga) che definisce i numeri di riga validi.

lineNumber
Numero della riga che deve essere resa visibile.

# Scrolls the text in the Script Pane so that the fifth line is in view. 
$psIse.CurrentFile.Editor.EnsureVisible(5)

Focus()

Imposta lo stato attivo sull'editor.

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

GetLineLength(int lineNumber)

Ottiene la lunghezza della riga intera per la riga specificata da lineNumber.

lineNumber
Numero della riga di cui ottenere la lunghezza.

Valore restituito
Lunghezza della riga in corrispondenza di lineNumber.

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

InsertText(string text)

Sostituisce la selezione con testo o inserisce il testo nella posizione del punto di inserimento corrente.

text
Testo da inserire.

Vedere Scripting Example più avanti in questo argomento.

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

Seleziona il testo da startLine, startColumn per endLine, endColumn.

startLine
Riga da cui parte la selezione.

startColumn
Colonna all'interno di startLine da cui parte la selezione.

endLine
Riga in cui termina la selezione.

endColumn
Colonna all'interno di endLine in cui termina la selezione.

Vedere Scripting Example più avanti in questo argomento.

SetCaretPosition(int lineNumber, int columnNumber)

Imposta la posizione del punto di inserimento in corrispondenza di lineNumber e columnNumber. Genera un'eccezione se lineNumber o columnNumber sono all'esterno dei rispettivi intervalli validi.

lineNumber
Numero di riga del punto di inserimento.

columnNumber
Numero di colonna del punto di inserimento.

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

Proprietà

CaretColumn

Proprietà di sola lettura che ottiene il numero di colonna corrispondente alla posizione del punto di inserimento.

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

CaretLine

Proprietà di sola lettura che ottiene il numero della riga che contiene il punto di inserimento.

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

LineCount

Proprietà di sola lettura che ottiene il conteggio delle righe per l'editor.

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

SelectedText

Proprietà di sola lettura che ottiene il testo selezionato dall'editor.

Vedere Scripting Example più avanti in questo argomento.

Text

Proprietà in lettura/scrittura che ottiene il testo nell'editor.

Vedere Scripting Example più avanti in questo argomento.

Esempio di 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.
$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())

Vedere anche




Argomenti della Guida