ITextRange.Delete(TextRangeUnit, Int32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Supprime le texte de la plage de texte.
public:
int Delete(TextRangeUnit unit, int count);int Delete(TextRangeUnit const& unit, int const& count);public int Delete(TextRangeUnit unit, int count);function delete(unit, count)Public Function Delete (unit As TextRangeUnit, count As Integer) As IntegerParamètres
- unit
- TextRangeUnit
Unité de texte à supprimer.
- count
-
Int32
int
Nombre d’unités à supprimer. Consultez la section Notes.
Retours
int
Nombre d’unités supprimées. La suppression du texte dans une plage de texte non dégénérée compte comme une unité.
Remarques
Si le nombre est égal à zéro, cette méthode supprime tout le texte de la plage de texte. Rien n’est supprimé si la plage de texte n’est qu’un point d’insertion (c’est-à-dire une plage dégénérée).
Si le nombre n’est pas zéro et que la plage est un point d’insertion, | count | (valeur absolue du nombre) les unités sont supprimées dans le sens logique donné par le signe de nombre, où une valeur positive est vers la fin de l’histoire et une valeur négative est vers le début de l’histoire.
Si le nombre 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 d’unité et de nombre, ce qui entraîne un point d’insertion. Ensuite, | count | - 1 les unités sont supprimées dans la direction logique donnée par le signe de nombre.
Le texte de la plage peut également être supprimé en affectant une chaîne null à la plage.
La suppression du CR entraîne le comportement suivant :
- 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).