파일에서 자동화 개체에 대한 참조를 반환한다.

GetObject([pathName][,class])

인수

pathName (경로명)

선택적인 요소이며 검색할 개체를 포함하는 파일의 전체 경로와 이름이다.
pathName을 생략하면 class를 사용해야 한다.

class (클라스)

선택적인 요소로 개체의 클래스이다.
class 아규멘트는 appName.objectType 구문을 사용하며 아래 요소로 구성된다..

appName	필수적인 요소이며 개체를 제공하는 응용 프로그램의 이름이다.
objectType	필수적인 요소이며 만들려는 개체의 형식이나 클래스이다.

설명

GetObject() 기능함수를 사용하면 파일에서 자동화 개체에 접속하고, GetObject()가 반환하는 개체를 개체 변수에 지정한다.

var CADObject=GetObject('C:\\CAD\\SCHEMA.CAD');

이 코드를 실행하면 지정된 pathName과 연결된 응용 프로그램이 시작되고, 지정된 파일에 있는 개체가 활성화된다. pathName이 빈 문자열('')이면 GetObject()는 지정된 형식의 새 개체 인스턴스를 반환한다. 만일 pathName 아규멘트를 생략하면 GetObject()는 현재 지정된 형식의 활성 개체를 반환한다. 지정된 형식의 개체가 없으면 오류가 발생한다.

응용 프로그램에 따라서는 파일 일부만을 활성화할 수도 있다. 이 경우에는 파일 이름 끝에 느낌표(!)와 활성화할 부분을 나타내는 문자열을 추가한다. 이 문자열을 작성하는 방법에 대한 자세한 내용은 개체를 만든 응용 프로그램의 설명서를 참고하라.

예를 들어, 그리기 응용 프로그램을 사용하는 경우 파일에 저장된 그림에 여러 계층이 있을 수 있다. 아래 코드를 사용하면 SCHEMA.CAD라는 그림에서 계층 하나를 활성화할 수 있다.

var LayerObject=GetObject('C:\\CAD\\SCHEMA,CAD!Layer3');

개체 클래스를 지정하지 않으면 자동화는 주어진 파일 이름을 기준으로 시작할 응용 프로그램과 활성화할 개체를 결정한다. 파일 중에는 개체 클래스를 두 개 이상 지원하는 것도 있다. 예를 들어 그림은 Application 개체와 Drawing 개체, Toolbar 개체 등 세 가지 개체를 지원할 수 있으며, 이 개체는 모두 같은 파일의 일부이다. 이런 경우 파일 내에서 활성화할 개체를 지정하려면 선택적인 요소인 class 아규멘트를 사용하라. 예를 들어 다음과 같다.

var MyObject=GetObject('C:\\DRAWINGS\\SAMPLE.DRW', 'FIGMENT.DRAWING');

앞의 예제에서 FIGMENT는 그리기 응용 프로그램의 이름이고 DRAWING은 지원되는 개체 유형 중 하나이다. 개체가 활성화되면 사용자가 정의한 개체 변수를 사용하여 코드 내에서 개체를 참조할 수 있다. 앞의 예제에서는 MyObject라는 개체 변수를 사용하여 새 개체의 속성과 메서드에 액세스한다. 예를 들어 다음과 같다.

MyObject.Line(9,90);
MyObject.InsertText(9,100,'안녕하십니까?');
MyObject.SaveAs('C:\\DRAWINGS\\SAMPLE.DRW');

참고 : GetObject() 기능함수는 현재 개체 인스턴스가 있거나 이미 로드된 파일에 개체를 만들 경우에 사용한다. 현재 인스턴스도 없고 로드된 파일에서 개체를 시작하고 싶지 않은 경우에는 ActiveXObject 개체를 사용하라.

개체가 단일 인스턴스 개체로 등록되어 있는 경우에는 ActiveXObject 실행 횟수에 관계없이 개체 인스턴스는 하나만 만들어 진다. 단일 인스턴스 개체의 경우 GetObject()를 빈 문자열('') 구문으로 호출하면 항상 같은 인스턴스를 반환하고, pathName 아규멘트를 생략하면 오류가 발생한다.