TextPoint, interface

Article
08/10/2011

Représente un emplacement de texte dans un document texte.

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

Syntaxe

'Déclaration
<GuidAttribute("7F59E94E-4939-40D2-9F7F-B7651C25905D")> _
Public Interface TextPoint

[GuidAttribute("7F59E94E-4939-40D2-9F7F-B7651C25905D")]
public interface TextPoint

[GuidAttribute(L"7F59E94E-4939-40D2-9F7F-B7651C25905D")]
public interface class TextPoint

[<GuidAttribute("7F59E94E-4939-40D2-9F7F-B7651C25905D")>]
type TextPoint =  interface end

public interface TextPoint

Le type TextPoint expose les membres suivants.

Propriétés

	Nom	Description
	AbsoluteCharOffset	Obtient l'offset de caractère base 1 entre le début du document et l'objet TextPoint.
	AtEndOfDocument	Obtient une valeur indiquant si l'objet se trouve à la fin du document.
	AtEndOfLine	Obtient une valeur indiquant si l'objet se trouve à la fin d'une ligne.
	AtStartOfDocument	Obtient une valeur indiquant si l'objet se trouve au début du document.
	AtStartOfLine	Obtient une valeur indiquant si l'objet se trouve au début d'une ligne.
	CodeElement	Retourne l'élément de code à l'emplacement de TextPoint.
	DisplayColumn	Obtient le numéro de la colonne affichée contenant l'objet TextPoint.
	DTE	Obtient l'objet d'extensibilité de niveau supérieur.
	Line	Obtient le numéro de ligne de l'objet.
	LineCharOffset	Obtient l'offset de caractère de l'objet.
	LineLength	Obtient le nombre de caractères de la ligne contenant l'objet, à l'exclusion du caractère de saut de ligne.
	Parent	Obtient l'objet parent immédiat d'un objet TextPoint.

Début

Méthodes

	Nom	Description
	CreateEditPoint	Crée et retourne un objet EditPoint à l'emplacement de l'objet appelant.
	EqualTo	Retourne une valeur indiquant si la valeur de la propriété donnée AbsoluteCharOffset de l'objet du point équivaut à celle de l'objet TextPoint appelant.
	GreaterThan	Indique si la valeur de la propriété AbsoluteCharOffset de l'objet appelant est supérieure ou pas à celle de l'objet de point donné.
	LessThan	Indique si la valeur de la propriété AbsoluteCharOffset de l'objet appelé est inférieure ou pas à celle de l'objet de point donné.
	TryToShow	Tente d'afficher l'emplacement du point de texte.

Début

Notes

L'objet TextPoint vous permet de trouver des emplacements dans un document. À l'aide des propriétés de l'objet TextPoint, vous pouvez rechercher du texte selon les critères suivants :

Numéros de ligne
Numéros de caractères dans une ligne
Positions absolues de caractères à partir du début du document
Colonnes d'affichage

Les objets TextPoint sont semblables aux objets EditPoint, à ceci près qu'ils opèrent sur du texte affiché dans un éditeur de code et non sur les données du tampon de texte. Le texte situé dans un document est affecté par les états de l'éditeur en général, notamment le retour à la ligne automatique et les espaces virtuels, ce qui n'est pas le cas du tampon de texte.

Lorsque vous modifiez un document, les objets TextPoint ne se déplacent pas par rapport au texte qui les entoure. Autrement dit, si du texte est inséré avant un point de texte, la valeur de la propriété AbsoluteCharOffset est incrémentée pour refléter son nouvel emplacement plus loin dans le document. Si plusieurs objets TextPoint se trouvent au même emplacement et qu'un objet EditPoint est utilisé pour insérer du texte, les nouveaux caractères viendront se placer à droite de tous les objets TextPoint, à l'exception de celui qui est utilisé pour insérer le texte.

Toute opération visant à modifier un objet TextDocument échoue si TextDocument est en lecture seule.

Exemples

Sub TextPointExample()
   ' Comments a region of code.
   Dim selection As TextSelection
   selection = dte.ActiveDocument.selection()
   Dim Start As Editpoint
   Start = selection.TopPoint.CreateEditPoint()
   Dim endpt As TextPoint
   endpt = selection.BottomPoint
      
   Dim undoObj As UndoContext = dte.UndoContext
   undoobj.Open("Comment Region")
   Do While (Start.LessThan(endpt))
      Start.Insert("//")
      Start.LineDown()
      Start.StartOfLine()
   Loop
   undoobj.Close()
End Sub

Voir aussi

Référence

EnvDTE, espace de noms

Partager via