Définir et sélectionner des plages par programmation dans des documents

  • Article

Vous pouvez définir une plage dans un document Microsoft Office Word en utilisant un objet Range. Vous pouvez sélectionner l’intégralité du document de plusieurs façons, par exemple, à l’aide de la Select méthode de l’objet Range , ou à l’aide de la propriété Content de la Document classe (dans une personnalisation au niveau du document) ou de la Document classe (dans un complément VSTO).

S’applique à : les informations contenues dans cette rubrique s’appliquent aux projets au niveau du document et aux projets de complément VSTO pour Word. Pour plus d’informations, consultez Fonctionnalités disponibles par application Office lication et le type de projet.

Définir une plage

L'exemple suivant montre comment créer un objet Range incluant les sept premiers caractères du document actif, y compris les caractères non imprimables. Puis, il sélectionne le texte dans la plage.

Pour définir une plage dans une personnalisation au niveau du document

  1. Ajoutez la plage au document en passant un caractère de début et de fin à la méthode Range de la classe Document. Pour utiliser cet exemple de code, exécutez-le à partir de la classe ThisDocument de votre projet.

    object start = 0; 
object end = 7; 
Word.Range rng = this.Range(ref start, ref end); 

rng.Select();

Pour définir une plage en utilisant un complément VSTO

  1. Ajoutez la plage au document en passant un caractère de début et de fin à la méthode Range de la classe Document. L'exemple de code suivant ajoute une plage au document actif. Pour utiliser cet exemple de code, exécutez-le à partir de la classe ThisAddIn de votre projet.

    Word.Range rng = this.Application.ActiveDocument.Range(0, 7);

rng.Select();

Sélectionner une plage dans une personnalisation au niveau du document

Les exemples suivants montrent comment sélectionner le document entier à l'aide de la méthode Select d'un objet Range ou de la propriété Content de la classe Document.

Pour sélectionner la totalité du document comme plage à l'aide de la méthode Select

  1. Utilisez la méthode Select d'un Rangequi contient la totalité du document. Pour utiliser l'exemple de code suivant, exécutez-le à partir de la classe ThisDocument de votre projet.

    object start = this.Content.Start;
object end = this.Content.End;

this.Range(ref start, ref end).Select();

Pour sélectionner la totalité du document comme plage à l'aide de la propriété Content

  1. Utilisez la propriété Content pour définir une plage qui englobe la totalité du document.

    this.Content.Select();

    Vous pouvez également utiliser les méthodes et les propriétés d'autres objets pour définir une plage.

Pour sélectionner une phrase dans le document actif

  1. Définissez la plage à l'aide de la collection Sentences. Utilisez l'index de la phrase que vous souhaitez sélectionner.

    Word.Range s2 = this.Sentences[2]; 
s2.Select();

    Une autre façon de sélectionner une phrase consiste à définir manuellement les valeurs de début et de fin de la plage.

Pour sélectionner une phrase en définissant manuellement les valeurs de début et de fin

  1. Créez une variable de plage.

    Word.Range rng;

  2. Vérifiez s’il existe au moins deux phrases dans le document, définissez les arguments Début et Fin de la plage, puis sélectionnez la plage.

    if (this.Sentences.Count >= 2) 
{
    object startLocation = this.Sentences[2].Start; 
    object endLocation = this.Sentences[2].End; 

    // Supply a Start and End value for the Range. 
    rng = this.Range(ref startLocation, ref endLocation); 

    // Select the Range.
    rng.Select();
}

Sélectionner une plage à l’aide d’un complément VSTO

Les exemples suivants montrent comment sélectionner le document entier à l'aide de la méthode Select d'un objet Range ou de la propriété Content de la classe Document.

Pour sélectionner la totalité du document comme plage à l'aide de la méthode Select

  1. Utilisez la méthode Select d'un Rangequi contient la totalité du document. L'exemple de code suivant sélectionne le contenu du document actif. Pour utiliser cet exemple de code, exécutez-le à partir de la classe ThisAddIn de votre projet.

    this.Application.ActiveDocument.Range(
    this.Application.ActiveDocument.Content.Start,
    this.Application.ActiveDocument.Content.End).Select();

Pour sélectionner la totalité du document comme plage à l'aide de la propriété Content

  1. Utilisez la propriété Content pour définir une plage qui englobe la totalité du document.

    this.Application.ActiveDocument.Content.Select();

    Vous pouvez également utiliser les méthodes et les propriétés d'autres objets pour définir une plage.

Pour sélectionner une phrase dans le document actif

  1. Définissez la plage à l'aide de la collection Sentences. Utilisez l'index de la phrase que vous souhaitez sélectionner.

    Word.Range s2 = this.Application.ActiveDocument.Sentences[2];
s2.Select();

    Une autre façon de sélectionner une phrase consiste à définir manuellement les valeurs de début et de fin de la plage.

Pour sélectionner une phrase en définissant manuellement les valeurs de début et de fin

  1. Créez une variable de plage.

    Word.Range rng;

  2. Vérifiez s’il existe au moins deux phrases dans le document, définissez les arguments Début et Fin de la plage, puis sélectionnez la plage.

    Word.Document document = this.Application.ActiveDocument;

if (document.Sentences.Count >= 2)
{
    object startLocation = document.Sentences[2].Start;
    object endLocation = document.Sentences[2].End;

    // Supply a Start and End value for the Range. 
    rng = document.Range(ref startLocation, ref endLocation);

    // Select the Range.
    rng.Select();
}

Contenu connexe