ISEEditor 对象是 Microsoft.PowerShell.Host.ISE.ISEEditor 类的一个实例。输出窗格和命令窗格编辑器便是 ISEEditor 对象。每个 ISEFile 对象都有一个与之关联的 ISEEditor 对象。以下各节列出了 ISEEditor 对象的方法和属性。
方法
Clear()
清除 editor.fre 中的文本
# Clears the text in the Output pane. $psIse.CurrentPowerShellTab.Output.Clear()
EnsureVisible(int lineNumber)
滚动编辑器，以使与指定的 lineNumber 对应的行可见。如果指定的 lineNumber 超出定义有效行号范围的间隔 (1,last line number)，则将引发异常。
- lineNumber
- 要可见的行的编号。
# Scrolls the text in the Script Pane so that the fifth line is in view. $psIse.CurrentFile.Editor.EnsureVisible(5)
Focus()
将焦点设置在编辑器上。
# Sets focus to the Output pane. $psISE.CurrentPowerShellTab.Output.Focus()
GetLineLength(int lineNumber)
获取 lineNumber 所指定行的整数行长度。
- lineNumber
- 要获取其长度的行的编号。
- Returns
- 位于 lineNumber 的行的行长度。
# Gets the length of the first line in the text of the Command pane. $psIse.CurrentPowerShellTab.CommandPane.GetLineLength(1)
InsertText(string text)
用文本替换所选内容或在当前插入符号位置插入文本。
- text
- 要插入的文本。
请参阅本主题后面的Scripting Example。
Select(int startLine, int startColumn, int endLine, int endColumn)
选择从 startLine、startColumn 到 endLine、endColumn 的文本。
- startLine
- 所选内容的起始行。
- startColumn
- startLine 内所选内容的起始列。
- endLine
- 所选内容的结束行。
- endColumn
- endLine 内所选内容的结束列。
请参阅本主题后面的Scripting Example。
SetCaretPosition(int lineNumber, int columnNumber)
在 lineNumber 和 columnNumber 所确定的位置处设置插入符号位置。如果 lineNumber 或 columnNumber 超出各自的有效范围，则将引发异常。
- lineNumber
- 插入符号的行号。
- columnNumber
- 插入符号的列号。
# Set the CaretPosition. $firstfile=$psIse.CurrentFile $firstFile.Editor.SetCaretPosition(5,1)
属性
CaretColumn
只读属性，用于获取与插入符号位置对应的列号。
# Get the CaretColumn. $firstfile=$psIse.CurrentFile $firstFile.Editor.CaretColumn
CaretLine
只读属性，用于获取包含插入符号的行的编号。
# Get the CaretLine. $firstfile=$psIse.CurrentFile $firstFile.Editor.CaretLine
LineCount
只读属性，用于获取编辑器的行计数。
# Get the LineCount. $firstfile=$psIse.CurrentFile $firstFile.Editor.LineCount
SelectedText
只读属性，用于从编辑器中获取选定文本。
请参阅本主题后面的Scripting Example。
Text
读/写属性，用于从编辑器中获取文本。
请参阅本主题后面的Scripting Example。
脚本示例
# 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())
另请参阅