GetObject-Funktion (JScript 10.0)
Gibt einen Verweis auf ein Automatisierungsobjekt aus einer Datei zurück. Diese Funktion liegt in zwei Formen vor.
function GetObject(class : String)
function GetObject(pathname : String [, class : String])
Argumente
class
Erforderlich. Eine Zeichenfolge der Form appName.objectType, wobei appName der Name der Anwendung ist, die das Objekt bereitstellt, und objectType der Typ oder die Klasse des zu erstellenden Objekts.pathname
Erforderlich. Der vollständige Pfad und Name der Datei, die das abzurufende Objekt enthält. Wird pathname ausgelassen, ist class erforderlich.
Hinweise
Verwenden Sie die GetObject-Funktion, um auf ein Automatisierungsobjekt aus einer Datei zuzugreifen. Weisen Sie der Objektvariablen das durch GetObject zurückgegebene Objekt zu. Beispiel:
var CADObject;
CADObject = GetObject("C:\\CAD\\SCHEMA.CAD");
Wenn dieser Code ausgeführt wird, wird die in pathname angegebene Anwendung gestartet, und das Objekt wird in der angegebenen Datei aktiviert. Ist pathname eine Zeichenfolge mit der Länge 0 (""), gibt GetObject eine neue Objektinstanz vom angegebenen Typ zurück. Wird das pathname-Argument nicht angegeben, gibt GetObject ein gegenwärtig aktives Objekt vom angegebenen Typ zurück. Wenn kein Objekt des angegebenen Typs vorhanden ist, tritt ein Fehler auf.
Einige Anwendungen bieten die Möglichkeit, eine Datei teilweise zu aktivieren. Dazu fügen Sie hinter dem Dateinamen ein Ausrufezeichen (!) ein, gefolgt von der Zeichenfolge, die den zu aktivierenden Teil der Datei identifiziert. Weitere Informationen über das Erstellen dieser Zeichenfolge finden Sie in der Dokumentation der Anwendung, mit der das Objekt erstellt wurde.
Möglicherweise haben Sie z. B. in einem Zeichenprogramm mehrere Ebenen einer Zeichnung in einer Datei gespeichert. Mit folgendem Code können Sie eine Ebene in einer Zeichnung mit dem Namen SCHEMA.CAD aktivieren:
var LayerObject = GetObject("C:\\CAD\\SCHEMA.CAD!Layer3");
Wenn Sie die Objektklasse nicht angeben, bestimmt die Automatisierung anhand des von Ihnen angegebenen Dateinamens, welche Anwendung gestartet und welches Objekt aktiviert wird. Einige Dateien unterstützen u. U. jedoch auch mehrere Objektklassen. Eine Zeichnung kann z. B. drei unterschiedliche Objekttypen unterstützen: Ein Anwendungsobjekt, ein Zeichenobjekt und ein Symbolleistenobjekt, die sich alle in derselben Datei befinden. Um anzugeben, welches Objekt in einer Datei aktiviert werden soll, verwenden Sie das optionale class-Argument. Beispiel:
var MyObject;
MyObject = GetObject("C:\\DRAWINGS\\SAMPLE.DRW", "FIGMENT.DRAWING");
Im vorherigen Beispiel ist FIGMENT der Name des Zeichenprogramms, und DRAWING ist einer der vom Programm unterstützten Objekttypen. Sobald ein Objekt aktiviert ist, wird im Code über die definierte Objektvariable darauf verwiesen. Im vorherigen Beispiel greifen Sie über die MyObject-Objektvariable auf Eigenschaften und Methoden des neuen Objekts zu. Beispiel:
MyObject.Line(9, 90);
MyObject.InsertText(9, 100, "Hello, world.");
MyObject.SaveAs("C:\\DRAWINGS\\SAMPLE.DRW");
Tipp
Verwenden Sie die GetObject-Funktion, wenn eine aktuelle Instanz des Objekts vorhanden ist oder Sie das Objekt mit einer bereits geladenen Datei erstellen möchten. Falls keine aktuelle Instanz vorhanden ist und das Objekt nicht mit einer geladenen Datei erstellt werden soll, verwenden Sie das ActiveXObject-Objekt.
Wenn sich ein Objekt als Einzelinstanzobjekt registriert hat, wird nur eine einzige Instanz dieses Objekts erstellt, unabhängig davon, wie oft ActiveXObject ausgeführt wird. Bei einem Einzelinstanzobjekt gibt GetObject bei einem Syntaxaufruf mit der Zeichenfolgenlänge 0 ("") stets dieselbe Instanz zurück, und es tritt ein Fehler auf, wenn das pathname-Argument nicht angegeben wird.