TextPoint (Interfaz)

Representa una ubicación de texto en un documento de texto.

Espacio de nombres:  EnvDTE
Ensamblado:  EnvDTE (en EnvDTE.dll)

Sintaxis

'Declaración
<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

El tipo TextPoint expone los siguientes miembros.

Propiedades

	Nombre	Descripción
	AbsoluteCharOffset	Obtiene el desplazamiento de caracteres basado en uno desde el principio del documento hasta el objeto TextPoint.
	AtEndOfDocument	Obtiene si el objeto está al final del documento o no.
	AtEndOfLine	Obtiene si el objeto está al final de una línea o no.
	AtStartOfDocument	Obtiene si el objeto está al principio del documento o no.
	AtStartOfLine	Obtiene si el objeto está al principio de una línea o no.
	CodeElement	Devuelve el elemento de código que hay en la ubicación del TextPoint.
	DisplayColumn	Obtiene el número de la columna presentada actualmente que contiene el objeto TextPoint.
	DTE	Obtiene el objeto de extensibilidad de nivel superior.
	Line	Obtiene el número de línea del objeto.
	LineCharOffset	Obtiene el desplazamiento de caracteres del objeto.
	LineLength	Obtiene el número de caracteres de una línea que contiene el objeto, excluido el carácter de nueva línea.
	Parent	Obtiene el objeto primario inmediato de un objeto TextPoint.

Arriba

Métodos

	Nombre	Descripción
	CreateEditPoint	Crea y devuelve un objeto EditPoint en la ubicación del objeto llamador.
	EqualTo	Devuelve si el valor de la propiedad AbsoluteCharOffset del objeto de punto dado es igual al del objeto TextPoint que realiza la llamada.
	GreaterThan	Indica si el valor de la propiedad AbsoluteCharOffset del objeto de llamada es mayor que el del objeto de punto dado o no.
	LessThan	Indica si el valor de la propiedad AbsoluteCharOffset del objeto llamado es menor que el del objeto dado o no.
	TryToShow	Intenta mostrar la ubicación del punto de texto.

Arriba

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 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

Vea también

Referencia

EnvDTE (Espacio de nombres)