TextRange Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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. |