L’un des aspects le plus remarquable d’EXCEL réside dans sa capacité à dessiner une multitude de formes graphiques plus ou moins complexes, de pouvoir gérer leurs tailles, leurs couleurs, leurs positionnements, leurs comportements…

Ce tutoriel présente de façon concise ce qu’il est nécessaire de connaître pour manipuler les formes par programmation VBA. Seules les méthodes et propriétés de l’objet Shapes les plus utiles sont décrites.

Pour une référence exhaustive de l’objet Shapes, voir : https://learn.microsoft.com/fr-fr/office/vba/api/excel.shapes

(Les copies-écrans de ce tuto ont été réalisées à partir d’un classeur créé avec la version 365 d’EXCEL. Ce classeur est téléchargeable ici  )

QU’EST-CE QU’UNE FORME (SHAPE) POUR EXCEL ?

Pour EXCEL, la classe « Shape » (traduite ici par « Forme ») comprend une multitude d’objets graphiques.

Dans la figure ci-dessous, quelques objets graphiques membres de la classe ‘Shape‘:

Site cours Crypto-monnaies

Une forme (shape) peut être un objet « simple » comme une forme ‘automatique’ (une ligne, un carré…), une icône, une image ou bien un objet « complexe » comme un graphique, un objet SmartArt, un modèle 3D

LISTONS TOUTES LES FORMES CONTENUES DANS UNE FEUILLE

La collection ‘Shapes’ d’une feuille de calcul regroupe la collection de toutes les formes (shapes) présentes dans une feuille.

Le fragment de code ci-dessous énumère dans la fenêtre d’exécution les noms de toutes les formes présentes dans la feuille ‘ShapesSamples’ » donnée en exemple :

Sub ListerShapes()
    Dim oSheet As Worksheet, oSheetEnumeration As Worksheet
    Dim oShape As Shape
    Dim oLO As ListObject
    Dim oRange As Range, oCell As Range
    Dim sShapetype As String
    Dim v As Variant
    
    Set oSheet = ThisWorkbook.Worksheets("ShapesSamples")
    Set oSheetEnumeration = ThisWorkbook.Worksheets("ShapesTypesList")
    'On affecte l'objet Tableau structuré contenant les libellés des types de formes
    Set oLO = oSheetEnumeration.ListObjects("tblShapesTypes")
    Set oRange = oLO.ListColumns("Index").DataBodyRange
    
    'On parcourt toutes les formes de la feuille
    For Each oShape In oSheet.Shapes
        'On recherche le libellé du type de forme dans la table à partir de son index
        v = Application.Match(oShape.Type, oRange, 0)
        If Not IsError(v) Then
            sShapetype = oLO.ListColumns("Description").DataBodyRange.Cells(v, 1).Value
        Else
            sShapetype = "???"
        End If
        'On envoie les informations de la forme dans la fenêtre d'exécution
        Debug.Print "Index:" & oShape.ID & "-" & sShapetype & "-" & oShape.Name
    Next
    
    'On fait le ménage
    Set oSheet = Nothing
    Set oLO = Nothing
    Set oSheetEnumeration = Nothing
End Sub

Rappel : pour afficher la fenêtre d’exécution dans le VBE,  actionner Ctrl+G – Voir l’article BONNES PRATIQUES EXCELLONS : ‘Utilisons les outils de débogage

VBA_InventaireFormes

UTILISONS L’ENREGISTREUR DE MACROS

Du fait de la richesse et de la diversité des méthodes et propriétés exposées par les formes (shapes), nous gagnons beaucoup de temps en utilisant, dans un premier temps, l’enregistreur de macros.

Dans un second temps, nous corrigerons le code généré pour l’adapter et/ou le simplifier.

Pour une bonne utilisation de l’enregistreur de macros, reportons-nous à l’article BONNES PRATIQUES EXCELLONS :  Comment bien utiliser l’enregistreur de macros.

REFERENÇONS LES FORMES DANS LE CODE VBA

Référençons par index

Nous pouvons référencer une forme par son index dans la collection des « Shapes » de la feuille. Par exemple, pour nous référer à la forme d’index 3 dans la feuille :

Set oShape = oSheet.Shapes(3)

Cette méthode de référencement n’est ni très pratique ni très explicite, aussi privilégions le référencement pas nom.

 

Référençons par nom

Lorsque nous créons une forme dans une feuille (manuellement ou par code), EXCEL lui affecte un nom par défaut. Ce nom reprend le type de forme et y ajoute une numérotation chronologique. Par exemple :

« Image 7 »

Nous référençons cette forme par nom de la façon suivante :

     Set oShape = oSheet.Shapes(“Image 7”)

Aux noms affectés par défaut par EXCEL, il est préférable que nos formes portent des noms explicites.

 

Affectons un nom explicite

Nous affectons un nom explicite par VBA à nos formes en modifiant la propriété « Name » de la forme.

Par exemple :

 Set oShape = oSheet.Shapes(“Image 7”)

oShape.Name = “Excellons_Logo”

ATTENTION : Excel ne vérifie pas l’unicité des noms affectés. Si nous donnons le même nom à 2 formes différentes, lorsque, dans le VBA, nous affecterons un object Shape avec un nom dupliqué, l’affectation ne se réalisera que sur l’une des 2 formes.

INSERONS UN GRAPHE DANS UNE FEUILLE

Pour réaliser par VBA l’insertion d’un graphe dans une feuille tel que nous le faisons dans EXCEL en activant l’un des boutons suivants du ruban :

Ruban Insertion Graphiques

nous utilisons la méthode AddChart2 de l’objet Shapes : expression.AddChart2 (StyleXlChartTypeLeftTopWidthHeightNewLayout)

La liste des types de graphe (XlChartType) est disponible à la page : https://learn.microsoft.com/fr-fr/office/vba/api/excel.xlcharttype

(La méthode AddChart2 a été introduite avec la version 2013 d’EXCEL. Dans les versions précédentes c’est la méthode AddChart qui doit être utilisée). 

Cet article est focalisé sur l’objet Formes (Shape), il ne traite pas en détail des méthodes et propriétés de l’objet ‘Chart’.

Le fragment de code suivant créée un graphe de type secteur à partir de données présentes dans la plage P3:P12 de la feuille ‘Resultats’ du classeur exemple : 

Sub AddGraph()
    Dim oSheet As Worksheet
    Dim oShape As Shape
    Dim oChart As Chart
    
    Set oSheet = ThisWorkbook.Worksheets("Resultats")
    
    'On insère le graphe dans la feuille avec la méthode AddChart2
    Set oShape = oSheet.Shapes.AddChart2(333, xl3DPie, , , , True)
    With oShape
        'On référence l'objet Chart
        Set oChart = oShape.Chart
        With oChart
            'On affecte la source de données du graphe
            .SetSourceData oSheet.Range("P3:P12")
            'On donne un titre au graphe
            .ChartTitle.Text = "MON GRAPHE"
        End With
    End With
End Sub

Résultat obtenu :

Exemple de graphe obtenu par VBA

INSERONS UNE LEGENDE DANS UNE FEUILLE

Pour réaliser par VBA l’insertion d’une légende dans une feuille tel que nous le faisons dans EXCEL en activant l’un des boutons suivants du ruban :

Boutons Bulles et Légendes

nous utilisons la méthode AddCallout de l’objet Shapes : expressionAddCallout (TypeLeftTopWidthHeight)

La liste des types de légende (msoCalloutType) est disponible à la page : https://learn.microsoft.com/fr-fr/office/vba/api/office.msocallouttype

Le fragment de code suivant créée une légende de type lien unique à droite dans la feuille ‘Resultats’ du classeur exemple :

Sub AddLegend()
    Dim oSheet As Worksheet
    Dim oShape As Shape
    
    Set oSheet = ThisWorkbook.Worksheets("Resultats")
    Set oShape = oSheet.Shapes.AddCallout(msoCalloutOne, 50, 50, 80, 100)    
End Sub

Résultat obtenu :

Légende

INSERONS UNE COURBE DE BEZIER DANS UNE FEUILLE

Pour réaliser par VBA l’insertion d’une courbe de Bézier dans une feuille tel que nous le faisons dans EXCEL en activant le bouton du ruban suivant :
Bouton Courbe de Bézier

nous utilisons la méthode AddCurve de l’objet Shapes : expressionAddCurve (SafeArrayOfPoints).

La liste des points de la courbe est fournie à la méthode ‘AddCurve’ dans un tableau de valeurs.

Le fragment de code suivant créée une courbe de Bézier en Z avec des coordonnées de début (210,130) et de fin (315,225) :

Sub AddCourbeBezier()
    Dim oSheet As Worksheet
    Dim oShape As Shape
    Dim aPoints(1 To 7, 1 To 2) As Single
    
    'On rempli le tableau de coordonnées des points de la courbe de Bézier
    aPoints(1, 1) = 210
    aPoints(1, 2) = 130
    aPoints(2, 1) = 270
    aPoints(2, 2) = 150
    aPoints(3, 1) = 280
    aPoints(3, 2) = 160
    aPoints(4, 1) = 280
    aPoints(4, 2) = 175
    aPoints(5, 1) = 200
    aPoints(5, 2) = 190
    aPoints(6, 1) = 210
    aPoints(6, 2) = 205
    aPoints(7, 1) = 315
    aPoints(7, 2) = 225
    
    Set oSheet = ThisWorkbook.Worksheets("Resultats")
    Set oShape = oSheet.Shapes.AddCurve(aPoints())
End Sub

Résultat obtenu :

Courbe de Bézier

INSERONS UN CONTROLE DE FORMULAIRE DANS UNE FEUILLE

Pour réaliser par VBA l’insertion d’un contrôle de formulaire légende dans une feuille tel que nous le faisons dans EXCEL en activant l’un des boutons suivants du ruban :
Boutons contrôles de formulaire

nous utilisons la méthode AddFormControl de l’objet Shapes : expressionAddFormControl (TypeLeftTopWidthHeight)

La liste des types de contrôles de formulaires (XlFormControl) est disponible à la page : https://learn.microsoft.com/fr-fr/office/vba/api/excel.xlformcontrol

Le fragment de code suivant insère un contrôle de liste déroulante dans la feuille ‘Resultats’ du classeur exemple :

Sub AddCombobox()
    Dim oSheet As Worksheet
    Dim oShape As Shape
    
    Set oSheet = ThisWorkbook.Worksheets("Resultats")
    Set oShape = oSheet.Shapes.AddFormControl(xlDropDown, 5, 5, 55, 15)
End Sub

Résultat obtenu :

Liste déroulante

INSERONS UN LIEN VERS UN OBJET EXTERNE DANS UNE FEUILLE

Pour réaliser par VBA l’insertion d’un lien vers un objet externe dans une feuille tel que nous le faisons dans EXCEL en activant le bouton du ruban suivant :

Bouton Objet Incorporé

nous utilisons la méthode AddOLEObject de l’objet Shapes : expressionAddOLEObject (ClassTypeFileNameLinkDisplayAsIconIconFileNameIconIndexIconLabelLeftTopWidthHeight).

Les objets que l’on peut incorporer par cette méthode peuvent être des fichiers externes ou des classes particulières d’objets. Pour plus de détail, nous nous reporterons utilement à la page : https://learn.microsoft.com/fr-fr/office/vba/api/excel.shapes.addoleobject.

Le fragment de code suivant créée un lien vers un document PDF particulier dans la feuille “Resultats”:

Sub AddPDF()
    Dim oSheet As Worksheet
    Dim oShape As Shape
    Dim oRange As Range
    
    Set oSheet = ThisWorkbook.Worksheets("Resultats")
    Set oShape = oSheet.Shapes.AddOLEObject(, ThisWorkbook.Path & "\MonPDF.pdf", False, True, "C:\WINDOWS\Installer\{AC76BA86-1036-1033-7760-BC15014EA700}\_PDFFile.ico", 0, "Mon PDF", 5, 5, 50, 50)

End Sub

Résultat obtenu :

Lien vers document PDF

INSERONS UNE IMAGE DANS UNE FEUILLE

Pour réaliser par VBA l’insertion d’une Image dans une feuille tel que nous le faisons dans EXCEL en activant le bouton suivant du ruban :

Bouton Images

nous utilisons la méthode AddPicture2 de l’objet Shapes : expressionAddPicture2 (FileNameLinkToFileSaveWithDocumentLeftTopWidthHeightcompress).

Le fragment de code suivant insère une image dans la feuille ‘Resultats’ du classeur exemple :

Sub AddImage()
    Dim oSheet As Worksheet
    Dim oShape As Shape
    Dim oRange As Range
    
    Set oSheet = ThisWorkbook.Worksheets("Resultats")
    Set oShape = oSheet.Shapes.AddPicture2(ThisWorkbook.Path & "\Logo_Excellons.png", msoFalse, msoTrue, 5, 5 _
                        , Application.CentimetersToPoints(9), Application.CentimetersToPoints(4), True)
End Sub

Résultat obtenu :

Image insérée

INSERONS UNE FORME ‘AUTOMATIQUE’ DANS UNE FEUILLE

Pour réaliser par VBA l’insertion d’une forme ‘automatique’ dans une feuille tel que nous le faisons dans EXCEL en activant l’un des boutons suivants du ruban :
Formes 'Automatiques'

nous utilisons la méthode AddShape de l’objet Shapes : expression. AddShape (Type, Left, Top, Width, Height).

La liste des types de formes ‘automatiques’ (msoAutoShapeType) est disponible à la page : https://learn.microsoft.com/fr-fr/office/vba/api/office.msoautoshapetype

Le fragment de code suivant insère une forme de type « Bouton en relief » dans la feuille “Resultats”:

Sub AddFormAuto()
    Dim oSheet As Worksheet
    Dim oShape As Shape
    Dim oRange As Range
    
    Set oSheet = ThisWorkbook.Worksheets("Resultats")
    Set oShape = oSheet.Shapes.AddShape(msoShapeBevel, 5, 5, 50, 50)
End Sub

Résultat obtenu :

Bouton Relief

INSERONS UN GRAPHIQUE SMARTART DANS UNE FEUILLE

Pour réaliser par VBA l’insertion d’un graphique SmartArt dans une feuille tel que nous le faisons dans EXCEL en activant le bouton suivant du ruban :
Bouton SmartArt

nous utilisons la méthode AddSmartArt de l’objet Shapes : expressionAddSmartArt (LayoutLeftTopWidthHeight).

L’application EXCELLONS SMARTART_Reference.xlsm fournit une référence complète aux graphiques SmartArt.

Le fragment de code suivant insère un graphique SmartArt de type ‘entonnoir’ dans la feuille ‘Resultats’ du classeur exemple :

Sub AddCone()
    Dim oSheet As Worksheet
    Dim oShape As Shape
    Dim oSaLayout As SmartArtLayout
    
    Set oSheet = ThisWorkbook.Worksheets("Resultats")
    'On pointe sur l'illustration 'Entonnoir'
    Set oSaLayout = Application.SmartArtLayouts(68)
    'On créé une nouvelle forme contenant l'illustration voulue
    Set oShape = oSheet.Shapes.AddSmartArt(oSaLayout, 5, 5)
    'On affecte une couleur à la forme
    oShape.SmartArt.Color = Excel.Application.SmartArtColors(4)
End Sub

Résultat obtenu :

SmartArt Entonnoir

REPOSITIONNONS UNE FORME DANS LA FEUILLE

 

Positionnons la forme lors de sa création

A la création d’une forme au moyen de l’une des méthodes de l’objet Shapes, nous indiquons la position de son coin supérieur gauche exprimée en points.

(Si besoin, pour convertir les centimètres en points, nous disposons de la fonction Application.CentimetersToPoints ).

Ainsi, par exemple, pour positionner la forme à 1 centimètre à gauche et 1 centimètre en haut de la feuille au moment de sa création, nous écrirons :

Set oShape = oSheet.AddShape(msoShapeBevel, Application.CentimetersToPoints(1), Application.CentimetersToPoints(1), …)

Repositionnons une forme

Pour repositionner une forme, nous modifions ses propriétés « Left » et « Top » en indiquant leurs nouvelles valeurs en points (ou en centimètres en utilisant la fonction ‘Application.CentimetersToPoints’).

Ainsi, par exemple, pour repositionner une forme à 50 points à gauche et 50 points en haut de la feuille nous écrirons :

oShape.Left = 50
oShape.Top = 50

Repositionnons une forme par rapport à une cellule

Pour repositionner une forme par rapport à une cellule, nous référencerons les propriétés « Left » et « Top » de la cellule.

Ainsi, par exemple, pour repositionner une forme sur le coin haut-Gauche de la cellule « D4 » nous écrirons :

Set oRange = oSheet.Range(“D4”)
oShape.Left = oRange.Left
oShape.Top = oRange.Top

Gérons la propriété « Placement »

La propriété « Placement » de l’objet « Shape » nous permet de gérer le comportement des formes lors du redimensionnement des cellules.
Elle peut prendre l’une des valeurs suivantes :

xlFreeFloating = la forme conserve son positionnement lorsque les cellules sous-jacentes sont redimensionnées.
xlMove = la forme se déplace avec les cellules sous-jacentes (sans être redimensionnée).
xlMoveAndSize = la forme se déplace et se redimensionne avec les cellules sous-jacentes.

L’application EXCELLONS SmartTrombinoscope.xlsm fournit un exemple de mise en oeuvre de positionnements complexes de formes dans une feuille.

REDIMENSIONNONS  UNE FORME OU UN ENSEMBLE DE FORME

Dimensionnons la forme lors de sa création

A la création d’une forme au moyen de l’une des méthodes de l’objet Shapes, nous indiquons la largeur et la hauteur de la forme exprimées en points.

(Si besoin, pour convertir les centimètres en points, nous disposons de la fonction Application.CentimetersToPoints ).

Ainsi, par exemple, pour dimensionner un rectangle biseauté à 100 points de large et 100 points de haut, nous écrirons lors de sa création, :

Set oShape = oSheet.AddShape(msoShapeBevel, …, …,100,100)

Redimensionnons une forme

Pour redimensionner une forme, nous modifions ses propriétés « Width » et « Height » en indiquant leurs nouvelles valeurs en points (ou en centimètres en utilisant la fonction ‘Application.CentimetersToPoints’).

Ainsi, par exemple, pour redimensionner une forme à 200 de large et 200 points de haut, nous écrirons :

oShape.Width = 200
oShape.Height = 200
 

Redimensionnons une forme par rapport à une cellule ou une plage de cellules

Pour redimensionner une forme par rapport à la taille d’une cellule ou d’une plage de cellules, nous référencerons les propriétés « Width » et « Height » de la cellule ou de la plage de cellules.

Ainsi, par exemple, pour redimensionner une forme à la taille de la plage de cellules « D4:F6  » nous écrirons :

Set oRange = oSheet.Range(“D4:F6”)
oShape.Width = oRange.Width
oShape.Height = oRange.Height

Gérons la propriété ‘LockAspectRatio‘ 

 

La propriété « LockAspectRatio » de l’objet Shape permet de gérer le comportement des formes lors du redimensionnement.

Elle prend les valeurs suivantes :

  • msoTrue = la forme se redimensionne en conservant ses proportions. Si, par exemple, la largeur de la forme est modifiée, sa hauteur se redimensionne proportionnellement.
  • msoFalse = la forme ne conserve pas ses proportions. Si, par exemple, la largeur de la forme est modifiée, sa hauteur reste inchangée.

 

Redimensionnons un ensemble de formes avec les méthodes ‘ScaleWidth-ScaleHeight’

Avec les méthodes « ScaleWidth » et « ScaleHeight » nous diminuons ou augmentons proportionnellement la taille des formes en largeur (ScaleWidth) ou en hauteur (ScaleHeight).

Ce fragment de code, diminue la taille des formes d’une feuille de la moitié de leurs tailles initiales :

Sub ShrinkAllShapes()
    Dim oSheet As Worksheet
    Dim oShape As Shape
    
    Set oSheet = ThisWorkbook.Worksheets("ShapesSamples")
    'On parcourt toutes les formes présentes dans la feuille
    For Each oShape In oSheet.Shapes
        'On conserve les proportions de la forme
        oShape.LockAspectRatio = msoTrue
        'Dans le cas où la forme ne supporte pas la méthode ScaleWidth, on ignore l'erreur
        On Error Resume Next
        'On diminue la taille de la forme de moitié = 50%
        oShape.ScaleWidth 0.5, msoTrue
        'On rétablit la gestion des erreurs
        On Error GoTo 0
    Next
End Sub

ATTENTION : Certaines formes ne supportent pas la méthode ‘ScaleWidth’ , c’est la raison pour laquelle l’instruction ‘On Error Resume Next’ est utilisée dans ce fragment de code.

Pour la gestion des erreurs d’exécution, reportons-nous au document BONNES PARTIQUES EXCELLONS : VBA_GestionErreurs.pdf

 

L’application EXCELLONS SmartTrombinoscope.xlsm fournit un exemple de mise en oeuvre du dimensionnement complexes de formes dans une feuille.

AJOUTONS DU TEXTE A UNE FORME ET FORMATONS-LE

 

Toutes les formes (shapes) exposent la propriété TextFrame permettant d’ajouter du texte à une forme au moyen de code VBA.

Par exemple pour ajouter du texte à une forme MaLegende présente dans la feuille ‘Resultats” du classeur exemple, nous écrirons :

Sub AddTextToLegend()
    Dim oSheet As Worksheet
    Dim oShape As Shape
    
    Set oSheet = ThisWorkbook.Worksheets("Resultats")
    Set oShape = oSheet.Shapes("MaLegende")
    oShape.TextFrame.Characters.Text = "EXCELLONS.org : c'est le top !"
End Sub

Résultat obtenu :

Texte ajouté à une forme légende

L’objet Textframe expose la méthode Characters permettant de formater le texte d’une forme (police, taille, couleur…). Deplus, il possède un ensemble de propriétés que l’on peut valoriser par code VBA.

Par exemple, le fragment de code suivant formate le texte ajouté à la forme MaLegende présente dans la feuille ‘Resultats” du classeur exemple :

Sub FormatTextToLegend()
    Dim oSheet As Worksheet
    Dim oShape As Shape
    
    Set oSheet = ThisWorkbook.Worksheets("Resultats")
    Set oShape = oSheet.Shapes("MaLegende")
    
    'Formatons les 13 premiers caractères du texte : corps 12, en gras et en vert
    With oShape.TextFrame.Characters(1, 13).Font
        .Color = RGB(0, 255, 0)
        .Size = 12
        .Bold = True
    End With
    'Formatons les 14 caractères à la partir de la position 17 du texte: corps 16, en gras, en rouge et soulignés
    With oShape.TextFrame.Characters(17, 14).Font
        .Color = RGB(255, 0, 0)
        .Size = 16
        .Bold = True
        .Underline = xlUnderlineStyleSingle
    End With
    
    'Centrons le texte horizontalement et verticalement
    oShape.TextFrame.HorizontalAlignment = xlHAlignCenter
    oShape.TextFrame.VerticalAlignment = xlVAlignCenter
End Sub

Résultat obtenu :

Texte de légende formaté

MODIFIONS LES COULEURS ET LE REMPLISSAGE D’UNE FORME

 

Les formes (shapes) exposent un ensemble de propriétés permettant d’agir sur la couleur et le type des contours ainsi que sur la couleur et le remplissage de l’intérieur de la forme.

A titre d’exemple, le fragment de code suivant trace une pentagone, définit ses contours en tant que tirets, les colorise en rouge et remplit son intérieur de briquettes de couleur verte :

Sub TracePentagone()
    Dim oSheet As Worksheet
    Dim oShape As Shape
    Dim oRange As Range
    Dim aPoints(1 To 6, 1 To 2) As Single
    
    'On affecte les coordonnées des sommets du pentagone
    aPoints(1, 1) = 520
    aPoints(1, 2) = 93
    aPoints(2, 1) = 433
    aPoints(2, 2) = 211
    aPoints(3, 1) = 180
    aPoints(3, 2) = 194
    aPoints(4, 1) = 70
    aPoints(4, 2) = 76
    aPoints(5, 1) = 232
    aPoints(5, 2) = 51
    aPoints(6, 1) = 520 'le dernier sommet possède des coordonnées identiques au premier sommet
    aPoints(6, 2) = 93  '-> pour fermer le polygone
    
    Set oSheet = ThisWorkbook.Worksheets("Resultats")
    'On insère le pentagone dans la feuille
    Set oShape = oSheet.Shapes.AddPolyline(aPoints)
    With oShape
        'On colorise les bordures du pentagone en tirets rouges
        With .Line
            .DashStyle = msoLineDashDotDot
            .ForeColor.RGB = RGB(255, 0, 0)
        End With
        'On remplit le pentagone de briques vertes
        With .Fill
            .Patterned msoPatternHorizontalBrick
            .BackColor.RGB = RGB(0, 255, 0)
        End With
    End With
End Sub

Résultat obtenu :

Pentagone rouge et vert

(Bon d’accord, ce résultat n’est pas esthétiquement très réussi…) 

ASSIGNONS UNE MACRO EXECUTEE LORS DU CLIC SUR UNE FORME

 

La propriété ‘OnAction’ permet d’exécuter une macro donnée lors du clic sur une forme.

Soit, par exemple, la macro suivante à exécuter lors du clic sur une forme :

Sub displayInfo()
    MsgBox "Lien vers EXCELLONS.org: " & vbCrLf _
         & "https://excellons.org/" _
         , vbExclamation, "MESSAGE DE LA PLUS HAUTE IMPORTANCE !"
End Sub

Assignons l’exécution de cette macro lors d’un clic sur la forme ‘MaLegende’ de la façon suivante :

Sub assignMacro()
    Dim oSheet As Worksheet
    Dim oShape As Shape
    
    Set oSheet = ThisWorkbook.Worksheets("Resultats")
    Set oShape = oSheet.Shapes("MaLegende")
    
    oShape.OnAction = "displayInfo"
End Sub

Résultat obtenu lors du clic sur la forme :

Action sur clic

RELIONS DES FORMES ‘AUTOMATIQUES’ AVEC DES CONNECTEURS

 

Nous pouvons par VBA relier des formes ‘Automatiques’ (AutoForm) au moyen de formes connecteurs (msoConnectorElbow) et ainsi obtenir, par exemple, une résultat de type ordinogramme :

Action sur clic

Pour obtenir ce résultat, procédons de la façon suivante :

  • Créeons, colorisons et positionnons sur la feuille autant de formes ‘automatiques’ que nécessaire. Dans notre exemple, 4 formes de plusieurs sortes au moyen du code VBA suivant :
Sub Add4Shapes()
    Dim oSheet As Worksheet
    Dim oShape As Shape
    
    'On référençe la feuille cible
    Set oSheet = ThisWorkbook.Worksheets("Resultats")
    
    'Insérons la forme 'Database'
    InsertNewShape oSheet, msoShapeFlowchartMagneticDisk, "BaseSQL", "B2:B6", msoThemeColorAccent4, "Base SQL"
    
    'On insère la forme 'Traitement'
    InsertNewShape oSheet, msoShapeFlowchartProcess, "Traitement", "C9:D12", msoThemeColorAccent6, "Traitement"
    
    'On insère la forme 'Etats'
    InsertNewShape oSheet, msoShapeFlowchartMultidocument, "Etats", "B16:B19", msoThemeColorAccent5, "Etats 1,2,3..."
    
    'On insère la forme 'Ecran'
    InsertNewShape oSheet, msoShapeFlowchartDisplay, "Display", "E16:E19", msoThemeColorAccent5, "Ecran"
End Sub
Sub InsertNewShape(zSheet As Worksheet, zShapeType As MsoAutoShapeType, zShapeName As String, zShapeRange As String, zColor As Variant, zTexte As String)
    Dim oShape As Shape
    Dim oRange As Range
    
    'On référence la plage de cellules transmise pour le positionnement
    Set oRange = zSheet.Range(zShapeRange)
    
    'On ajoute la forme voulue à partir des paramètres transmis et des propriétés de la plage de cellules transmise
    Set oShape = zSheet.Shapes.AddShape(zShapeType, oRange.Left, oRange.Top, oRange.Width, oRange.Height)
    
    With oShape
        'On affecte à la forme le nom transmis
        .Name = zShapeName
        'On affecte à la forme la couleur transmise
        .Fill.ForeColor.ObjectThemeColor = zColor
        
        'On affecte et formate le texte contenu dans la forme
        With .TextFrame
            With .Characters
                .Text = zTexte
                .Font.Bold = True
                .Font.Color = vbBlack
            End With
            'On positionne le texte dans la forme
            .HorizontalAlignment = xlHAlignCenter
            .VerticalAlignment = xlVAlignCenter
        End With
    End With
    
End Sub

 

  • Maintenant, relions les formes avec des connecteurs. Les méthodes Beginconnect et Endconnect, propres aux objects Connectors permettent de relier 2 formes entre-elles. Dans notre exemple, les 4 formes sont reliées au moyen du code VBA suivant :
Sub AddConnectors()
    Dim oSheet As Worksheet
    Dim oShape1 As Shape, oShape2 As Shape
    Dim oRange As Range
    
    'On référençe la feuille cible
    Set oSheet = ThisWorkbook.Worksheets("Resultats")
    
    'On connecte la forme 'Database' à la forme "Traitement"
    Set oShape1 = oSheet.Shapes("BaseSQL")
    Set oShape2 = oSheet.Shapes("Traitement")
    InsertConnector oSheet, oShape1, oShape2, 5, 1

    'On connecte la forme 'Traitement' à la forme "Etats"
    Set oShape1 = oSheet.Shapes("Traitement")
    Set oShape2 = oSheet.Shapes("Etats")
    InsertConnector oSheet, oShape1, oShape2, 3, 1

    'On connecte la forme 'Traitement' à la forme "Display"
    Set oShape1 = oSheet.Shapes("Traitement")
    Set oShape2 = oSheet.Shapes("Display")
    InsertConnector oSheet, oShape1, oShape2, 3, 1

End Sub
Sub InsertConnector(zSheet As Worksheet, zShape1 As Shape, zShape2 As Shape, zPoint1 As Long, zPoint2 As Long)
    Dim oConnector As Shape
    Dim oRange As Range
    
    'On insère le connecteur en utilisant les paramètres transmis
    Set oConnector = zSheet.Shapes.AddConnector(msoConnectorElbow, 120, 50, 200, 100)    
    
    With oConnector
        'On formate le connecteur
        .Line.Weight = 1.75
        .Line.ForeColor.ObjectThemeColor = msoThemeColorDark2
        .Line.EndArrowheadStyle = msoArrowheadTriangle
        'On relie les 2 formes passées en paramètres avec le connecteur suivant les 2 points passés en paramètres
        .ConnectorFormat.BeginConnect zShape1, zPoint1
        .ConnectorFormat.EndConnect zShape2, zPoint2
    End With
End Sub

Les méthodes BeginConnect et EndConnect réclament comme second paramètre obligatoire SiteConnection indiquant le point d’ancrage du connecteur sur la forme à relier.

Ce point d’ancrage est à choisir parmi les points d’ancrage existants pour la forme à relier. ‘SiteConnection’ est un entier dont la valeur se situe entre ‘1’ et le nombre maximum de points d’ancrage de la forme. Chaque type de forme possède sa propre collection de points d’ancrage. Le nombre maximum de points d’ancrage d’une forme est retourné par la propriété ConnectionSiteCount de la forme.

Il n’est pas aisé de connaitre a priori le numéro du point d’ancrage pour pour positionner le connecteur à un point d’ancrage précis d’une forme. Si, comme dans notre exemple, nous désirons positionner les connecteurs à des points bien spécifiques des formes, le plus simple est d’utiliser l’enregistreur de macro pour déterminer les numéros de ces points.

Une autre option consiste à indiquer dans un premier temps, comme point d’ancrage ‘1’ et d’utiliser la méthode Rerouteconnections de l’objet ‘Connector’. Cette méthode a pour effet de prendre le chemin le plus court entre les deux formes reliées.

Q