ISEEditor 对象

ISEEditor 对象是 Microsoft.PowerShell.Host.ISE.ISEEditor 类的实例。控制台窗格是一个 ISEEditor 对象。每个 ISEFile 对象都有一个关联的 ISEEditor 对象。以下部分列出了 ISEEditor 对象的方法和属性。

方法

Clear()

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

清除编辑器中的文本。

# Clears the text in the Console pane.
$psISE.CurrentPowerShellTab.ConsolePane.Clear()

确保可见（int 行号）

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

滚动编辑器，以便与指定的 lineNumber 参数值对应的行可见。如果指定的行号超出 1,最后行号（定义有效行号）的范围，则会引发异常。

lineNumber 要显示的行号。

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

Focus()

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

将焦点设置到编辑器。

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

获取线长度（int 线号）

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

获取由行号指定的行的行长度（整数）。

lineNumber 要获取长度的行号。

返回 指定行号处的行长度。

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

GoToMatch()

在 Windows PowerShell ISE 3.0 及更高版本中受支持，但在早期版本中不存在。

如果编辑器对象的 CanGoToMatch 属性为 $true，则将脱字符号移动到匹配字符（当脱字符号位于左括号、中括号或大括号之前时，会发生这种情况 - (,[,{ - 或紧接在右括号、方括号或大括号之后 - ),],}。插入符号放置在开始字符之前或结束字符之后。如果 CanGoToMatch 属性为 $false，则此方法不执行任何操作。

# Goes to the matching character if CanGoToMatch() is $true
$psISE.CurrentPowerShellTab.ConsolePane.GoToMatch()

插入文本（文本）

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

用文本替换所选内容或在当前插入符号位置插入文本。

text - 字符串 要插入的文本。

请参阅本主题后面的脚本示例。

选择（开始行、开始列、结束行、结束列）

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

从 startLine、startColumn、endLine 和 endColumn 参数中选择文本。

startLine - 整数 选择开始的行。

startColumn - 整数 起始行内选择开始的列。

endLine - 整数 选择结束的行。

endColumn - 整数 结束行内选择结束的列。

请参阅本主题后面的脚本示例。

SelectCaretLine()

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

选择当前包含插入符号的整行文本。

# 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( 行号, 列号 )

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

设置行号和列号处的插入符号位置。如果脱字符号行号或脱字符号列号超出其各自的有效范围，则会引发异常。

lineNumber - 整数 插入符号行号。

columnNumber - 整数 插入符号列号。

# Set the CaretPosition.
$psISE.CurrentFile.Editor.SetCaretPosition(5,1)

ToggleOutliningExpansion()

在 Windows PowerShell ISE 3.0 及更高版本中受支持，但在早期版本中不存在。

导致所有轮廓部分展开或折叠。

# Toggle the outlining expansion
$psISE.CurrentFile.Editor.ToggleOutliningExpansion()

特性

可以去比赛

在 Windows PowerShell ISE 3.0 及更高版本中受支持，但在早期版本中不存在。

只读布尔属性，用于指示脱字号是否位于圆括号、中括号或大括号旁边 - ()、[]、{}。如果插入符号紧邻一对的开始字符之前或结束字符之后，则此属性值为 $true。否则，它是$false。

# Test to see if the caret is next to a parenthesis, bracket, or brace
$psISE.CurrentFile.Editor.CanGoToMatch

CaretColumn

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

只读属性，获取与插入符位置相对应的列号。

# Get the CaretColumn.
$psISE.CurrentFile.Editor.CaretColumn

CaretLine

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

只读属性，获取包含插入符号的行号。

# Get the CaretLine.
$psISE.CurrentFile.Editor.CaretLine

插入符行文本

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

获取包含插入符号的完整文本行的只读属性。

# Get all of the text on the line that contains the caret.
$psISE.CurrentFile.Editor.CaretLineText

LineCount

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

从编辑器获取行数的只读属性。

# Get the LineCount.
$psISE.CurrentFile.Editor.LineCount

SelectedText

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

从编辑器获取选定文本的只读属性。

请参阅本主题后面的脚本示例。

文本

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

获取或设置编辑器中文本的读/写属性。

请参阅本主题后面的脚本示例。

脚本示例

# 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())

参见

• ISEFile 对象
• PowerShellTab 对象
• Windows PowerShell ISE 脚本对象模型的用途
• ISE 对象模型层次结构