Un objeto ISEEditor es una instancia de la clase Microsoft.PowerShell.Host.ISE.ISEEditor. Los editores del Panel de salida y del Panel de comandos son objetos ISEEditor. Cada objeto ISEFile tiene un objeto ISEEditor asociado. En las secciones siguientes se enumeran los métodos y las propiedades de un objeto ISEEditor.

Métodos

Clear()

Borra el texto en editor.fre

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

EnsureVisible(int lineNumber)

Desplaza el editor para que la línea que corresponde al lineNumber especificado pueda verse. Produce una excepción si el lineNumber especificado está fuera del intervalo (1, último número de línea) que define el intervalo de números de línea válidos.

lineNumber
Número de la línea que va a poder verse.

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

Focus()

Establece el foco en el editor.

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

GetLineLength(int lineNumber)

Obtiene el valor entero de la longitud de la línea especificada por lineNumber.

lineNumber
Número de la línea cuya longitud se va a obtener.

Valores devueltos
Longitud de la línea correspondiente a lineNumber.

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

InsertText(string text)

Reemplaza la selección por texto o inserta texto en la posición del símbolo de intercalación actual.

text
Texto que se ha de insertar.

Vea el Scripting Example más adelante en este tema.

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

Selecciona el texto desde startLine, startColumn hasta endLine, endColumn.

startLine
Línea donde empieza la selección.

startColumn
Columna dentro de startLine donde empieza la selección.

endLine
Línea donde finaliza la selección.

endColumn
Columna dentro de endLine donde finaliza la selección.

Vea el Scripting Example más adelante en este tema.

SetCaretPosition(int lineNumber, int columnNumber)

Establece la posición del símbolo de intercalación en lineNumber y columnNumber. Produce una excepción si el lineNumber o el columnNumber están fuera de sus intervalos válidos respectivos.

lineNumber
Número de línea del símbolo de intercalación.

columnNumber
Número de columna del símbolo de intercalación.

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

Propiedades

CaretColumn

Propiedad de solo lectura que obtiene el número de columna que corresponde a la posición del símbolo de intercalación.

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

CaretLine

Propiedad de solo lectura que obtiene el número de la línea que contiene el símbolo de intercalación.

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

LineCount

Propiedad de solo lectura que obtiene el recuento de líneas para el editor.

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

SelectedText

Propiedad de solo lectura que obtiene el texto seleccionado del editor.

Vea el Scripting Example más adelante en este tema.

Text

Propiedad de lectura y escritura que obtiene el texto en el editor.

Vea el Scripting Example más adelante en este tema.

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

Vea también




Tabla de contenido