Objet ShapeRange (Word)

  • Article

Représente une plage de formes, constituée d'un ensemble de formes sur un document. Une plage de formes peut contenir d'une à toutes les formes d'un document.

Remarques

Vous pouvez inclure les formes souhaitées (choisies parmi toutes les formes du document ou toutes les formes de la sélection) pour construire une plage de formes. Par exemple, vous pouvez construire une collection ShapeRange qui contient les trois premières formes dans un document, toutes les formes sélectionnées dans un document ou toutes les formes libres d'un document. [!REMARQUE] La plupart des opérations que vous pouvez faire avec un objet Shape, vous pouvez également faire avec un objet ShapeRange qui contienne une seule forme. Certaines opérations sont effectuées sur un objet ShapeRange qui contienne plusieurs formes, provoquent une erreur.

Utilisez Range (index), où index est le nom ou le numéro d’index de la forme ou un tableau qui contient des noms ou des numéros d’index de formes, pour renvoyer une collection ShapeRange qui représente un ensemble de formes sur un document. Utilisez la fonction Array de Visual Basic pour construire un tableau de noms ou de numéros d’index. L'exemple suivant définit le motif de remplissage des formes un et trois du document actif.

ActiveDocument.Shapes.Range(Array(1, 3)).Fill.Patterned _ 
 msoPatternHorizontalBrick

L’exemple suivant sélectionne les formes nommées Oval 4 et Rectangle 5 sur le document actif.

ActiveDocument.Shapes.Range(Array("Oval 4", "Rectangle 5")).Select

Bien que vous pouvez utiliser la plage méthode pour renvoyer un nombre quelconque de formes, il est plus simple d'utiliser l' élément méthode si vous souhaitez ne renvoyer qu'un seul membre de la collection. Par exemple, Shapes(1) est plus simple que Shapes.Range(1).

Utilisez ShapeRange (index), où index est le nom ou le numéro d’index, pour renvoyer un objet Shape qui représente une forme dans une sélection. L'exemple suivant montre comment définir le remplissage de la première forme de la sélection, sous réserve que cette sélection contienne au moins une forme.

Selection.ShapeRange(1).Fill.ForeColor.RGB = RGB(255, 0, 0)

Cet exemple montre comment sélectionner toutes les formes de la première section du document actif.

Set myRange = ActiveDocument.Sections(1).Range 
myRange.ShapeRange.Select

Utiliser l'Aligner, distribuer ou ZOrder méthode pour positionner un ensemble de formes par rapport aux autres ou par rapport au document.

Utilisez le groupe, regrouper ou Dissocier Pour créer et manipuler une seule forme constituée à partir d'une plage de formes. La propriété GroupItems d'un objet Shape renvoie la GroupShapes objet qui représente toutes les formes qui ont été regroupées en une seule forme.

L'enregistreur utilise toujours le ShapeRange propriété lors de l'enregistrement des formes.

Remarque

[!REMARQUE] Un objet ShapeRange n'inclut pas InlineShape objets.

Méthodes

Propriétés

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.