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

Article
08/10/2011

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).

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document et de niveau application pour Word 2007 et Word 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

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()
```
```
Word.Range rng = this.Application.ActiveDocument.Range(0, 7);

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

Créez une variable de portée.
```
Dim rng As Word.Range
```
```
Word.Range rng; 
```

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

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()
```
```
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

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

Créez une variable de portée.
```
Dim rng As Word.Range
```
```
Word.Range rng;
```

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

Partager via

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

Définition d'une plage

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

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

Sélection d'une plage dans une personnalisation au niveau du document

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

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

Pour sélectionner une phrase dans le document actif

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

Sélection d'une plage à l'aide d'un complément d'application

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

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

Pour sélectionner une phrase dans le document actif

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

Voir aussi

Tâches

Autres ressources

Ressources supplémentaires