通过

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

EnsureVisible（int lineNumber）

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

GetLineLength（int lineNumber ）

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

InsertText（文本）

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

将所选内容替换为文本或在当前插入点位置插入文本。

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

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

Select（startLine、startColumn、endLine、endColumn）

在 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（lineNumber，columnNumber）

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

性能

CanGoToMatch

在 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

CaretLineText

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

另请参阅