Interface TextPoint

Artigo
05/17/2015

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 se o objeto está no final do documento.
	AtEndOfLine	Obtém o objeto está no final de uma linha ou não.
	AtStartOfDocument	Obtém o objeto está no início do documento ou não.
	AtStartOfLine	Obtém o objeto está no início de uma linha ou não.
	CodeElement	Retorna o elemento de código na 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.

Superior

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 o objeto de determinado ponto.
	LessThan	Indica se o valor do objeto chamado AbsoluteCharOffset propriedade é menor que o objeto fornecido.
	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

Compartilhar via