ITextRange.Text Propriété

Définition

Espace de noms:

Windows.UI.Text

Obtient ou définit le texte brut de la plage de texte.

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

Valeur de propriété

String

Platform::String

winrt::hstring

Texte brut.

Remarques

La propriété Text est la propriété par défaut pour ITextRange. Par conséquent, il est automatiquement appelé pour la plage de texte. Par exemple : Certains des exemples ci-dessous utilisent ce fait. print range

La méthode Text remplace une chaîne par le texte de plage. Pour le traitement d’un caractère unique, la propriété ITextRange.Character est plus efficace que la propriété Text et ne nécessite pas la création d’une plage de caractères unique pour stocker un caractère.

Si la plage est dégénérée, la propriété Text vous permet d’insérer facilement du texte. Vous pouvez également supprimer le texte dans une plage :range.delete range = ""

Vous pouvez utiliser la propriété Text pour copier du texte brut d’un emplacement à un autre, en définissant simplement une plage égale à une autre. L’instruction suivante définit le texte d’une plage sur celui d’une autre :range1 = range2

Ces plages peuvent être dans différentes histoires ou même dans différentes applications. Toutefois, elles impliquent de copier d’abord le texte dans une chaîne, puis de cette chaîne à l’emplacement cible.

Pour de grandes quantités de texte, les méthodes ITextRange.Copy et ITextRange.Paste peuvent être plus rapides, car elles peuvent effectuer la copie directement de la source vers la cible et avec n’importe quel format pris en charge par la source et la cible.

Le texte retourné par la propriété Text est donné en Unicode. La marque de fin de paragraphe peut être donnée par l’un des éléments suivants en fonction du fichier d’origine :

• 0x2029 (séparateur de paragraphe Unicode)
• retour chariot/flux de ligne (CRLF) (0xd, 0xa)
• CR seul (0xd)

L’espace réservé pour un objet incorporé est donné par le caractère spécial, WCH_EMBEDDING, qui a la valeur Unicode officielle 0xFFFC.