Interface TextPoint

Artigo
08/01/2011

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

Início

Métodos

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

Início

Comentários

O TextPoint objeto permite que você encontrar locais em um documento. Usando as propriedades de 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 no editor de código em vez de dados no buffer de texto. Texto em um documento é afetado por estados global editor, como, por exemplo, quebra e espaços virtuais, mas o buffer de texto não é.

Ao editar um documento, TextPoint objetos não se movem em relação ao seu texto ao redor. Ou seja, se o texto é inserido antes de um ponto do texto, em seguida, o valor de suas AbsoluteCharOffset propriedade é incrementada para refletir sua nova localização mais abaixo do 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 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

Compartilhar via