Compartir a través de


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

Arriba

Métodos

  Nombre Descripción
Método público CreateEditPoint Crea y devuelve un objeto EditPoint en la ubicación del objeto llamador.
Método público EqualTo Devuelve si el valor de la propiedad AbsoluteCharOffset del objeto de punto dado es igual al del objeto TextPoint que realiza la llamada.
Método público GreaterThan Indica si el valor de la propiedad AbsoluteCharOffset del objeto de llamada es mayor que el del objeto de punto dado o no.
Método público LessThan Indica si el valor de la propiedad AbsoluteCharOffset del objeto llamado es menor que el del objeto dado o no.
Método público 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)