EditPoint.FindPattern (Método)

Actualización: noviembre 2007

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

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

Sintaxis

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

Dim instance As EditPoint
Dim Pattern As String
Dim vsFindOptionsValue As Integer
Dim EndPoint As EditPoint
Dim Tags As TextRanges
Dim returnValue As Boolean

returnValue = instance.FindPattern(Pattern, _
    vsFindOptionsValue, EndPoint, Tags)

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
)

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

Parámetros

• Pattern
  Tipo: System.String

  Necesario. Texto que se desea buscar.

• vsFindOptionsValue
  Tipo: System.Int32

  Opcional. Una 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. Un 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: System.Boolean

true si se encuentra el modelo; de lo 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 indicador controla si la búsqueda se iniciará 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

Permisos

• 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)

EditPoint (Miembros)

EnvDTE (Espacio de nombres)