TextSelection.FindPattern (Método)

  • Artículo

Actualización: noviembre 2007

Busca el patrón especificado desde el punto activo hasta el final del documento.

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

Sintaxis

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

Dim instance As TextSelection
Dim Pattern As String
Dim vsFindOptionsValue As Integer
Dim Tags As TextRanges
Dim returnValue As Boolean

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

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

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

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

Parámetros

  • Pattern
    Tipo: System.String

    Necesario. El texto que se va a buscar.

  • 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

Un valor Boolean que indica true si se encuentra el modelo y false de lo contrario.

Comentarios

FindPattern busca el modelo de texto especificado desde el punto de edición hasta el final del documento. Uno de los indicadores controla si la búsqueda se inicia o no 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 extremo 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()
   ' Before running this example, open a text document.
   Dim objSel As TextSelection = DTE.ActiveDocument.Selection

   ' Advance to the next Visual Basic function beginning or end by 
   ' searching for  "Sub" with white space before and after it.
   If objSel.FindPattern(":WhSub:Wh", vsFindOptions.vsFindOptionsRegularExpression) Then
      ' Select the entire line.
      objSel.SelectLine()
   End If
End Sub

Permisos

Vea también

Referencia

TextSelection (Interfaz)

TextSelection (Miembros)

EnvDTE (Espacio de nombres)