Partager via

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

  • Article

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 2013 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 dans votre projet à partir de la classe ThisDocument.

    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

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

    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

  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 par programmation

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

Comment : étendre des plages dans des documents par programmation

Comment : réinitialiser des plages dans les documents Word par programmation

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

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

Autres ressources

Vue d'ensemble du modèle objet Word