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

Объект 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( text )

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

См. также

  • Last updated on