TextSelection.FindPattern (Método)

Artículo
05/17/2015

Busca el modelo especificado desde el punto activo hasta el final del documento.

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

Sintaxis

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

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

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

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

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

Parámetros

Pattern
Tipo: String

Obligatorio. El texto que se va a buscar.

vsFindOptionsValue
Tipo: Int32

Uno de los valores de vsFindOptions.

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
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 marcadores 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

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

TextSelection Interfaz

EnvDTE (Espacio de nombres)

Share via