El objeto ISEEditor
Un objeto ISEEditor es una instancia de la clase Microsoft.PowerShell.Host.ISE.ISEEditor. El panel de consola es un objeto ISEEditor. Cada objeto ISEFile tiene asociado un objeto ISEEditor. En las secciones siguientes se enumeran los métodos y las propiedades de un objeto ISEEditor.
Métodos
Clear()
Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.
Borra el texto en el editor.
# Clears the text in the Console pane.
$psISE.CurrentPowerShellTab.ConsolePane.Clear()
EnsureVisible(int númeroDeLínea)
Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.
Desplaza el editor de modo que la línea que corresponde al valor del parámetro lineNumber especificado está visible. Produce una excepción si el número de línea especificado está fuera del intervalo de 1, último número de línea, que define los números de línea válidos.
lineNumber Número de la línea que se debe hacer visible.
# Scrolls the text in the Script pane so that the fifth line is in view.
$psISE.CurrentFile.Editor.EnsureVisible(5)
Focus()
Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.
Establece el foco en el editor.
# Sets focus to the Console pane.
$psISE.CurrentPowerShellTab.ConsolePane.Focus()
GetLineLength(int númeroDeLínea )
Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.
Obtiene la longitud de línea como un entero de la línea especificada por el número de línea.
lineNumber Número de la línea de la que se obtendrá la longitud.
Returns Longitud de la línea que corresponde al número de línea especificado.
# Gets the length of the first line in the text of the Command pane.
$psISE.CurrentPowerShellTab.ConsolePane.GetLineLength(1)
GoToMatch()
Se admite en Windows PowerShell ISE 3.0 y versiones posteriores y no está presente en las versiones anteriores.
Mueve el símbolo de intercalación al carácter coincidente si la propiedad CanGoToMatch del objeto del editor es $true, lo que ocurre cuando el símbolo de intercalación está inmediatamente antes de un paréntesis, corchete o llave de apertura ((,[,{) o inmediatamente después de un paréntesis, corchete o llave de cierre: ),],}. El símbolo de intercalación se coloca delante de un carácter de apertura o después de un carácter de cierre. Si la propiedad CanGoToMatch es $false, el método no hace nada.
# Goes to the matching character if CanGoToMatch() is $true
$psISE.CurrentPowerShellTab.ConsolePane.GoToMatch()
InsertText( texto )
Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.
Reemplaza la selección por texto o inserta texto en la posición del símbolo de intercalación actual.
text (cadena); el texto que se inserta.
Vea Ejemplo de scripting más adelante en este tema.
Select( líneaInicial, columnaInicial, líneaFinal, columnaFinal )
Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.
Selecciona el texto de los parámetros startLine, startColumn, endLine y endColumn.
startLine (entero); la línea donde comienza la selección.
startColumn (entero); la columna de la línea de inicio en que comienza la selección.
endLine (entero); la línea en que acaba la selección.
endColumn (entero); la columna de la línea de fin en que acaba la selección.
Vea Ejemplo de scripting más adelante en este tema.
SelectCaretLine()
Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.
Selecciona toda la línea de texto que contiene actualmente el símbolo de intercalación.
# 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( númeroDeLínea, númeroDeColumna )
Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.
Establece la posición del símbolo de intercalación en el número de línea y el número de columna. Produce una excepción si el número de línea del símbolo de intercalación o el número de columna del símbolo de intercalación están fuera de sus intervalos válidos respectivos.
lineNumber (entero); el número de línea del símbolo de intercalación.
columnNumber (entero); el número de columna del símbolo de intercalación.
# Set the CaretPosition.
$psISE.CurrentFile.Editor.SetCaretPosition(5,1)
ToggleOutliningExpansion()
Se admite en Windows PowerShell ISE 3.0 y versiones posteriores y no está presente en las versiones anteriores.
Hace que todas las secciones de esquema se expandan o se contraigan.
# Toggle the outlining expansion
$psISE.CurrentFile.Editor.ToggleOutliningExpansion()
Propiedades
CanGoToMatch
Se admite en Windows PowerShell ISE 3.0 y versiones posteriores y no está presente en las versiones anteriores.
Propiedad booleana de solo lectura que indica si el símbolo de intercalación está al lado de paréntesis, corchetes o llaves: (), [], {}. Si el símbolo de intercalación está inmediatamente antes del carácter de apertura o inmediatamente después del carácter de cierre de un par, el valor de esta propiedad es $true. De lo contrario, es $false.
# Test to see if the caret is next to a parenthesis, bracket, or brace
$psISE.CurrentFile.Editor.CanGoToMatch
CaretColumn
Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.
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.
$psISE.CurrentFile.Editor.CaretColumn
CaretLine
Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.
Propiedad de solo lectura que obtiene el número de la línea que contiene el símbolo de intercalación.
# Get the CaretLine.
$psISE.CurrentFile.Editor.CaretLine
CaretLineText
Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.
Propiedad de solo lectura que obtiene la línea de texto completa que contiene el símbolo de intercalación.
# Get all of the text on the line that contains the caret.
$psISE.CurrentFile.Editor.CaretLineText
LineCount
Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.
Propiedad de solo lectura que obtiene el recuento de líneas del editor.
# Get the LineCount.
$psISE.CurrentFile.Editor.LineCount
SelectedText
Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.
Propiedad de solo lectura que obtiene el texto seleccionado del editor.
Vea Ejemplo de scripting más adelante en este tema.
Texto
Se admite en Windows PowerShell ISE 2.0 y versiones posteriores.
Propiedad de lectura y escritura que obtiene o establece el texto en el editor.
Vea Ejemplo de scripting 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.
# 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())
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de