ISEEditor 개체The ISEEditor Object

ISEEditor 개체는 Microsoft.PowerShell.Host.ISE.ISEEditor 클래스의 인스턴스입니다.An ISEEditor object is an instance of the Microsoft.PowerShell.Host.ISE.ISEEditor class. 콘솔 창은 ISEEditor 개체입니다.The Console pane is an ISEEditor object. ISEFile 개체에는 연결된 ISEEditor 개체가 있습니다.Each ISEFile object has an associated ISEEditor object. 다음 섹션에는 ISEEditor 개체의 메서드 및 속성이 나열됩니다.The following sections list the methods and properties of an ISEEditor object.

메서드Methods

Clear()Clear()

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

편집기에서 텍스트를 지웁니다.Clears the text in the editor.

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

EnsureVisible(int lineNumber)EnsureVisible(int lineNumber)

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

지정된 lineNumber 매개 변수 값에 해당하는 줄이 표시되도록 편집기를 스크롤합니다.Scrolls the editor so that the line that corresponds to the specified lineNumber parameter value is visible. 지정된 줄 번호가 유효한 줄 번호를 정의하는 마지막 줄 번호인 1의 범위 밖에 있는 경우 예외를 throw합니다.It throws an exception if the specified line number is outside the range of 1,last line number, which defines the valid line numbers.

lineNumber 표시할 줄의 수입니다.lineNumber The number of the line that is to be made visible.

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

Focus()Focus()

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

포커스를 편집기로 설정합니다.Sets the focus to the editor.

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

GetLineLength(int lineNumber )GetLineLength(int lineNumber )

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

줄 번호로 지정된 줄에 대한 정수 줄 길이를 가져옵니다.Gets the line length as an integer for the line that is specified by the line number.

lineNumber 길이를 가져올 줄의 번호입니다.lineNumber The number of the line of which to get the length.

Returns 지정된 줄 번호의 줄에 대한 줄 길이입니다.Returns The line length for the line at the specified line number.

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

GoToMatch()GoToMatch()

Windows PowerShell ISE 3.0 이상에서 지원되며, 이전 버전에는 없습니다.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

편집기 개체의 CanGoToMatch 속성이 $true인 경우, 캐럿을 일치하는 문자로 이동합니다. 캐럿이 여는 괄호, 대괄호 또는 중괄호 (,[,{ 바로 앞에 있거나 닫는 괄호, 대괄호 또는 중괄호 ),],} 바로 뒤에 있을 때 이런 일이 발생합니다.Moves the caret to the matching character if the CanGoToMatch property of the editor object is $true, which occurs when the caret is immediately before an opening parenthesis, bracket, or brace - (,[,{ - or immediately after a closing parenthesis, bracket, or brace - ),],}. 캐럿은 여는 문자가 앞이나 닫는 문자 뒤에 배치됩니다.The caret is placed before an opening character or after a closing character. CanGoToMatch 속성이 $false라면, 이 메서드는 아무 작업도 수행하지 않습니다.If the CanGoToMatch property is $false, then this method does nothing.

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

InsertText( text )InsertText( text )

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

선택 영역을 텍스트로 바꾸거나, 현재 캐럿 위치에 텍스트를 삽입합니다.Replaces the selection with text or inserts text at the current caret position.

text - String 삽입할 텍스트입니다.text - String The text to insert.

이 항목의 뒷부분에 나오는 스크립팅 예제를 참조하세요.See the Scripting Example later in this topic.

Select( startLine, startColumn, endLine, endColumn )Select( startLine, startColumn, endLine, endColumn )

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

startLine, startColumn, endLineendColumn 매개 변수에서 텍스트를 선택합니다.Selects the text from the startLine, startColumn, endLine, and endColumn parameters.

startLine - Integer 선택이 시작되는 줄입니다.startLine - Integer The line where the selection starts.

startColumn - Integer 선택이 시작되는 시작 줄 내의 열입니다.startColumn - Integer The column within the start line where the selection starts.

endLine - Integer 선택이 끝나는 줄입니다.endLine - Integer The line where the selection ends.

endColumn - Integer 선택이 끝나는 끝 줄 내의 열입니다.endColumn - Integer The column within the end line where the selection ends.

이 항목의 뒷부분에 나오는 스크립팅 예제를 참조하세요.See the Scripting Example later in this topic.

SelectCaretLine()SelectCaretLine()

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

현재 캐럿을 포함하는 텍스트의 전체 줄을 선택합니다.Selects the entire line of text that currently contains the caret.

# 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 )SetCaretPosition( lineNumber, columnNumber )

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

줄 번호 및 열 번호로 캐럿 위치를 설정합니다.Sets the caret position at the line number and the column number. 캐럿 줄 번호 또는 캐럿 열 번호가 각각의 유효한 범위를 벗어나는 경우 예외를 throw합니다.It throws an exception if either the caret line number or the caret column number are out of their respective valid ranges.

lineNumber - Integer 캐럿 줄 번호입니다.lineNumber - Integer The caret line number.

columnNumber - Integer 캐럿 열 번호입니다.columnNumber - Integer The caret column number.

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

ToggleOutliningExpansion()ToggleOutliningExpansion()

Windows PowerShell ISE 3.0 이상에서 지원되며, 이전 버전에는 없습니다.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

모든 개요 섹션을 확장하거나 축소합니다.Causes all the outline sections to expand or collapse.

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

속성Properties

CanGoToMatchCanGoToMatch

Windows PowerShell ISE 3.0 이상에서 지원되며, 이전 버전에는 없습니다.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

캐럿이 괄호, 대괄호 또는 중괄호((), [], {}) 옆에 있는지 여부를 나타내는 읽기 전용 부울 속성입니다.The read-only Boolean property to indicate whether the caret is next to a parenthesis, bracket, or brace - (), [], {}. 캐럿이 여는 문자의 바로 앞 또는 닫는 문자 바로 뒤에 있다면 이 속성 값은 $true입니다.If the caret is immediately before the opening character or immediately after the closing character of a pair, then this property value is $true. 그렇지 않으면 $false입니다.Otherwise, it is $false.

# Test to see if the caret is next to a parenthesis, bracket, or brace
$psISE.CurrentFile.Editor.CanGoToMatch

CaretColumnCaretColumn

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

캐럿의 위치에 해당하는 열 번호를 가져오는 읽기 전용 속성입니다.The read-only property that gets the column number that corresponds to the position of the caret.

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

CaretLineCaretLine

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

캐럿을 포함하는 줄 번호를 가져오는 읽기 전용 속성입니다.The read-only property that gets the number of the line that contains the caret.

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

CaretLineTextCaretLineText

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

캐럿을 포함하는 텍스트의 전체 줄을 가져오는 읽기 전용 속성입니다.The read-only property that gets the complete line of text that contains the caret.

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

LineCountLineCount

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

편집기에서 줄 수를 가져오는 읽기 전용 속성입니다.The read-only property that gets the line count from the editor.

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

SelectedTextSelectedText

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

편집기에서 선택한 텍스트를 가져오는 읽기 전용 속성입니다.The read-only property that gets the selected text from the editor.

이 항목의 뒷부분에 나오는 스크립팅 예제를 참조하세요.See the Scripting Example later in this topic.

텍스트Text

Windows PowerShell ISE 2.0 이상에서 지원됩니다.Supported in Windows PowerShell ISE 2.0 and later.

편집기에 있는 텍스트를 설정하거나 가져오는 읽기/쓰기 속성입니다.The read/write property that gets or sets the text in the editor.

이 항목의 뒷부분에 나오는 스크립팅 예제를 참조하세요.See the Scripting Example later in this topic.

스크립팅 예제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.
# 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())

참고 항목See Also