Comment : définir et sélectionner des plages dans les documents par programmationHow to: Programmatically define and select ranges in documents

Vous pouvez définir une plage dans un document Microsoft Office Word en utilisant un objet Range.You can define a range in a Microsoft Office Word document by using a Range object. Vous pouvez sélectionner la totalité du document dans une de plusieurs façons, par exemple, à l’aide de la Select méthode de la Range de l’objet, ou en utilisant la propriété de contenu de la Document classe (dans une personnalisation au niveau du document) ou la Document classe (dans un Complément VSTO).You can select the entire document in a number of ways, for example, by using the Select method of the Range object, or by using the Content property of the Document class (in a document-level customization) or the Document class (in a VSTO Add-in).

S’applique à : les informations contenues dans cette rubrique s’applique au document-projets et ajouter de VSTO de niveau-dans les projets pour Word.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for Word. Pour plus d’informations, consultez fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features available by Office application and project type.

Définir une plageDefine a range

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.The following example shows how to create a new Range object that includes the first seven characters in the active document, including non-printing characters. Puis, il sélectionne le texte dans la plage.It then selects the text within the range.

Pour définir une plage dans une personnalisation au niveau du documentTo define a range in a document-level customization

  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.Add the range to the document by passing a start and end character to the Range method of the Document class. Pour utiliser cet exemple de code, exécutez-le à partir de la classe ThisDocument de votre projet.To use this code example, run it from the ThisDocument class in your project.

    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 en utilisant un complément VSTOTo define a range by using a VSTO Add-in

  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.Add the range to the document by passing a start and end character to the Range method of the Document class. L'exemple de code suivant ajoute une plage au document actif.The following code example adds a range to the active document. Pour utiliser cet exemple de code, exécutez-le à partir de la classe ThisAddIn de votre projet.To use this code example, run it from the ThisAddIn class in your project.

    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électionnez une plage dans une personnalisation au niveau du documentSelect a range in a document-level customization

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.The following examples show how to select the entire document by using the Select method of a Range object, or by using the Content property of the Document class.

Pour sélectionner la totalité du document comme plage à l'aide de la méthode SelectTo select the entire document as a range by using the Select method

  1. Utilisez la méthode Select d'un Rangequi contient la totalité du document.Use the Select method of a Range that contains the entire document. Pour utiliser l'exemple de code suivant, exécutez-le à partir de la classe ThisDocument de votre projet.To use the following code example, run it from the ThisDocument class in your project.

    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é ContentTo select the entire document as a range by using the Content property

  1. Utilisez la propriété Content pour définir une plage qui englobe la totalité du document.Use the Content property to define a range that encompasses the entire document.

    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.You can also use the methods and properties of other objects to define a range.

Pour sélectionner une phrase dans le document actifTo select a sentence in the active document

  1. Définissez la plage à l'aide de la collection Sentences.Set the range by using the Sentences collection. Utilisez l'index de la phrase que vous souhaitez sélectionner.Use the index of the sentence you want to select.

    Dim s2 As Word.Range = Me.Sentences(2)
    s2.Select()
    
    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.Another way to select a sentence is to manually set the start and end values for the range.

Pour sélectionner une phrase en définissant manuellement les valeurs de début et de finTo select a sentence by manually setting the start and end values

  1. Créez une variable de plage.Create a range variable.

    Dim rng As Word.Range
    
    Word.Range rng; 
    
  2. Vérification pour voir s’il existe au moins deux phrases dans le document, définissez la Démarrer et fin arguments de la plage, puis sélectionnez la plage.Check to see if there are at least two sentences in the document, set the Start and End arguments of the range, and then select the range.

    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électionner une plage en utilisant un complément, VSTOSelect a range by using a VSTO Add-in

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.The following examples show how to select the entire document by using the Select method of a Range object, or by using the Content property of the Document class.

Pour sélectionner la totalité du document comme plage à l'aide de la méthode SelectTo select the entire document as a range by using the Select method

  1. Utilisez la méthode Select d'un Rangequi contient la totalité du document.Use the Select method of a Range that contains the entire document. L'exemple de code suivant sélectionne le contenu du document actif.The following code example selects the contents of the active document. Pour utiliser cet exemple de code, exécutez-le à partir de la classe ThisAddIn de votre projet.To use this code example, run it from the ThisAddIn class in your project.

    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é ContentTo select the entire document as a range by using the Content property

  1. Utilisez la propriété Content pour définir une plage qui englobe la totalité du document.Use the Content property to define a range that encompasses the entire document.

    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.You can also use the methods and properties of other objects to define a range.

Pour sélectionner une phrase dans le document actifTo select a sentence in the active document

  1. Définissez la plage à l'aide de la collection Sentences.Set the range by using the Sentences collection. Utilisez l'index de la phrase que vous souhaitez sélectionner.Use the index of the sentence you want to select.

    Dim s2 As Word.Range = Me.Application.ActiveDocument.Sentences(2)
    s2.Select()
    
    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.Another way to select a sentence is to manually set the start and end values for the range.

Pour sélectionner une phrase en définissant manuellement les valeurs de début et de finTo select a sentence by manually setting the start and end values

  1. Créez une variable de plage.Create a range variable.

    Dim rng As Word.Range
    
    Word.Range rng;
    
  2. Vérification pour voir s’il existe au moins deux phrases dans le document, définissez la Démarrer et fin arguments de la plage, puis sélectionnez la plage.Check to see if there are at least two sentences in the document, set the Start and End arguments of the range, and then select the range.

    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 aussiSee also

Vue d’ensemble du modèle d’objet Word Word object model overview
Comment : étendre des plages dans des documents par programmation How to: Programmatically extend ranges in documents
Comment : récupérer par programme des caractères de début et de fin dans les plages How to: Programmatically retrieve start and end characters in ranges
Comment : étendre des plages dans des documents par programmation How to: Programmatically extend ranges in documents
Comment : réinitialiser par programmation des plages dans des documents Word How to: Programmatically reset ranges in Word documents
Comment : réduire des plages ou des sélections dans des documents par programmation How to: Programmatically collapse ranges or selections in documents
Comment : exclure les marques de paragraphe par programmation lors de la création de plagesHow to: Programmatically exclude paragraph marks when creating ranges