Comment : définir et sélectionner des plages dans les documents

Mise à jour : novembre 2007

S'applique à
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Type de projet Projets au niveau du document Projets au niveau de l'application Version de Microsoft Office Word 2003 Word 2007 Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Vous pouvez définir une plage dans un document Microsoft Office Word à l'aide d'un objet Range. Vous pouvez sélectionner tout le document de différentes manières, par exemple, en utilisant la méthode Select de l'objet Range ou en utilisant la propriété Content de la classe Microsoft.Office.Tools.Word.Document (dans une personnalisation au niveau du document) ou de la classe Microsoft.Office.Interop.Word.Document (dans un complément d'application).

Définition d'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. Il sélectionne ensuite le texte dans la plage.

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

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

  Dim rng As Word.Range = Me.Range(Start:=0, End:=7)
  rng.Select()
  

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

Pour définir une plage à l'aide d'un complément d'application

• Ajoutez la plage au document en passant un caractère de début et de fin à la méthode Range de la classe Microsoft.Office.Interop.Word.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 dans votre projet.

  Dim rng As Word.Range = Me.Application.ActiveDocument.Range(Start:=0, End:=7)
  rng.Select()
  

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

Sélection d'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 à l'aide de la propriété Content de la classe Microsoft.Office.Tools.Word.Document.

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

• Utilisez la méthode Select d'un objet Range qui contient le document entier. Pour utiliser l'exemple de code suivant, exécutez-le à partir de la classe ThisDocument dans votre projet.

  Me.Range.Select()
  

  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

• Utilisez la propriété Content pour définir une plage qui comprend le document entier.

  Me.Content.Select()
  

  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

• Définissez la plage à l'aide de la collection Sentences. Utilisez l'index de la phrase à sélectionner.

  Dim s2 As Word.Range = Me.Sentences(2)
  s2.Select()
  

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

Il est également possible de définir manuellement les valeurs de départ et de fin pour la plage.

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

1. Créez une variable de portée.

   Dim rng As Word.Range
   

   Word.Range rng; 
   

2. Assurez-vous que le document contient au moins deux phrases, définissez les arguments Start et End de la plage, puis sélectionnez la plage.

   If Me.Sentences.Count >= 2 Then
   
       Dim startLocation As Object = Me.Sentences(2).Start
       Dim endLocation As Object = Me.Sentences(2).End
   
       ' Supply a Start and End value for the Range.
       rng = Me.Range(Start:=startLocation, End:=endLocation)
   
       ' Select the Range
       rng.Select()
   End If
   

   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élection d'une plage à l'aide d'un complément d'application

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

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

• Utilisez la méthode Select d'un objet Range qui contient le document entier. L'exemple de code suivant permet de sélectionner le contenu du document actif. Pour utiliser cet exemple de code, exécutez-le à partir de la classe ThisAddIn dans votre projet.

  Me.Application.ActiveDocument.Range.Select()
  

  object start = this.Application.ActiveDocument.Content.Start;
  object end = this.Application.ActiveDocument.Content.End;
  
  this.Application.ActiveDocument.Range(ref start, ref end).Select();
  

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

• Utilisez la propriété Content pour définir une plage qui comprend le document entier.

  Me.Application.ActiveDocument.Content.Select()
  

  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

• Définissez la plage à l'aide de la collection Sentences. Utilisez l'index de la phrase à sélectionner.

  Dim s2 As Word.Range = Me.Application.ActiveDocument.Sentences(2)
  s2.Select()
  

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

Il est également possible de définir manuellement les valeurs de départ et de fin pour la plage.

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

1. Créez une variable de portée.

   Dim rng As Word.Range
   

   Word.Range rng;
   

2. Assurez-vous que le document contient au moins deux phrases, définissez les arguments Start et End de la plage, puis sélectionnez la plage.

   Dim document As Word.Document = Me.Application.ActiveDocument
   If document.Sentences.Count >= 2 Then
   
       Dim startLocation As Object = document.Sentences(2).Start
       Dim endLocation As Object = document.Sentences(2).End
   
       ' Supply a Start and End value for the Range.
       rng = document.Range(Start:=startLocation, End:=endLocation)
   
       ' Select the Range
       rng.Select()
   End If
   

   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();
   }
   

Voir aussi

Tâches

Comment : étendre des plages dans des documents

Comment : récupérer les caractères de début et de fin dans les plages

Comment : étendre des plages dans des documents

Comment : réinitialiser des plages dans les documents Word

Comment : réduire des plages ou des sélections dans des documents

Comment : exclure les marques de paragraphe lors de la création de plages

Concepts

Vue d'ensemble du modèle objet Word