ISEEditor オブジェクトは Microsoft.PowerShell.Host.ISE.ISEEditor クラスのインスタンスです。出力ペインおよびコマンド ペインのエディターは ISEEditor オブジェクトです。ISEFile オブジェクトには、それぞれ ISEEditor オブジェクトが関連付けられています。次の各セクションで、ISEEditor オブジェクトのメソッドおよびプロパティについて説明します。
メソッド
Clear()
エディターのテキストをクリアします。
# Clears the text in the Output pane. $psIse.CurrentPowerShellTab.Output.Clear()
EnsureVisible(int lineNumber)
指定された lineNumber に対応する行が見えるまでエディターをスクロールします。有効な行番号の範囲内 (1 ～最終行番号) にない値が lineNumber に指定された場合は、例外がスローされます。
- 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 で置き換えます。または、現在のカーソル位置に 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())
関連項目