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. Je-li argument
Cesta prázdný řetězec (""), funkce vrací novou instanci objektu určeného typu. Je-li argument
Cesta vynechán, funkce vrací aktivní objekt určeného typu. Neexistuje-li objekt určeného typu, 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")
Není-li určena třída objektu, 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á, existuje-li aktivní instance objektu nebo vytváří-li se objekt ze souboru. Není-li žádná aktivní instance a neaktivuje-li se objekt ze souboru, užívá se funkce
CreateObject.
Zaregistroval-li se objekt jako jedno-instanční, 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, je-li volána s prázdným řetězcem a způsobí chybu, je-li argument cesta vynechán.