Поделиться через

Объект ISEEditor

  • Статья

Объект is ISEEditor является экземпляром класса Microsoft.PowerShell.Host.ISE.ISEEditor. Панель консоли — это объект ISEEditor. Каждый объект ISEFile имеет связанный объект ISEEditor. В следующих разделах перечислены методы и свойства объекта ISEEditor.

Методика

Clear()

Поддерживается в среде сценариев Windows PowerShell 2.0 и более поздних версий.

Очищает текст в редакторе.

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

EnsureVisible(int lineNumber)

Поддерживается в среде сценариев Windows PowerShell 2.0 и более поздних версий.

Прокручивает редактор, чтобы строка, соответствующая указанному строкового значения параметра. Он создает исключение, если указанный номер строки находится за пределами диапазона 1,последней строки, который определяет допустимые номера строк.

номер строки Число строк, которые должны быть видимы.

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

Фокус()

Поддерживается в среде сценариев Windows PowerShell 2.0 и более поздних версий.

Задает фокус в редакторе.

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

GetLineLength(int lineNumber)

Поддерживается в среде сценариев Windows PowerShell 2.0 и более поздних версий.

Возвращает длину строки в виде целого числа для строки, указанной номером строки.

номер строки Число строк, из которых требуется получить длину.

Возвращает длину строки для строки по указанному номеру строки.

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

GoToMatch()

Поддерживается в среде СЦЕНАРИЕв Windows PowerShell 3.0 и более поздних версий, но не присутствует в более ранних версиях.

Перемещает курсор на соответствующий символ, если свойство CanGoToMatch объекта редактора $true, которое происходит непосредственно перед открывающей скобкой, скобкой или скобкой - (,[,{ - или сразу после закрывающей скобки, скобки или скобки - ),],}. Курсор помещается перед открывающим символом или после закрывающего символа. Если свойство CanGoToMatch$false, то этот метод ничего не делает.

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

InsertText( текст )

Поддерживается в среде сценариев Windows PowerShell 2.0 и более поздних версий.

Заменяет выделение текстом или вставляет текст в текущее положение курсора.

текст — строка вставленного текста.

См. пример скриптов далее в этом разделе.

Select( startLine, startColumn, endLine, endColumn )

Поддерживается в среде сценариев Windows PowerShell 2.0 и более поздних версий.

Выбирает текст из startLine, startColumn, endLineи параметры endColumn.

startLine — целое число строки, в которой начинается выделение.

startColumn — целое число столбца в начальной строке, в которой начинается выделение.

endLine — целое число строки, в которой заканчивается выделение.

endColumn — целое число столбца в конечной строке, в которой заканчивается выделение.

См. пример скриптов далее в этом разделе.

SelectCaretLine()

Поддерживается в среде сценариев Windows PowerShell 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 2.0 и более поздних версий.

Задает положение курсора по номеру строки и номеру столбца. Он создает исключение, если номер строки или номер столбца курсора выходит за пределы допустимых диапазонов.

lineNumber — целочисленное число строки всплывающего значения.

columnNumber — целочисленное число столбца в соответствии с числом столбцов.

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

ToggleOutliningExpansion()

Поддерживается в среде СЦЕНАРИЕв Windows PowerShell 3.0 и более поздних версий, но не присутствует в более ранних версиях.

Вызывает развертывание или свертывание всех разделов структуры.

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

Свойства

CanGoToMatch

Поддерживается в среде СЦЕНАРИЕв Windows PowerShell 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 2.0 и более поздних версий.

Свойство только для чтения, которое получает номер столбца, соответствующий позиции курсора.

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

CaretLine

Поддерживается в среде сценариев Windows PowerShell 2.0 и более поздних версий.

Свойство только для чтения, которое получает номер строки, содержащей курсор.

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

CaretLineText

Поддерживается в среде сценариев Windows PowerShell 2.0 и более поздних версий.

Свойство только для чтения, которое получает полную строку текста, содержащую курсор.

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

LineCount

Поддерживается в среде сценариев Windows PowerShell 2.0 и более поздних версий.

Свойство только для чтения, которое получает количество строк из редактора.

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

SelectedText

Поддерживается в среде сценариев Windows PowerShell 2.0 и более поздних версий.

Свойство только для чтения, которое получает выделенный текст из редактора.

См. пример скриптов далее в этом разделе.

СМС

Поддерживается в среде сценариев Windows PowerShell 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())

См. также