ITextRange.Text Propriedade

Definição

Namespace:

Microsoft.UI.Text

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

public:
 property Platform::String ^ Text { Platform::String ^ get(); void set(Platform::String ^ value); };

winrt::hstring Text();

void Text(winrt::hstring value);

public string Text { get; set; }

var string = iTextRange.text;
iTextRange.text = string;

Public Property Text As String

Valor da propriedade

String

Platform::String

winrt::hstring

O texto sem formatação.

Comentários

A propriedade Text é a propriedade padrão para ITextRange. Dessa forma, ele é invocado automaticamente para o intervalo de texto. Por exemplo: alguns dos exemplos abaixo usam esse fato. print range

O método Text substitui uma cadeia de caracteres para o texto do intervalo. Para processar um único caractere, a propriedade ITextRange.Character é mais eficiente do que a propriedade Text e não requer a criação de um único intervalo de caracteres para armazenar um caractere.

Se o intervalo for degenerado, a propriedade Text permitirá que você insira o texto facilmente. Você também pode excluir o texto em um intervalo:range.delete range = ""

Você pode usar a propriedade Text para copiar texto sem formatação de um lugar para outro, simplesmente definindo um intervalo igual a outro. A instrução a seguir define o texto de um intervalo como o de outro:range1 = range2

Esses intervalos podem estar em histórias diferentes ou até mesmo em aplicativos diferentes. No entanto, eles implicam copiar o texto primeiro em uma cadeia de caracteres e, em seguida, dessa cadeia de caracteres para o local de destino.

Para grandes quantidades de texto, os métodos ITextRange.Copy e ITextRange.Paste podem ser mais rápidos, pois podem executar a cópia diretamente da origem para o destino e com qualquer formato compatível com a origem e o destino.

O texto retornado pela propriedade Text é dado em Unicode. A marca de fim de parágrafo pode ser fornecida por um dos seguintes, dependendo do arquivo original:

• 0x2029 (separador de parágrafo Unicode)
• CRLF (retorno de carro/alimentação de linha) (0xd, 0xa)
• CR sozinho (0xd)

O espaço reservado para um objeto inserido é fornecido pelo caractere especial, WCH_EMBEDDING, que tem o valor unicode oficial 0xFFFC.