Selection.Select, méthode (Visio)
Sélectionne ou annule la sélection d'un objet.
Syntaxe
expression. Select (SheetObject, SelectAction)
Expression Variable qui représente un objet Selection .
Parameters
Nom | Requis/Facultatif | Type de données | Description |
---|---|---|---|
SheetObject | Requis | [IVSHAPE] | Expression qui renvoie un objet Shape à sélectionner ou effacer. |
SelectAction | Requis | Integer | Type d'action de sélection à effectuer. |
Valeur renvoyée
Aucune
Remarques
Lorsqu’elle est utilisée avec l’objet Window , la méthode Select affecte la sélection dans la fenêtre Microsoft Visio. Toutefois, l’objet Selection est indépendant de la sélection dans la fenêtre. Par conséquent, l’utilisation de la méthode Select avec un objet Selection affecte uniquement l’état de l’objet en mémoire ; la fenêtre Visio n’est pas affectée.
Les constantes suivantes déclarées par la bibliothèque de types de Visio dans VisSelectArgs indiquent des valeurs valides pour les types de sélection.
Constante | Valeur | Description |
---|---|---|
visDeselect | 1 | Annule la sélection d'une forme, mais ne modifie pas le reste de la sélection. |
visSelect | 2 | Sélectionne une forme, mais ne modifie pas le reste de la sélection. |
visSubSelect | 3 | Sélectionne une forme dont le parent est déjà sélectionné. |
visSelectAll | 4 | Sélectionne une forme et tous ses homologues. |
visDeselectAll | 256 | Annule la sélection d'une forme et tous ses homologues. |
Si ActionSélection est visSubSelect, la forme parente de ObjetFeuille doit déjà être sélectionnée.
Vous pouvez combiner visDeselectAll avec visSelect et visSubSelect pour annuler la sélection de toutes les formes avant de sélectionner ou de sous-sélectionner d'autres formes.
Si l'objet traité est un objet Selection et si la méthode Select sélectionne un objet Shape dont la propriété ContainingShape est différente de la propriété ContainingShape de l'objet Selection, la méthode Select efface tout, même si la valeur de type de sélection n'indique pas d'effacer la sélection.
Si l'objet traité est un objet Window et si ActionSélection n'est pas visSubSelect, la forme parente de ObjetFeuille doit être la même forme que celle renvoyée par la propriété ContainingShape de l'objet Window.Selection.
Exemple
Cette macro Microsoft Visual Basic pour Applications (VBA) indique comment sélectionner, effacer et sous-sélectionner des formes.
Public Sub Select_Example()
Const MAX_SHAPES = 6
Dim vsoShapes(1 To MAX_SHAPES) As Visio.Shape
Dim intCounter As Integer
'Draw six rectangles.
For intCounter = 1 To MAX_SHAPES
Set vsoShapes(intCounter) = ActivePage.DrawRectangle(intCounter, intCounter + 1, intCounter + 1, intCounter)
Next intCounter
'Cancel the selection of all the shapes on the page.
ActiveWindow.DeselectAll
'Create a Selection object.
Dim vsoSelection As Visio.Selection
Set vsoSelection = ActiveWindow.Selection
'Select the first three shapes on the page.
For intCounter = 1 To 3
vsoSelection.Select vsoShapes(intCounter), visSelect
Next intCounter
'Group the selected shapes.
'Although the first three shapes are now grouped, the
'array vsoShapes() still contains them.
Dim vsoGroup As Visio.Shape
Set vsoGroup = vsoSelection.Group
'There are now four shapes on the page - a group that contains three
'subshapes, and three ungrouped shapes. Subselection is
'accomplished by selecting the parent shape first or one of the
'group's shapes already subselected.
'Select parent (group) shape.
ActiveWindow.Select vsoGroup, visDeselectAll + visSelect
'Subselect two of the shapes in the group.
ActiveWindow.Select vsoShapes(1), visSubSelect
ActiveWindow.Select vsoShapes(3), visSubSelect
'At this point two shapes are subselected, but we want to
'start a new selection that includes the last two shapes
'added to the page and the group.
'Note that the subselections that were made in the group
'are canceled by selecting another shape that is
'at the same level as the parent of the subselected shapes.
'Select just one shape.
ActiveWindow.Select vsoShapes(MAX_SHAPES), _
visDeselectAll + visSelect
'Select another shape.
ActiveWindow.Select vsoShapes(MAX_SHAPES - 1), visSelect
'Select the group.
ActiveWindow.Select vsoGroup, visSelect
'Select all but one shape on the page.
ActiveWindow.SelectAll
ActiveWindow.Select vsoShapes(MAX_SHAPES - 1), visDeselect
End Sub
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.