TextPoint (Interfaz)
Actualización: noviembre 2007
Representa una ubicación de texto en un documento de texto.
Espacio de nombres: EnvDTE
Ensamblado: EnvDTE (en EnvDTE.dll)
Sintaxis
<GuidAttribute("7F59E94E-4939-40D2-9F7F-B7651C25905D")> _
Public Interface TextPoint
Dim instance As TextPoint
[GuidAttribute("7F59E94E-4939-40D2-9F7F-B7651C25905D")]
public interface TextPoint
[GuidAttribute(L"7F59E94E-4939-40D2-9F7F-B7651C25905D")]
public interface class TextPoint
public interface TextPoint
Comentarios
El objeto TextPoint permite buscar ubicaciones en un documento. Mediante la utilización de las propiedades del objeto TextPoint se puede buscar texto con:
Números de línea
Números de caracteres que contiene una línea
Ubicaciones de caracteres absolutos desde el principio del documento
Columnas presentadas
Los objetos TextPoint son similares a los objetos EditPoint, excepto en que funcionan en el texto mostrado en un editor de código, no en los datos del búfer de texto. El texto de un documento se ve afectado por los estados globales del editor, como el ajuste de línea y los espacios virtuales, mientras que el búfer de texto no.
Cuando se edita un documento, los objetos TextPoint no se desplazan con respecto al texto que los rodea. Es decir, si el texto se inserta delante de un punto de texto, el valor de su propiedad AbsoluteCharOffset se incrementa para reflejar su nueva ubicación más abajo en el documento. Si varios objetos TextPoint están en la misma ubicación y se utiliza un objeto EditPoint para insertar texto nuevo, los nuevos caracteres se situarán a la derecha de todos los objetos TextPoint, excepto el utilizado para insertar el texto.
Cualquier operación que intente modificar un objeto TextDocument fracasará si TextDocument es de sólo lectura.
Ejemplos
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 TextPointendpt = 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