Oggetto ISEEditor
Un oggetto ISEEditor è un'istanza della classe Microsoft.PowerShell.Host.ISE.ISEEditor. Il riquadro della console è un oggetto ISEEditor. Ogni oggetto ISEFile ha un oggetto ISEEditor associato. Le sezioni seguenti elencano i metodi e proprietà di un oggetto ISEEditor.
Metodi
Clear()
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Cancella il testo nell'editor.
# Clears the text in the Console pane.
$psISE.CurrentPowerShellTab.ConsolePane.Clear()
EnsureVisible(int lineNumber)
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Scorre l'editor in modo che la riga che corrisponde al valore del parametro lineNumber specificato sia visibile. Genera un'eccezione se il numero di riga specificato non è compreso nell'intervallo tra 1 e l'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()
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Imposta lo stato attivo nell'editor.
# Sets focus to the Console pane.
$psISE.CurrentPowerShellTab.ConsolePane.Focus()
GetLineLength(int lineNumber )
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Ottiene la lunghezza della riga specificata dal numero di riga come valore intero.
lineNumber Numero della riga di cui ottenere la lunghezza.
Returns Lunghezza della riga in corrispondenza del numero di riga specificato.
# Gets the length of the first line in the text of the Command pane.
$psISE.CurrentPowerShellTab.ConsolePane.GetLineLength(1)
GoToMatch()
Supportato in Windows PowerShell ISE 3.0 e versioni successive e non presente nelle versioni precedenti.
Sposta il cursore sul carattere corrispondente se la proprietà CanGoToMatch dell'oggetto editor è $true, il che si verifica quando il cursore si trova immediatamente prima di una parentesi, parentesi quadra o parentesi graffa di apertura (,[,{ o immediatamente dopo una parentesi, parentesi quadra o parentesi graffa di chiusura ),],}. Il cursore viene posizionato prima di un carattere di apertura o dopo un carattere di chiusura. Se la proprietà CanGoToMatch è $false, questo metodo non esegue alcuna operazione.
# Goes to the matching character if CanGoToMatch() is $true
$psISE.CurrentPowerShellTab.ConsolePane.GoToMatch()
InsertText( text )
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Sostituisce la selezione con un testo o inserisce il testo nella posizione corrente del cursore.
text - Stringa Il testo da inserire.
Vedere Esempio di script più avanti in questo argomento.
Select( startLine, startColumn, endLine, endColumn )
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Seleziona il testo dai parametri startLine, startColumn, endLine ed endColumn.
startLine - Intero La riga in cui inizia la selezione.
startColumn - Intero La colonna all'interno della riga di inizio in cui inizia la selezione.
endLine - Intero La riga in cui termina la selezione.
endColumn - Intero La colonna all'interno della riga di fine in cui termina la selezione.
Vedere Esempio di script più avanti in questo argomento.
SelectCaretLine()
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Seleziona l'intera riga di testo che contiene attualmente il cursore.
# 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 )
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Imposta la posizione del cursore sul numero di riga e sul numero di colonna. Genera un'eccezione se il numero di riga del cursore o il numero di colonna del cursore non è compreso nei relativi intervalli validi.
lineNumber - Intero Il numero di riga del cursore.
columnNumber - Intero Il numero di colonna del cursore.
# Set the CaretPosition.
$psISE.CurrentFile.Editor.SetCaretPosition(5,1)
ToggleOutliningExpansion()
Supportato in Windows PowerShell ISE 3.0 e versioni successive e non presente nelle versioni precedenti.
Espande o comprime tutte le sezioni della struttura.
# Toggle the outlining expansion
$psISE.CurrentFile.Editor.ToggleOutliningExpansion()
Proprietà
CanGoToMatch
Supportato in Windows PowerShell ISE 3.0 e versioni successive e non presente nelle versioni precedenti.
Proprietà booleana di sola lettura che indica se il cursore si trova accanto a una parentesi, parentesi quadra o parentesi graffa (), [], {}. Se il cursore si trova immediatamente prima del carattere di apertura o immediatamente dopo il carattere di chiusura di una coppia, il valore di questa proprietà è $true. In caso contrario, è $false.
# Test to see if the caret is next to a parenthesis, bracket, or brace
$psISE.CurrentFile.Editor.CanGoToMatch
CaretColumn
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Proprietà di sola lettura che ottiene il numero di colonna che corrisponde alla posizione del cursore.
# Get the CaretColumn.
$psISE.CurrentFile.Editor.CaretColumn
CaretLine
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Proprietà di sola lettura che ottiene il numero di riga che contiene il cursore.
# Get the CaretLine.
$psISE.CurrentFile.Editor.CaretLine
CaretLineText
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Proprietà di sola lettura che ottiene la riga completa che contiene il cursore.
# Get all of the text on the line that contains the caret.
$psISE.CurrentFile.Editor.CaretLineText
LineCount
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Proprietà di sola lettura che ottiene il conteggio delle righe dall'editor.
# Get the LineCount.
$psISE.CurrentFile.Editor.LineCount
SelectedText
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Proprietà di sola lettura che ottiene il testo selezionato dall'editor.
Vedere Esempio di script più avanti in questo argomento.
Testo
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Proprietà di lettura/scrittura che ottiene o imposta il testo nell'editor.
Vedere Esempio di script più avanti in questo argomento.
Esempio di script
# 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())
