Share via


ITextRange.Text Propiedad

Definición

Obtiene o establece el texto sin formato del 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 de propiedad

String

Platform::String

winrt::hstring

Texto sin formato.

Comentarios

La propiedad Text es la propiedad predeterminada para ITextRange. Por lo tanto, se invoca automáticamente para el intervalo de texto. Por ejemplo: algunos de los ejemplos siguientes usan este hecho. print range

El método Text sustituye una cadena por el texto del intervalo. Para procesar un solo carácter, la propiedad ITextRange.Character es más eficaz que la propiedad Text y no requiere crear un intervalo de caracteres único para almacenar un carácter.

Si el intervalo está degenerado, la propiedad Text le permite insertar texto fácilmente. También puede eliminar el texto de un intervalo:range.delete range = ""

Puede usar la propiedad Text para copiar texto sin formato de un lugar a otro, simplemente estableciendo un intervalo igual a otro. La siguiente instrucción establece el texto de un intervalo en el de otro:range1 = range2

Estos intervalos pueden estar en diferentes historias o incluso en diferentes aplicaciones. Sin embargo, implican copiar el texto primero en una cadena y, a continuación, desde esa cadena a la ubicación de destino.

Para grandes cantidades de texto, los métodos ITextRange.Copy e ITextRange.Paste pueden ser más rápidos, ya que pueden realizar la copia directamente desde el origen al destino y con cualquier formato admitido por el origen y el destino.

El texto devuelto por la propiedad Text se indica en Unicode. La marca de fin de párrafo puede ser dada por uno de los siguientes en función del archivo original:

  • 0x2029 (separador de párrafo Unicode)
  • retorno de carro/avance de línea (CRLF) (0xd, 0xa)
  • CR solo (0xd)

El marcador de posición de un objeto incrustado recibe el carácter especial, WCH_EMBEDDING, que tiene el valor Unicode oficial 0xFFFC.

Se aplica a