ITextRange.Text Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
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.