Funkce se používá pro přístup k Automation objektu ze souboru a přiřazení objektu do proměnné objektu. K přiřazení objektu vráceného touto funkcí do objektové proměnné se používá příkaz
Set.
Příklad:
Set CADObject = GetObject("C:\CAD\SCHEMA.CAD")
Při provádění tohoto skriptu je spuštěna aplikace asociovaná s určeným souborem a objekt v určeném souboru je aktivován. Pokud je argument
Cesta prázdný řetězec (""), pak
GetObject vrací novou instanci objektu určeného typu. Pokud je argument
Cesta vynechán, pak funkce vrací aktivní objekt určeného typu. Pokud objekt určeného typu neexistuje, pak vzniká chyba.
Některé aplikace dovolí aktivovat část souboru přidáním vykřičníku (!) za název souboru následovaného řetězcem identifikujícím část aktivovaného souboru. Informaci, jak vytvořit tento řetězec, je nutno najít v dokumentaci aplikace vytvářející objekt.
Například v kreslící aplikaci lze mít více vrstev obrázku uložených v souboru. Šlo by použít následujícího skript k aktivaci vrstvy v obrázku nazvaném SCHEMA.CAD:
Set LayerObject = GetObject("C:\CAD\SCHEMA.CAD!Layer3")
Pokud není určena třída objektu, pak systém určí, kterou aplikaci spustit a který objekt aktivovat podle zadaného jména souboru. Některé soubory však mohou podporovat více než jednu třídu objektu. Například obrázek by mohl podporovat tři typy objektu: objekt
Aplikace, objekt
Obrázek a objekt
Nástrojová lišta a všechny jsou současně části stejného souboru. K určení aktivovaného objektu v souboru se používá volitelný argument
Třída.
Příklad:
Set oObject = GetObject("C:\DRAWINGS\SAMPLE.DRW", "FIGMENT.DRAWING")
V předcházejícím příkladě je FIGMENT název kreslící aplikace a DRAWING je jedním z podporovaných objektů. Po aktivaci objektu se na něj ve skriptu odkazuje pomocí vytvořené objektové proměnné. Pomocí objektové proměnné se přistupuje k vlastnostem a k metodám nového objektu.
Příklad:
oObject.Line 9, 90
oObject.InsertText 9, 100, "Hello, world."
oObject.SaveAs "C:\DRAWINGS\SAMPLE.DRW"
Funkce se používá, pokud existuje aktivní instance objektu nebo vytváří-li se objekt ze souboru. Pokud není žádná aktivní instance a neaktivuje-li se objekt ze souboru, pak lze použít funkci
CreateObject.
Pokud se zaregistroval objekt jako jedno-instanční, pak bude vytvořena pouze jediná instance objektu bez ohledu na to, kolikrát byla funkce CreateObject provedena. U jedno-instančního objektu funkce GetObject vždy vrací tutéž instanci, pokud je volána s prázdným řetězcem a způsobí chybu, pokud je argument cesta vynechán.