Compartilhar via


Interface TextPoint

Representa um local do texto em um documento de texto.

Namespace:  EnvDTE
Assembly:  EnvDTE (em EnvDTE.dll)

Sintaxe

'Declaração
<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

O tipo TextPoint expõe os membros a seguir.

Propriedades

  Nome Descrição
Propriedade pública AbsoluteCharOffset Obtém o deslocamento baseada em um caractere do início do documento para o TextPoint objeto.
Propriedade pública AtEndOfDocument Obtém se o objeto está no final do documento.
Propriedade pública AtEndOfLine Obtém o objeto está no final de uma linha ou não.
Propriedade pública AtStartOfDocument Obtém o objeto está no início do documento ou não.
Propriedade pública AtStartOfLine Obtém o objeto está no início de uma linha ou não.
Propriedade pública CodeElement Retorna o elemento de código na TextPoint local.
Propriedade pública DisplayColumn Obtém o número da coluna exibida atual que contém o TextPoint objeto.
Propriedade pública DTE Obtém o objeto de extensibilidade de nível superior.
Propriedade pública Line Obtém o número de linha do objeto.
Propriedade pública LineCharOffset Obtém o deslocamento de caractere do objeto.
Propriedade pública LineLength Obtém o número de caracteres em uma linha que contém o objeto, excluindo o caractere de nova linha.
Propriedade pública Parent Obtém o objeto pai imediato de um TextPoint objeto.

Superior

Métodos

  Nome Descrição
Método público CreateEditPoint Cria e retorna um EditPoint o objeto no local do objeto de chamada.
Método público EqualTo Retorna se o valor de um determinado ponto do objeto AbsoluteCharOffset propriedade é igual da chamada TextPoint objeto.
Método público GreaterThan Indica se o valor da chamada do objeto AbsoluteCharOffset propriedade é maior do que o objeto de determinado ponto.
Método público LessThan Indica se o valor do objeto chamado AbsoluteCharOffset propriedade é menor que o objeto fornecido.
Método público TryToShow Tenta exibir o local do ponto de texto.

Superior

Comentários

O TextPoint objeto permite que você encontrar locais em um documento. Usando as propriedades do TextPoint objeto, você pode encontrar o texto com:

  • Números de linha

  • Números de caracteres em uma linha

  • Locais de caracteres absoluto desde o início do documento

  • Exibir colunas

TextPointobjetos são semelhantes aos EditPoint objetos, exceto que eles operam em texto exibido em um editor de código em vez de dados no buffer de texto. Texto em um documento é afetado por estados de editor global, como, por exemplo, quebra e espaços virtuais, mas o buffer de texto não é.

Ao editar um documento, TextPoint não movem objetos em relação ao seu texto ao redor. Ou seja, se o texto é inserido antes de um ponto do texto, em seguida, o valor da sua AbsoluteCharOffset propriedade é incrementada para refletir sua nova localização mais abaixo no documento. Se vários TextPoint objetos estão no mesmo local e um EditPoint objeto é usado para inserir o novo texto, em seguida, os novos caracteres estão à direita de todas as TextPoint objetos exceto aquele usado para inserir o texto.

Qualquer operação que tenta modificar um TextDocument objeto falhará se a TextDocument é somente leitura.

Exemplos

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

Consulte também

Referência

Namespace EnvDTE