Объект 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,номер_последней_строки), определяющего диапазон допустимых номеров строк, создается исключение.
- 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
- Номер строки, длину которой требуется получить.
- Возвращаемое значение
- Длина строки, заданной параметром 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())