Vcl.OleAuto.CreateOleObject

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function CreateOleObject(const ClassName: string): Variant;

C++

extern DELPHI_PACKAGE System::Variant __fastcall CreateOleObject(const System::UnicodeString ClassName);

Propriétés

Type Visibilité  Source Unité  Parent
function public
Vcl.OleAuto.pas
Vcl.OleAuto.hpp
Vcl.OleAuto Vcl.OleAuto

Description

Instancie un objet Automation.

CreateOleObject crée un objet unique non initialisé de la classe spécifiée par le paramètre ClassName. ClassName spécifie la représentation sous forme de chaîne de l'identificateur de classe (CLSID). CreateOleObject permet de créer un objet d'un type spécifié lorsque le CLSID est connu et lorsque l'objet est sur un serveur local ou en processus. Les objets ne faisant pas partie d'un agrégat sont les seuls à être créés par CreateOleObject.

Remarque :  Dans le code Delphi, CreateOleObject est appelée une seule fois pour créer chaque nouvelle instance unique d'une classe. Pour créer plusieurs instances de la même classe, nous vous recommandons d'utiliser une fabrique de classe.

Conseil :  Comme montré dans l'exemple, vous pouvez libérer l'interface stockée dans le Variant renvoyé en assignant la constante Unassigned à ce Variant.

Voir aussi