TextRange (Interfaz)

Representa una única sección contigua de texto en un documento de texto.

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

Sintaxis

'Declaración
<GuidAttribute("72767524-E3B3-43D0-BB46-BBE1D556A9FF")> _
Public Interface TextRange

[GuidAttribute("72767524-E3B3-43D0-BB46-BBE1D556A9FF")]
public interface TextRange

[GuidAttribute(L"72767524-E3B3-43D0-BB46-BBE1D556A9FF")]
public interface class TextRange

[<GuidAttribute("72767524-E3B3-43D0-BB46-BBE1D556A9FF")>]
type TextRange =  interface end

public interface TextRange

El tipo TextRange expone los siguientes miembros.

Propiedades

	Nombre	Descripción
	Collection	Obtiene la colección que contiene el objeto TextRange compatible con esta propiedad.
	DTE	Obtiene el objeto de extensibilidad de nivel superior.
	EndPoint	Obtiene un EditPoint que es la ubicación del fin del intervalo.
	StartPoint	Obtiene el objeto EditPoint que representa el principio del documento de texto o el primer carácter mostrado del panel.

Arriba

Comentarios

La sección de texto se incluye entre un par de objetos EditPoint.

Los objetos TextRange se utilizan cuando existen expresiones regulares con subexpresiones etiquetadas. Se devuelve una colección de intervalos, uno por cada subexpresión coincidente, y sus propiedades son de sólo lectura.

Para la manipulación general del texto, es más recomendable utilizar objetos como TextSelection o EditPoint, ya que el objeto TextSelection está directamente relacionado con la selección visible en la pantalla. Cuando el área de selección cambia, también cambian las coordenadas del objeto y viceversa. En definitiva, una selección de texto no se puede utilizar para representar un intervalo arbitrario de texto sin alterar dicha selección.

Ejemplos

Sub TextRangeExample(ByVal dte As EnvDTE.DTE)
    Dim objTxtSel As TextSelection
    Dim colRanges As TextRanges
    Dim objRange As TextRange
    Dim objEP As EditPoint

    objTxtSel = dte.ActiveDocument.Selection
    colRanges = objTxtSel.TextRanges
    For Each objRange In colRanges
        objRange.StartPoint.Insert("/*")
        objRange.EndPoint.Insert("*/")
    Next
End Sub

public void TextRangeExample(_DTE dte)
{
    TextSelection ts;
    TextRanges trs;

    ts = (TextSelection)dte.ActiveDocument.Selection;
    trs = ts.TextRanges;
    MessageBox.Show (trs.Count.ToString ());
    foreach (TextRange tr in trs)
    {
        tr.StartPoint.Insert ("/*");
        tr.EndPoint.Insert ("*/");
    }
}

Vea también

Referencia

EnvDTE (Espacio de nombres)