TextRange Interface

Définition

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

public interface class TextRange
public interface class TextRange
__interface TextRange
[System.Runtime.InteropServices.Guid("72767524-E3B3-43D0-BB46-BBE1D556A9FF")]
[System.Runtime.InteropServices.TypeLibType(4160)]
public interface TextRange
[<System.Runtime.InteropServices.Guid("72767524-E3B3-43D0-BB46-BBE1D556A9FF")>]
[<System.Runtime.InteropServices.TypeLibType(4160)>]
type TextRange = interface
Public Interface TextRange
Attributs

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

Remarques

La section de texte est entourée d’une paire d' EditPoint objets.

TextRange les objets sont utilisés lorsque vous avez des expressions régulières avec des sous-expressions avec balises. Une collection de plages est retournée, une pour chaque sous-expression mise en correspondance 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' TextSelection objet est directement associé à la sélection visible à l’écran. Lorsque la zone de sélection change, les coordonnées de l’objet changent et vice-versa. Par conséquent, une sélection de texte ne peut pas être utilisée pour représenter une plage de texte arbitraire sans interrompre la sélection de texte.

Propriétés

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.

S’applique à