OLEObjects.Add, méthode (Excel)

Cette méthode ajoute un nouvel objet OLE à une feuille.

Syntaxe

expression. Add (ClassType, FileName, Link, DisplayAsIcon, IconFileName, IconIndex, IconLabel, Left, Top, Width, Height)

expression Variable qui représente un objet OLEObjects .

Paramètres

Nom	Requis/Facultatif	Type de données	Description
ClassType	Facultatif	Variant	Vous devez spécifier ClassType ou FileName. Chaîne qui contient l'identificateur de programmation pour que l'objet soit créé. Si ClassType est spécifié, FileName et Link sont ignorés.
FileName	Facultatif	Variant	Vous devez spécifier ClassType ou FileName. Chaîne qui indique le fichier à utiliser pour créer l’objet OLE.
Link	Facultatif	Variant	True pour que le nouvel objet OLE reposant sur FileName soit lié à ce fichier. Si l'objet n'est pas lié, il est créé en tant que copie du fichier. La valeur par défaut est False.
DisplayAsIcon	Facultatif	Variant	True pour afficher le nouvel objet OLE sous la forme d'une icône ou de son image habituelle. Si cet argument a la valeur True, IconFileName et IconIndex peuvent être utilisés pour spécifier une icône.
IconFileName	Facultatif	Variant	Chaîne qui spécifie le fichier contenant l'icône à afficher. Cet argument est utilisé uniquement si DisplayAsIcon a la valeur True. Si cet argument n'est pas spécifié ou si le fichier ne contient pas d'icône, l'icône par défaut de la classe OLE est utilisée.
IconIndex	Facultatif	Variant	Numéro de l'icône dans le fichier d'icône. Elle est utilisée uniquement si DisplayAsIcon a lavaleur True et IconFileName fait référence à un fichier valide qui contient des icônes. S'il n'y a pas d'icône avec le numéro d'index donné dans le fichier spécifié par IconFileName, c'est la première icône du fichier qui est utilisée.
IconLabel	Facultatif	Variant	Chaîne qui spécifie une étiquette à afficher sous l'icône. Elle est utilisée uniquement si DisplayAsIcon a la valeur True. Si cet argument est omis ou est une chaîne vide (""), aucune légende n'est affichée.
Left	Facultatif	Variant	Coordonnées initiales du nouvel objet, en points, par rapport au coin supérieur gauche de la cellule A1 d’une feuille de calcul ou au coin supérieur gauche d’un graphique.
Top	Facultatif	Variant	Coordonnées initiales du nouvel objet, en points, par rapport au haut de la ligne 1 d’une feuille de calcul ou au haut de la zone de graphique d’un graphique.
Width	Facultatif	Variant	Largeur initiale du nouvel objet, en points.
Height	Facultatif	Variant	Hauteur initiale du nouvel objet, en points.

Valeur renvoyée

Objet OLEObject qui représente le nouvel objet OLE.

Exemple

Cet exemple montre comment créer un nouvel objet OLE Microsoft Word dans la feuille Sheet1.

ActiveWorkbook.Worksheets("Sheet1").OLEObjects.Add _ 
 ClassType:="Word.Document"

Cet exemple montre comment ajouter un bouton de commande sur la feuille Sheet1.

Worksheets(1).OLEObjects.Add ClassType:="Forms.CommandButton.1", _ 
 Link:=False, DisplayAsIcon:=False, Left:=40, Top:=40, _ 
 Width:=150, Height:=10

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.