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,마지막 줄 번호 범위를 벗어나면 예외가 throw됩니다.
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 이상에서 지원됩니다.
선택 영역을 텍스트로 바꾸거나 현재 캐리트 위치에 텍스트를 삽입합니다.
text - 문자열 삽입할 텍스트입니다.
이 항목의 뒷부분에 나오는 스크립팅 예제를 참조하세요.
Select( startLine, startColumn, endLine, endColumn )
Windows PowerShell ISE 2.0 이상에서 지원됩니다.
startLine, startColumn, endLine 및 endColumn 매개 변수에서 텍스트를 선택합니다.
startLine - 정수 선택 영역이 시작되는 줄입니다.
startColumn - 정수 선택 영역이 시작되는 시작 줄 내의 열입니다.
endLine - Integer 선택이 끝나는 줄입니다.
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 이상에서 지원됩니다.
줄 번호 및 열 번호로 캐럿 위치를 설정합니다. 캐럿 줄 번호 또는 캐럿 열 번호가 각각의 유효한 범위를 벗어나는 경우 예외를 throw합니다.
lineNumber - Integer 캐리트 줄 번호입니다.
columnNumber - Integer 캐리트 열 번호입니다.
# 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 이상에서 지원되며, 이전 버전에는 없습니다.
caret가 괄호, 대괄호 또는 중괄호 ()[]{}옆에 있는지 여부를 나타내는 읽기 전용 부울 속성입니다. 캐리트가 여는 문자 바로 앞에 있거나 쌍의 닫는 문자 바로 뒤인 경우 이 속성 값은 다음과 같습니다 $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 이상에서 지원됩니다.
caret의 위치에 해당하는 열 번호를 가져오는 읽기 전용 속성입니다.
# Get the CaretColumn.
$psISE.CurrentFile.Editor.CaretColumn
CaretLine
Windows PowerShell ISE 2.0 이상에서 지원됩니다.
caret를 포함하는 줄의 수를 가져오는 읽기 전용 속성입니다.
# 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 이상에서 지원됩니다.
편집기에서 선택한 텍스트를 가져오는 읽기 전용 속성입니다.
이 항목의 뒷부분에 나오는 스크립팅 예제를 참조하세요.
Text
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())
참고 항목
PowerShell