Interface TextRange

Artigo
08/01/2011

Representa uma seção de ú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 objeto com suporte para esta propriedade.
	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.

Início

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 marcados. 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 relacionado 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 de texto de arbitrário, sem interromper a 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

Compartilhar via