Oggetto ISEEditor
Un oggetto ISEEditor è un'istanza della classe Microsoft.PowerShell.Host.ISE.ISEEditor. Il riquadro Console è un oggetto ISEEditor. A ogni oggetto ISEFile è associato un oggetto ISEEditor. Nelle sezioni seguenti sono elencati i metodi e le 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 sia visibile la riga corrispondente al valore di lineNumber parametro specificato. Genera un'eccezione se il numero di riga specificato non è compreso nell'intervallo di 1,ultimo numero di riga, che definisce i numeri di riga validi.
lineNumber Numero della riga da rendere 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 sull'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 come numero intero per la riga specificata dal numero di riga.
lineNumber Numero della riga di cui ottenere la lunghezza.
Restituisce 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, che si verifica quando il cursore si trova immediatamente prima di una parentesi aperta, una parentesi quadre o una parentesi graffa - (,[,{ - o immediatamente dopo una parentesi chiusa, parentesi quadre o parentesi graffe - ),],}. 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 testo o inserisce testo nella posizione corrente del cursore.
testo - Stringa Testo da inserire.
Vedere esempio di scripting più avanti in questo argomento.
Select( startLine, startColumn, endLine, endColumn )
Supportato in Windows PowerShell ISE 2.0 e versioni successive.
Seleziona il testo dal startLine, startColumn, endLinee parametri endColumn.
startLine - Intero Riga in cui inizia la selezione.
startColumn - Intero La colonna all'interno della riga iniziale in cui inizia la selezione.
endLine - Intero Riga in cui termina la selezione.
endColumn - Intero Colonna all'interno della riga finale in cui termina la selezione.
Vedere esempio di scripting 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 in corrispondenza del numero di riga e del numero di colonna. Genera un'eccezione se il numero di riga del cursore o il numero di colonna del cursore non sono compresi nei rispettivi intervalli validi.
lineNumber - Numero intero La riga del cursore.
columnNumber - Intero 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.
Fa sì che tutte le sezioni della struttura si espandono o comprimano.
# 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 per indicare se il cursore è accanto a parentesi, parentesi quadre o parentesi graffe, (), [], {}. Se il cursore è immediatamente prima del carattere di apertura o immediatamente dopo il carattere di chiusura di una coppia, questo valore della proprietà viene $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 della riga contenente 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 di testo completa contenente 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 scripting 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 scripting 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.
# 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())
