Condividi tramite

L'Oggetto ISEEditor

Un oggetto ISEEditor è un'istanza della classe Microsoft.PowerShell.Host.ISE.ISEEditor. Il pannello Console è un oggetto ISEEditor . Ogni oggetto ISEFile ha un oggetto ISEEditor associato. Le sezioni seguenti elencano i metodi e le proprietà di un oggetto ISEEditor .

Methods

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 corrispondente al valore specificato del parametro lineNumber sia visibile. Fa un'eccezione se il numero di riga specificato è fuori dall'intervallo di 1, ultimo numero di riga, che definisce i numeri di riga validi.

  • Numero di linea - Il 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.

Mette l'attenzione 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 intero per la retta specificata dal numero della linea.

  • lineNumber - Il numero della linea di cui ottenere la lunghezza.
  • Ritorni - La lunghezza della linea al 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 successivi, e non presente nelle versioni precedenti.

Sposta il caret al carattere corrispondente se la proprietà CanGoToMatch dell'oggetto editor è $true, che avviene quando il caret è immediatamente prima di una parentesi, bracket o cornice di apertura

  • (,[,{ - o subito dopo una parentesi chiusa, parentesi o cornice - ),],}. Il caret viene posizionato davanti a un carattere di apertura o dopo un carattere di chiusura. Se la proprietà CanGoToMatch è $false, allora questo metodo non fa nulla.
# 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 attuale del caret.

  • testo - Stringa - Il testo da inserire.

Vedi l'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 dai parametri startLine, startColumn, endLine e endColumn .

  • startLine - Intero - La linea da cui inizia la selezione.
  • startColumn - Integer - La colonna all'interno della linea di inizio da cui inizia la selezione.
  • endLine - Intero - La linea in cui termina la selezione.
  • endColumn - Integer - La colonna all'interno della linea finale dove termina la selezione.

Vedi l'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 attualmente contiene la carezza.

# 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 caret al numero della linea e al numero della colonna. Fa un'eccezione se il numero della linea del caret o il numero della colonna del caret sono fuori dai rispettivi intervalli validi.

  • Numero di linea - Intero - Il numero di linea del caret.
  • colonNumber - Intero - Il numero della colonna del caret.
# Set the CaretPosition.
$psISE.CurrentFile.Editor.SetCaretPosition(5,1)

ToggleOutliningExpansion()

Supportato in Windows PowerShell ISE 3.0 e successivi, e non presente nelle versioni precedenti.

Fa espandere o collassare tutte le sezioni di contorno.

# Toggle the outlining expansion
$psISE.CurrentFile.Editor.ToggleOutliningExpansion()

Proprietà

CanGoToMatch

Supportato in Windows PowerShell ISE 3.0 e successivi, e non presente nelle versioni precedenti.

La proprietà booleana di sola lettura indica se il caret si trova accanto a una parentesi, una parentesi o una cornice - (), [], {}. Se il caret è immediatamente prima del carattere di apertura o immediatamente dopo il carattere di chiusura di una coppia, allora questo valore di 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.

La proprietà di sola lettura che ottiene il numero di colonna corrispondente alla posizione del caretto.

# Get the CaretColumn.
$psISE.CurrentFile.Editor.CaretColumn

CaretLine

Supportato in Windows PowerShell ISE 2.0 e versioni successive.

La proprietà di sola lettura che ottiene il numero della riga che contiene il caratt.

# Get the CaretLine.
$psISE.CurrentFile.Editor.CaretLine

CaretLineText

Supportato in Windows PowerShell ISE 2.0 e versioni successive.

La proprietà di sola lettura che ottiene la riga completa di testo che contiene il caratt.

# 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.

La 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.

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

Vedi l'esempio di scripting più avanti in questo argomento.

Testo

Supportato in Windows PowerShell ISE 2.0 e versioni successive.

La proprietà di lettura/scrittura che ottiene o imposta il testo nell'editor.

Vedi l'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())

Vedere anche

  • Last updated on