Partilhar via


ITextRange Interface

Definição

Representa um intervalo de texto contínuo em um documento e fornece propriedades e métodos avançados de edição e associação de dados que permitem que um aplicativo selecione, examine e altere o texto do documento.

public interface class ITextRange
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1537101399, 49266, 17056, 137, 69, 175, 80, 62, 229, 71, 104)]
struct ITextRange
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(1537101399, 49266, 17056, 137, 69, 175, 80, 62, 229, 71, 104)]
public interface ITextRange
Public Interface ITextRange
Derivado
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Propriedades

Character

Obtém ou define o primeiro caractere do intervalo de texto; ou seja, o caractere associado à propriedade StartPosition .

CharacterFormat

Obtém ou define os atributos de formatação de caracteres do intervalo de texto.

EndPosition

Obtém ou define a posição do caractere final do intervalo de texto.

FormattedText

Obtém ou define um objeto ITextRange com o texto formatado do intervalo especificado.

Gravity

Obtém ou define a gravidade do intervalo de texto.

Length

Obtém a contagem de caracteres no intervalo de texto.

Link

Obtém ou define o texto da URL associado a um intervalo de texto.

ParagraphFormat

Obtém ou define os atributos de formatação de parágrafo do intervalo de texto.

StartPosition

Obtém ou define a posição inicial do intervalo de texto.

StoryLength

Obtém a contagem de caracteres na história do intervalo de texto.

Text

Obtém ou define o texto sem formatação do intervalo de texto.

Métodos

CanPaste(Int32)

Determina se a Área de Transferência contém conteúdo que pode ser colado, usando um formato especificado, no intervalo de texto atual.

ChangeCase(LetterCase)

Altera o caso de letras em um intervalo de texto.

Collapse(Boolean)

Recolhe o intervalo de texto em um ponto degenerado no início ou no final do intervalo.

Copy()

Copia o texto do intervalo de texto para a Área de Transferência.

Cut()

Move o texto do intervalo de texto para a Área de Transferência.

Delete(TextRangeUnit, Int32)

Exclui o texto do intervalo de texto.

EndOf(TextRangeUnit, Boolean)

Move ou estende o intervalo de texto até o final da unidade de texto especificada mais próxima. O intervalo de texto é movido ou estendido para frente no documento.

Expand(TextRangeUnit)

Expande um intervalo de texto para conter completamente todas as unidades de texto parciais.

FindText(String, Int32, FindOptions)

Pesquisa uma cadeia de caracteres de texto específica em um intervalo e, se encontrada, seleciona a cadeia de caracteres.

GetCharacterUtf32(UInt32, Int32)

Recupera o código de caractere UTF (Formato de Transformação Unicode)-32 do caractere no deslocamento especificado do final do intervalo de texto.

GetClone()

Cria um novo objeto idêntico a esse objeto de intervalo de texto.

GetIndex(TextRangeUnit)

Recupera o índice de história da unidade de texto (palavra, linha, frase, parágrafo e assim por diante) na posição do caractere inicial do intervalo de texto.

GetPoint(HorizontalCharacterAlignment, VerticalCharacterAlignment, PointOptions, Point)

Recupera as coordenadas de tela de um local específico no intervalo de texto.

GetRect(PointOptions, Rect, Int32)

Recupera o retângulo delimitador que abrange o intervalo de texto na tela.

GetText(TextGetOptions, String)

Recupera o texto em um intervalo de texto de acordo com os sinalizadores de conversão especificados.

GetTextViaStream(TextGetOptions, IRandomAccessStream)

Recupera o texto no intervalo de texto de acordo com os sinalizadores de conversão especificados, como um fluxo de acesso aleatório.

InRange(ITextRange)

Determina se esse intervalo está no ou no mesmo texto que um intervalo especificado.

InsertImage(Int32, Int32, Int32, VerticalCharacterAlignment, String, IRandomAccessStream)

Insere uma imagem nesse intervalo.

InStory(ITextRange)

Determina se a história desse intervalo é a mesma que a história de um intervalo especificado.

IsEqual(ITextRange)

Determina se esse intervalo tem as mesmas posições de caractere e história que as de um intervalo especificado.

MatchSelection()

Define as posições inicial e final desse intervalo para corresponder à seleção ativa.

Move(TextRangeUnit, Int32)

Move o ponto de inserção para frente ou para trás pelo número especificado de unidades. Se o intervalo de texto não for descritivo, ele será recolhido para um ponto de inserção na posição inicial ou final do intervalo de texto, dependendo da contagem e, em seguida, será movido.

MoveEnd(TextRangeUnit, Int32)

Move a posição final do intervalo de texto.

MoveStart(TextRangeUnit, Int32)

Move a posição inicial de um intervalo de texto.

Paste(Int32)

Cola o texto da Área de Transferência no intervalo de texto.

ScrollIntoView(PointOptions)

Rola esse intervalo de texto para exibição.

SetIndex(TextRangeUnit, Int32, Boolean)

Move o intervalo de texto para a unidade especificada da história.

SetPoint(Point, PointOptions, Boolean)

Altera o intervalo de texto com base no ponto especificado.

SetRange(Int32, Int32)

Define os pontos de extremidade do intervalo de texto para os valores especificados.

SetText(TextSetOptions, String)

Substitui o texto no intervalo de texto.

SetTextViaStream(TextSetOptions, IRandomAccessStream)

Define o texto no intervalo de texto com base no conteúdo de um fluxo de acesso aleatório.

StartOf(TextRangeUnit, Boolean)

Move ou estende o intervalo de texto para o início da unidade de texto especificada mais próxima. O intervalo de texto é movido ou estendido para trás no documento.

Aplica-se a