ITextRange.Text Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Text

Ottiene o imposta il testo normale dell'intervallo di testo.

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

Valore della proprietà

String

Platform::String

winrt::hstring

Testo normale.

Commenti

La proprietà Text è la proprietà predefinita per ITextRange. Di conseguenza, viene richiamato automaticamente per l'intervallo di testo. Ad esempio: alcuni degli esempi seguenti usano questo fatto. print range

Il metodo Text sostituisce una stringa per il testo dell'intervallo. Per l'elaborazione di un singolo carattere, la proprietà ITextRange.Character è più efficiente rispetto alla proprietà Text e non richiede la creazione di un singolo intervallo di caratteri per l'archiviazione di un carattere.

Se l'intervallo viene degenerato, la proprietà Text consente di inserire facilmente testo. È anche possibile eliminare il testo in un intervallo:range.delete range = ""

È possibile utilizzare la proprietà Text per copiare testo normale da una posizione a un'altra, semplicemente impostando un intervallo uguale a un altro. L'istruzione seguente imposta il testo di un intervallo su quello di un altro:range1 = range2

Questi intervalli possono trovarsi in storie diverse o anche in app diverse. Tuttavia, implicano la copia del testo prima in una stringa e quindi da tale stringa alla posizione di destinazione.

Per grandi quantità di testo, i metodi ITextRange.Copy e ITextRange.Paste possono essere più veloci, perché possono eseguire la copia direttamente dall'origine alla destinazione e con qualsiasi formato supportato dall'origine e dalla destinazione.

Il testo restituito dalla proprietà Text viene specificato in Unicode. Il segno di fine paragrafo può essere dato da uno dei seguenti a seconda del file originale:

• 0x2029 (separatore di paragrafo Unicode)
• ritorno a capo/avanzamento riga (CRLF) (0xd, 0xa)
• Solo CR (0xd)

Il segnaposto per un oggetto incorporato viene assegnato dal carattere speciale WCH_EMBEDDING, che ha il valore Unicode ufficiale 0xFFFC.