Interface TextRange

Artigo
10/26/2012

Representa uma seção única e contígua de texto em um documento de texto.

Namespace: EnvDTE
Assembly: EnvDTE (em EnvDTE.dll)

Sintaxe

'Declaração
<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

O tipo TextRange expõe os membros a seguir.

Propriedades

	Nome	Descrição
	Collection	Obtém a coleção que contém o TextRange com suporte para essa propriedade do objeto.
	DTE	Obtém o objeto de extensibilidade de nível superior.
	EndPoint	Obtém um EditPoint ou seja, o local do final do intervalo.
	StartPoint	Obtém o EditPoint objeto que representa o início do texto do documento, ou o primeiro caractere exibido do painel.

Superior

Comentários

A seção de texto é delimitada por um par de EditPoint objetos.

TextRangeobjetos são usados quando você tem de expressões regulares com subexpressões com marcas de formatação.Uma coleção de intervalos é retornada, um para cada subexpressão correspondente, e suas propriedades são somente leitura.

Para a manipulação de texto gerais, é recomendável que você usar objetos, como TextSelection ou EditPoint, porque o TextSelection objeto relaciona-se diretamente à seleção visível na tela.Quando a área de seleção é alterada, alteração de coordenadas do objeto e vice-versa.Como resultado, uma seleção de texto não pode ser usada para representar um intervalo arbitrário de texto sem interromper essa seleção de texto.

Exemplos

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 ("*/");
    }
}

Consulte também

Referência

Namespace EnvDTE

Partilhar via