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