Méthode Master.InsertObject (Visio)

  • Article

Ajoute un nouvel objet incorporé ou un contrôle ActiveX à une page, une forme de base ou un groupe.

Syntaxe

expression. InsertObject( _ClassOrProgID_ , _Flags_ )

Expression Variable qui représente un objet Master .

Paramètres

Nom Requis/Facultatif Type de données Description
ClassOrProgID Obligatoire String Identifie le type d'objet ou de contrôle à créer.
Flags Obligatoire Integer Indicateurs qui influencent l'opération.

Valeur renvoyée

Shape

Remarques

IDClasseOuProg est une chaîne qui identifie le type d'objet ou de contrôle à créer. Il peut s'agir de l'ID de classe (GUID) de l'objet ou du contrôle sous forme de chaîne ou de l'ID de programme de l'objet ou du contrôle du gestionnaire de la classe.

  • Si IDClasseOuProg est une chaîne représentant un ID de classe, il se présente de la manière suivante : « {D3E34B21-9D75-101A-8C3D-00AA001A1652} ».

  • Si IDClasseOuProg est une chaîne représentant un ID de programme, il se présente de la manière suivante : « paint.picture » ou « forms.combobox.1 ».

Reportez-vous à la documentation du fournisseur ou parcourez le registre pour déterminer les ID de classe et de programme qui sont associés aux objets et aux contrôles fournis par d'autres applications.

L'argument Indicateurs est un masque binaire qui peut comprendre l'une des valeurs suivantes :

Constante Valeur Description
visInsertIcon &H10 Affiche la nouvelle forme en tant qu'icône.
visInsertDontShow &H1000 N'exécute pas la commande d'affichage du nouvel objet.

Si visInsertIcon et visInsertDontShow sont tous deux spécifiés, la méthode InsertObject échoue. Si vous souhaitez insérer un objet qui s'affiche comme une icône, vous devez permettre à l'application d'exécuter la commande d'affichage de l'objet.

L'argument Indicateurs peut également comprendre l'une des valeurs suivantes :

Constante Valeur
visInsertAsControl &H2000
visInsertAsEmbed &H4000

Les valeurs de visInsertAsControl et visInsertAsEmbed n'ont d'effet que si la classe identifiée par IDClasseOuProg est définie dans le registre comme un contrôle qui peut être inséré. Si ni visInsertAsControl, ni visInsertAsEmbed ne sont indiqués et si l'objet peut être soit un contrôle soit un objet incorporé, l'application l'insère comme un contrôle.

Dans de rares cas, Visio 5.0, ou versions ultérieures, peut insérer un contrôle tandis que les versions précédentes de Visio répondent au même appel en insérant un objet incorporé. Si un contrôle est inséré, cette méthode met le document en mode création, entraînant l'arrêt de l'exécution de tout code dans le document jusqu'à ce que celui-ci soit renvoyé au mode exécution.

Attention

Soyez prudent lorsque vous ajoutez des contrôles ActiveX à votre application. Les contrôles ActiveX peuvent être conçus de manière à ce que leur utilisation puisse poser un problème de sécurité. Nous vous recommandons d’utiliser des contrôles provenant de sources approuvées uniquement. Signez tous les contrôles que vous créez.

Avertissement

La modification du Registre Windows de quelque manière que ce soit, par le biais de l’Éditeur du Registre ou par programmation, comporte toujours un certain degré de risque. Une modification incorrecte peut entraîner de graves problèmes, pouvant nécessiter la réinstallation du système d’exploitation. Nous vous recommandons de toujours sauvegarder le registre d’un ordinateur avant de le modifier.

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.