Méthode ITextRange ::D elete (tom.h)

Article
03/03/2024

Imite les touches DELETE et BACKSPACE, avec et sans la touche Ctrl enfoncée.

Syntaxe

HRESULT Delete(
  long Unit,
  long Count,
  long *pDelta
);

Paramètres

Unit

Type : long

Unité à utiliser. L’unité peut être tomCharacter (la valeur par défaut) ou tomWord.

Count

Type : long

Nombre d’unitésà supprimer. Si Count= zéro, il supprime le texte dans la plage uniquement. Si Count est supérieur à zéro, ITextRange ::D elete agit comme si la touche DELETE était enfoncée Nombre d’heures. Si Le nombre est inférieur à zéro, il fait comme si la touche BACKSPACE avait été enfoncée Nombre d’heures. La valeur par défaut est 1. Pour plus d'informations, consultez la section Notes.

pDelta

Type : long*

Nombre d’unités supprimées. Elle ne peut pas avoir la valeur Null. Le paramètre pDelta est défini comme étant égal au nombre d’unitéssupprimées. La suppression du texte dans une plage non dégénérée compte comme une unité.

Valeur retournée

Type : HRESULT

Cette méthode retourne une valeur HRESULT . Si elle réussit, elle retourne S_OK. Sinon, il retourne l’une des valeurs suivantes. Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs dans COM.

Code de retour	Description
E_ACCESSDENIED	Le texte est protégé en écriture.
S_FALSE	Échec pour une autre raison.

Remarques

Si Count = zéro, cette méthode supprime le texte dans la plage, c’est-à-dire qu’elle ne supprime rien si la plage n’est qu’un point d’insertion.

Si Count n’est pas égal à zéro et que la plage est un point d’insertion (c’est-à-dire dégénéré), | Nombre| (valeur absolue de Count) Les unitéssont supprimées dans la direction logique donnée par le signe Count, où une valeur positive est la direction vers la fin de l’histoire, et une valeur négative est vers le début de l’histoire.

Si Count n’est pas égal à zéro et que la plage n’est pas dégénérée (contient du texte), le texte de la plage est supprimé (quelles que soient les valeurs Unit et Count), créant ainsi un point d’insertion. Ensuite, | Nombre| - 1 Les unitéssont supprimées dans la direction logique donnée par le signe Count.

Le texte de la plage peut également être supprimé en affectant une chaîne null à la plage (en exécutant l’instruction r = où sont est la plage). Toutefois, ITextRange ::D elete ne nécessite pas l’allocation d’un BSTR.

La suppression de la marque de fin de paragraphe (CR) entraîne le comportement spécial de l’interface utilisateur Microsoft Word. Quatre cas présentent un intérêt particulier :

Si vous supprimez uniquement le CR mais que le paragraphe inclut du texte, le CR est supprimé et le paragraphe suivant obtient la même mise en forme de paragraphe que le paragraphe actuel.
Si vous supprimez le CR ainsi que certains, mais pas tous, des caractères du paragraphe suivant, les caractères restants du paragraphe actuel obtiennent la mise en forme du paragraphe suivant.
Si vous sélectionnez jusqu’à la fin d’un paragraphe, mais pas le paragraphe entier, le CR n’est pas supprimé.
Si vous supprimez l’intégralité du paragraphe (du début à la CR), vous supprimez également le CR (sauf s’il s’agit du CR final dans le fichier).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	tom.h
DLL	Msftedit.dll

Voir aussi

Conceptuel

ITextRange

Référence

Modèle objet texte

Partager via