EditPoint.FindPattern (Método)

Busca un patrón de coincidencia determinado en el texto seleccionado.

Espacio de nombres:  EnvDTE
Ensamblado:  EnvDTE (en EnvDTE.dll)

Sintaxis

'Declaración
Function FindPattern ( _
    Pattern As String, _
    vsFindOptionsValue As Integer, _
    <OutAttribute> ByRef EndPoint As EditPoint, _
    <OutAttribute> ByRef Tags As TextRanges _
) As Boolean

bool FindPattern(
    string Pattern,
    int vsFindOptionsValue,
    out EditPoint EndPoint,
    out TextRanges Tags
)

bool FindPattern(
    [InAttribute] String^ Pattern, 
    [InAttribute] int vsFindOptionsValue, 
    [InAttribute] [OutAttribute] EditPoint^% EndPoint, 
    [InAttribute] [OutAttribute] TextRanges^% Tags
)

abstract FindPattern : 
        Pattern:string * 
        vsFindOptionsValue:int * 
        EndPoint:EditPoint byref * 
        Tags:TextRanges byref -> bool

function FindPattern(
    Pattern : String, 
    vsFindOptionsValue : int, 
    EndPoint : EditPoint, 
    Tags : TextRanges
) : boolean

Parámetros

• Pattern
  Tipo: String

  Obligatorio. Texto que se desea buscar.

• vsFindOptionsValue
  Tipo: Int32

  Opcional. Constante vsFindOptions que indica el tipo de búsqueda que se va a realizar. El valor constante vsFindOptionsMatchInHiddenText no se aplica a este método porque FindPattern busca en todo el texto, incluido el texto oculto.

• EndPoint
  Tipo: EnvDTE.EditPoint%

  Opcional. Objeto EditPoint que representa el punto que se desplazará al final del modelo coincidente.

• Tags
  Tipo: EnvDTE.TextRanges%

  Opcional. Si el modelo coincidente es una expresión regular que contiene subexpresiones etiquetadas, el argumento Tags contiene una colección de objetos TextRange, uno por cada subexpresión etiquetada.

Valor devuelto

Tipo: Boolean
true si se encuentra el modelo; en caso contrario, false.

Comentarios

FindPattern busca en todo el texto (incluido el texto oculto) el modelo de texto especificado desde el punto de edición hasta el final del documento. Un marcador controla si la búsqueda se inicia al principio del documento. El patrón puede ser una expresión regular o de otro tipo. El valor devuelto indica si se encontró el patrón. Si se encontró, el punto de edición se desplaza al principio de la coincidencia. En caso contrario, no se modifica la posición de edición.

Si se proporciona un extremo y se encuentra el modelo, el método FindPattern desplaza este punto al final del modelo encontrado.

Si el modelo coincidente es una expresión regular y contiene subexpresiones etiquetadas, el argumento Tags devuelve una colección de objetos TextRange, uno por cada subexpresión etiquetada.

Ejemplos

Sub FindPatternExample()
   Dim objTextDoc As TextDocument
   Dim objEditPt As EditPoint, iCtr As Integer
        
   ' 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
        
   ' Insert ten lines of text.
   For iCtr = 1 To 10
      objeditpt.Insert("This is a test." & Chr(13))
   Next iCtr
   objEditPt.StartOfDocument()
   'Search for the word "test."
   If objeditpt.FindPattern("test") = True Then
      msgbox("Found the word.")
   End If
End Sub

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

EditPoint Interfaz

EnvDTE (Espacio de nombres)