다음을 통해 공유


Find2 인터페이스

IDE에서 문서와 파일에 대한 일반적인 텍스트 Find 작업을 지원합니다.

네임스페이스:  EnvDTE80
어셈블리:  EnvDTE80(EnvDTE80.dll)

구문

‘선언
<GuidAttribute("01568308-5B2A-4F30-8D0A-E10EE0F28F4A")> _
Public Interface Find2 _
    Inherits Find
[GuidAttribute("01568308-5B2A-4F30-8D0A-E10EE0F28F4A")]
public interface Find2 : Find
[GuidAttribute(L"01568308-5B2A-4F30-8D0A-E10EE0F28F4A")]
public interface class Find2 : Find
[<GuidAttribute("01568308-5B2A-4F30-8D0A-E10EE0F28F4A")>]
type Find2 =  
    interface
        interface Find
    end
public interface Find2 extends Find

Find2 형식에서는 다음과 같은 멤버를 노출합니다.

속성

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

위쪽

메서드

  이름 설명
Public 메서드 Execute() (Find에서 상속됨)
Public 메서드 Execute() Find 개체에 설정된 옵션을 사용하여 검색을 수행합니다.
Public 메서드 FindReplace(vsFindAction, String, Int32, String, vsFindTarget, String, String, vsFindResultsLocation) (Find에서 상속됨)
Public 메서드 FindReplace(vsFindAction, String, Int32, String, vsFindTarget, String, String, vsFindResultsLocation) Find 개체에 설정한 옵션에는 영향을 주지 않으면서 메서드에 대한 인수를 사용하여 찾기 또는 바꾸기 작업을 수행합니다.

위쪽

설명

Find 개체를 사용하면 코드 편집기 같이 찾기 및 바꾸기 작업을 지원하는 환경에서 직접 텍스트를 찾아 바꿀 수 있습니다.

이는 주로 매크로 기록을 위한 것입니다. 편집기의 매크로 기록 메커니즘에는 TextSelection.FindPattern 대신 Find가 사용되므로 전역 찾기 기능을 활용할 수 있습니다. 또한 파일에서 찾기 같은 작업을 수행할 때 TextSelection 개체를 사용하는 것보다 더 효율적으로 작업할 수 있습니다.

Visual Studio 환경의 전역 찾기 상태는 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

참고 항목

참조

EnvDTE80 네임스페이스