Find 인터페이스
IDE에서 문서와 파일에 대한 일반적인 텍스트 Find 작업을 지원합니다.
네임스페이스: EnvDTE
어셈블리: EnvDTE(EnvDTE.dll)
구문
‘선언
<GuidAttribute("40D4B9B6-739B-4965-8D65-692AEC692266")> _
Public Interface Find
[GuidAttribute("40D4B9B6-739B-4965-8D65-692AEC692266")]
public interface Find
[GuidAttribute(L"40D4B9B6-739B-4965-8D65-692AEC692266")]
public interface class Find
[<GuidAttribute("40D4B9B6-739B-4965-8D65-692AEC692266")>]
type Find = interface end
public interface Find
Find 형식에서는 다음과 같은 멤버를 노출합니다.
속성
| 이름 | 설명 | |
|---|---|---|
.gif "Public 속성") |
Action | 다음 찾기, 모두 찾기, 찾아서 바꾸기 등의 찾기 방법을 가져오거나 설정합니다. |
|
Backwards | 현재 위치에서 뒤로 검색하는지 여부를 나타내는 값을 가져오거나 설정합니다. |
|
DTE | 최상위 확장성 개체를 가져옵니다. |
|
FilesOfType | 검색할 파일의 파일 확장명을 가져오거나 설정합니다. |
|
FindWhat | 찾을 텍스트 또는 패턴을 가져오거나 설정합니다. |
|
KeepModifiedDocumentsOpen | Replace 작업을 수행한 후 수정된 문서를 열어 둘 것인지 여부를 가져오거나 설정합니다. |
|
MatchCase | 검색에 대/소문자를 구분하는지 여부를 나타내는 값을 가져오거나 설정합니다. |
|
MatchInHiddenText | 숨겨진 텍스트를 검색에 포함할지 여부를 나타내는 값을 가져오거나 설정합니다. |
|
MatchWholeWord | 전체 단어가 일치하는 항목만 검색하는지 여부를 나타내는 값을 가져오거나 설정합니다. |
|
Parent | Find 개체의 직계 부모를 가져옵니다. |
|
PatternSyntax | 검색 패턴을 지정하는 데 사용된 구문을 가져오거나 설정합니다. |
|
ReplaceWith | 바꾸기 작업에 사용할 대체 텍스트를 가져오거나 설정합니다. |
|
ResultsLocation | 대량 검색 작업에서 결과가 표시되는 위치를 가져오거나 설정합니다. |
|
SearchPath | 파일에서 찾기 작업에 사용할 디렉터리 목록을 가져오거나 설정합니다. |
|
SearchSubfolders | Search 작업을 수행할 때 하위 폴더를 포함할지 여부를 나타내는 값을 가져오거나 설정합니다. |
|
Target | 모든 열린 문서, 파일, 활성 문서 등의 검색 작업의 대상을 가져오거나 설정합니다. |
위쪽
메서드
| 이름 | 설명 | |
|---|---|---|
.gif "Public 메서드") |
Execute | Find 개체에 설정된 옵션을 사용하여 검색을 수행합니다. |
|
FindReplace | Find 에 설정한 옵션에 영향을 주지 않으면서 메서드의 인수를 사용하여 찾기 또는 바꾸기 작업을 수행합니다. |
위쪽
설명
Find 개체를 사용하면 코드 편집기와 같이 이러한 작업을 지원하는 환경에서 텍스트를 검색하고 바꿀 수 있습니다.
이는 주로 매크로 기록을 위한 것입니다.편집기의 매크로 기록 메커니즘에서는 전역 찾기 기능을 활용할 수 있도록 TextSelection.FindPattern 대신 Find를 사용합니다. 또한 파일에서 찾기 같은 작업을 수행할 때는 일반적으로 TextSelection 개체보다 이 개체가 유용합니다.
Visual Studio 환경의 전역 찾기 상태는 검색 기능을 제공하는 모든 도구에서 공유됩니다.예를 들어 모든 Visual Studio 요소에서 세션 중에 사용된 검색 패턴의 기록을 비롯하여 열려 있는 문서에 대한 다음 Find 작업을 앞으로 수행할지 뒤로 수행할지에 대한 정보를 공유할 수 있습니다.Find 개체의 속성은 전역 찾기 상태와 상호 작용하고 이를 추적합니다.Find 개체에 대한 속성을 설정하면 전역 찾기 상태도 설정됩니다.사용자가 전체 환경에서 Find 작업을 수행하면 적용된 검색 유형이 Find 개체에 반영됩니다.자동화 코드는 환경의 UI 스레드와 동기적으로 실행되므로 일부 속성을 설정할 필요가 없으며 Execute를 호출하기 전에 사용자가 검색 작업을 수행하지 않아도 됩니다.
Execute 메서드에서는 Find 개체의 설정을 기반으로 Find 작업을 수행합니다.FindReplace 메서드에 인수를 전달하여 전역 찾기 상태에 영향을 주지 않고 검색을 수행할 수도 있습니다.자동화 클라이언트에서는 전역 찾기 상태에 영향을 주거나 최종 사용자의 환경 상태 모델을 방해하지 않은 채 검색을 수행할 수 있어야 합니다.
예제
Sub FindExample()
Dim objTextDoc As TextDocument
Dim objEditPt As EditPoint
Dim iCtr As Integer
Dim objFind As Find
' Create a new text file.
DTE.ItemOperations.NewFile("General\Text File")
' Get a handle to the new document and create an EditPoint.
objTextDoc = DTE.ActiveDocument.Object("TextDocument")
objEditPt = objTextDoc.StartPoint.CreateEditPoint
objFind = objTextDoc.DTE.Find
' Insert ten lines of text.
For iCtr = 1 To 10
objEditPt.Insert("This is a test." & Chr(13))
Next iCtr
' Set the find options.
objFind.Action = vsFindAction.vsFindActionReplaceAll
objFind.Backwards = False
objFind.FilesOfType = "*.txt"
objFind.FindWhat = "test"
objFind.KeepModifiedDocumentsOpen = True
objFind.MatchCase = False
objFind.MatchInHiddenText = False
objFind.MatchWholeWord = True
objFind.PatternSyntax = vsFindPatternSyntax.vsFindPatternSyntaxLiteral
objFind.ReplaceWith = "NEW THING"
objFind.ResultsLocation = vsFindResultsLocation.vsFindResultsNone
objFind.SearchPath = "c:\temp"
objFind.SearchSubfolders = False
objFind.Target = vsFindTarget.vsFindTargetCurrentDocument
' Perform the Find operation.
objFind.Execute()
End Sub