GetObject, fonction (JScript 10.0)
Retourne une référence à un objet Automation d'un fichier. La fonction se présente sous deux formes.
function GetObject(class : String)
function GetObject(pathname : String [, class : String])
Arguments
class
Obligatoire. Chaîne se présentant sous la forme « appName.*objectType *», appName étant le nom de l'application qui fournit l'objet et objectType le type ou la classe de l'objet à créer.pathname
Obligatoire. Chemin d'accès complet et nom du fichier contenant l'objet à récupérer. Si l'argument pathname est omis, l'argument class est requis.
Notes
Utilisez la fonction GetObject pour accéder à un objet Automation à partir d'un fichier. Assignez l'objet retourné par GetObject à la variable objet. Par exemple :
var CADObject;
CADObject = GetObject("C:\\CAD\\SCHEMA.CAD");
Lorsque ce code est exécuté, l'application associée à l'argument pathname spécifié démarre, et l'objet dans le fichier spécifié est activé. Si pathname est une chaîne de longueur nulle (""), la fonction GetObject retourne une nouvelle instance d'objet du type spécifié. Si l'argument pathname est omis, GetObject retourne un objet actuellement actif du type spécifié. S'il n'existe aucun objet du type spécifié, une erreur se produit.
Certaines applications permettent d'activer une partie d'un fichier. Pour ce faire, ajoutez un point d'exclamation (!) à la fin du nom du fichier et faites suivre ce dernier d'une chaîne identifiant la partie du fichier à activer. Pour plus d'informations sur la création de cette chaîne, consultez la documentation de l'application qui a créé l'objet.
Dans une application de dessin, par exemple, un fichier peut contenir un dessin constitué de plusieurs couches. Le code suivant vous permet d'activer un plan d'un dessin nommé SCHEMA.CAD :
var LayerObject = GetObject("C:\\CAD\\SCHEMA.CAD!Layer3");
Si vous ne spécifiez pas la classe de l'objet, Automation identifie l'application à démarrer et l'objet à activer, en fonction du nom de fichier que vous fournissez. Cependant, certains fichiers peuvent prendre en charge plusieurs classes d'objets. Par exemple, un dessin peut comporter un objet Application, un objet Drawing et un objet Toolbar, chacun faisant partie du même fichier. Pour spécifier l'objet à activer dans un fichier, utilisez l'argument class facultatif. Par exemple :
var MyObject;
MyObject = GetObject("C:\\DRAWINGS\\SAMPLE.DRW", "FIGMENT.DRAWING");
Dans l'exemple précédent, FIGMENT est le nom d'une application de dessin et DRAWING est un des types d'objets qu'elle prend en charge. Une fois l'objet activé, vous le référencez dans le code à l'aide de la variable objet que vous avez définie. Dans l'exemple précédent, vous accédez aux propriétés et aux méthodes du nouvel objet en utilisant la variable objet MyObject. Par exemple :
MyObject.Line(9, 90);
MyObject.InsertText(9, 100, "Hello, world.");
MyObject.SaveAs("C:\\DRAWINGS\\SAMPLE.DRW");
Notes
Utilisez la fonction GetObject s'il existe une instance active de l'objet, ou lorsque vous souhaitez créer l'objet avec un fichier déjà chargé. En l'absence d'instance active, et si vous ne souhaitez pas que l'objet soit créé avec un fichier chargé, utilisez l'objet ActiveXObject.
Si un objet s'est inscrit comme un objet à instance unique, une seule instance de l'objet est créée, quel que soit le nombre d'exécutions de l'objet ActiveXObject. Dans le cas d'un objet à instance unique, la fonction GetObject retourne toujours la même instance lorsqu'elle est appelée avec la syntaxe de chaîne de longueur nulle ("") et provoque une erreur si l'argument pathname est omis.