Um objeto ISEEditor é uma instância da classe Microsoft.PowerShell.Host.ISE.ISEEditor. O Painel de Saída e os editores de Painel de Comando são objetos ISEEditor. Cada objeto ISEFile tem um objeto ISEEditor associado. As seções seguintes listam os métodos e as propriedades de um objeto ISEEditor.
Métodos
Clear()
Limpa o texto no editor.fre
# Clears the text in the Output pane. $psIse.CurrentPowerShellTab.Output.Clear()
EnsureVisible(int lineNumber)
Rola o editor de forma que a linha que corresponde ao lineNumber especificado fique visível. Lança uma exceção se o lineNumber especificado estiver fora do intervalo (1, último número de linha) que define o intervalo de números de linha válidos.
- lineNumber
- Número da linha que deverá ficar visível.
# Scrolls the text in the Script Pane so that the fifth line is in view. $psIse.CurrentFile.Editor.EnsureVisible(5)
Focus()
Define o foco para o editor.
# Sets focus to the Output pane. $psISE.CurrentPowerShellTab.Output.Focus()
GetLineLength(int lineNumber)
Obtém o comprimento de linha de inteiro para a linha especificada por lineNumber.
- lineNumber
- Número da linha do qual obter o comprimento.
- Retorna
- O comprimento da linha referente a lineNumber.
# Gets the length of the first line in the text of the Command pane. $psIse.CurrentPowerShellTab.CommandPane.GetLineLength(1)
InsertText(string text)
Substitui a seleção com texto ou insere texto na posição do sinal de interpolação atual.
- text
- Texto para inserir.
Consulte o Scripting Example posteriormente neste tópico.
Select(int startLine, int startColumn, int endLine, int endColumn)
Seleciona o texto de startLine, startColumn para endLine, endColumn.
- startLine
- Linha onde a seleção inicia.
- startColumn
- Coluna dentro de startLine onde a seleção inicia.
- endLine
- Linha onde a seleção termina.
- endColumn
- Coluna dentro de endLine onde a seleção termina.
Consulte o Scripting Example posteriormente neste tópico.
SetCaretPosition(int lineNumber, int columnNumber)
Define a posição do sinal de interpolação em lineNumber e columnNumber. Lança uma exceção se o lineNumber ou o columnNumber estiverem fora dos respectivos intervalos válidos.
- lineNumber
- Número de linha do sinal de interpolação.
- columnNumber
- Número de coluna do sinal de interpolação.
# Set the CaretPosition. $firstfile=$psIse.CurrentFile $firstFile.Editor.SetCaretPosition(5,1)
Propriedades
CaretColumn
Propriedade somente leitura que obtém o número de coluna que corresponde à posição do sinal de interpolação.
# Get the CaretColumn. $firstfile=$psIse.CurrentFile $firstFile.Editor.CaretColumn
CaretLine
Propriedade somente leitura que obtém o número de linha que contém o sinal de interpolação.
# Get the CaretLine. $firstfile=$psIse.CurrentFile $firstFile.Editor.CaretLine
LineCount
Propriedade somente leitura que obtém a contagem de linha para o editor.
# Get the LineCount. $firstfile=$psIse.CurrentFile $firstFile.Editor.LineCount
SelectedText
Propriedade somente leitura que obtém o texto selecionado do editor.
Consulte o Scripting Example posteriormente neste tópico.
Text
Propriedade de leitura/gravação que obtém o texto no editor.
Consulte o Scripting Example posteriormente neste tópico.
Exemplo de script
# 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())
See Also