다음을 통해 공유

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 형식에서는 다음과 같은 멤버를 노출합니다.

속성

  이름 설명
Public 속성 Action 다음 찾기, 모두 찾기, 찾아서 바꾸기 등 찾기 방법을 가져오거나 설정합니다.
Public 속성 Backwards 현재 위치에서 뒤로 검색하는지 여부를 나타내는 값을 가져오거나 설정합니다.
Public 속성 DTE 최상위 확장성 개체를 가져옵니다.
Public 속성 FilesOfType 검색할 파일의 파일 확장명을 가져오거나 설정합니다.
Public 속성 FindWhat 찾을 텍스트 또는 패턴을 가져오거나 설정합니다.
Public 속성 KeepModifiedDocumentsOpen Replace 작업을 수행한 후 수정된 문서를 열어 둘 것인지 여부를 가져오거나 설정합니다.
Public 속성 MatchCase 검색에 대/소문자를 구분하는지 여부를 나타내는 값을 가져오거나 설정합니다.
Public 속성 MatchInHiddenText 숨겨진 텍스트를 검색에 포함할지 여부를 나타내는 값을 가져오거나 설정합니다.
Public 속성 MatchWholeWord 전체 단어가 일치하는 항목만 검색하는지 여부를 나타내는 값을 가져오거나 설정합니다.
Public 속성 Parent Find 개체의 바로 위 부모 개체를 가져옵니다.
Public 속성 PatternSyntax 검색 패턴을 지정하는 데 사용된 구문을 가져오거나 설정합니다.
Public 속성 ReplaceWith 바꾸기 작업에 사용할 대체 텍스트를 가져오거나 설정합니다.
Public 속성 ResultsLocation 대량 검색 작업에서 결과가 표시되는 위치를 가져오거나 설정합니다.
Public 속성 SearchPath 파일에서 찾기 작업에 사용할 디렉터리 목록을 가져오거나 설정합니다.
Public 속성 SearchSubfolders Search 작업을 수행할 때 하위 폴더를 포함할지 여부를 나타내는 값을 가져오거나 설정합니다.
Public 속성 Target 모든 열린 문서, 파일, 활성 문서 등의 검색 작업의 대상을 가져오거나 설정합니다.

위쪽

메서드

  이름 설명
Public 메서드 Execute Find 개체에 설정된 옵션을 사용하여 검색을 수행합니다.
Public 메서드 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

참고 항목

참조

EnvDTE 네임스페이스