TextRange, interface

Représente une section de texte unique et contiguë dans un document.

Espace de noms :  EnvDTE
Assembly :  EnvDTE (dans EnvDTE.dll)

Syntaxe

'Déclaration
<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

Le type TextRange expose les membres suivants.

Propriétés

	Nom	Description
	Collection	Obtient la collection contenant l'objet TextRange qui prend en charge cette propriété.
	DTE	Obtient l'objet d'extensibilité de niveau supérieur.
	EndPoint	Obtient EditPoint qui représente l'emplacement à la fin de la plage.
	StartPoint	Obtient l'objet EditPoint représentant le début du document texte, ou le premier caractère affiché du volet.

Début

Notes

La section de texte est délimitée par une paire d'objets EditPoint.

Les objets TextRange sont utilisés lorsque vous avez des expressions régulières avec des sous-expressions marquées. Une collection de plages est retournée, une pour chaque expression correspondante et leurs propriétés sont en lecture seule.

Pour une manipulation générale du texte, il est recommandé d'utiliser à la place des objets tels que TextSelection ou EditPoint, car l'objet TextSelection est en relation directe avec la sélection visible à l'écran. Lorsque la zone de sélection change, les coordonnées de l'objet changent et vice-versa. En conséquence, une sélection de texte ne peut pas être utilisée pour représenter une plage de texte arbitraire sans interrompre cette sélection de texte.

Exemples

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

Voir aussi

Référence

EnvDTE, espace de noms