GetObject 함수

GetObject 함수

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

GetObject([pathname] [, class])

인수

pathname

선택적인 요소. 검색할 개체가 있는 파일 이름과 그 파일의 전체 경로를 나타내는 문자열입니다. pathname을 생략하면 class가 반드시 있어야 합니다.

class

선택적인 요소. 개체의 클래스인 문자열입니다.

class 인수는 appname.objectype 구문을 사용하며, 그 구성 요소는 아래와 같이 설명됩니다.

인수

appname

필수적인 요소. 개체를 제공하는 응용 프로그램의 이름인 문자열입니다.

objectype

필수적인 요소. 만들 개체의 클래스나 형식을 나타내는 문자열입니다.

참고

GetObject 함수는 파일에 있는 자동화 개체를 액세스하여 개체 변수에 그 개체를 할당합니다. Set문을 사용하여 GetObject 함수에서 반환한 개체를 개체 변수에 할당합니다. 예를 들어 다음과 같습니다.

Dim CADObject 
Set CADObject = GetObject("C:\CAD\SCHEMA.CAD")

이 코드를 실행하면 지정한 경로 이름에 연관된 응용 프로그램이 실행되며 지정한 파일에 있는 개체가 활성화됩니다. GetObject 함수는 pathname이 길이가 0인 문자열("")인 경우 지정한 형식의 새 개체 인스턴스를 반환하고, pathname 인수가 없는 경우 지정한 형식의 현재 활성 개체를 반환합니다. 지정한 형식의 개체가 없는 경우 오류가 발생합니다.

일부 응용 프로그램에서 파일 일부를 활성화하려면 파일 이름 뒤에 느낌표(!)와 활성화할 파일의 해당 부분을 식별하는 문자열을 차례로 붙입니다. 이 문자열의 작성 방법에 관한 정보는 해당 개체를 만든 응용 프로그램의 설명서를 참조하십시오.

예를 들어 도면 작성 프로그램에서 파일에 저장되어 있는 한 도면에 여러 레이어가 있을 수 있습니다. 아래 코드를 사용하면 SCHEMA.CAD라는 도면 안에서 레이어를 활성화할 수 있습니다.

Set LayerObject = GetObject("C:\CAD\SCHEMA.CAD!Layer3")

개체의 클래스를 지정하지 않으면 자동화 개체는 사용자가 제공한 파일 이름을 사용하여 시작할 응용 프로그램과 활성화할 개체를 결정합니다. 그러나 어떤 파일은 둘 이상의 개체 클래스를 지원할 수도 있습니다. 예를 들어 한 도면에서 모두 같은 파일의 일부인 세 가지 다른 형식의 개체, 즉 Application 개체, Drawing 개체 및 Toolbar 개체를 지원할 수 있습니다. 선택적인 class 인수를 사용하여 활성화할 파일의 개체를 지정합니다. 예를 들어 다음과 같습니다.

Dim MyObject 
Set 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 함수를 사용하지만, 현재 인스턴스가 없고 로드한 파일로 개체를 시작하지 않으려면 CreateObject 함수를 사용합니다.

한 개체가 그 자체를 단일 인스턴스 개체로 등록한 경우 CreateObject 함수를 여러 번 실행해도 그 개체에 대한 인스턴스는 하나만 만들어집니다. 길이가 0인 문자열("") 구문으로 GetObject 함수를 호출하면 이 함수는 항상 같은 인스턴스를 반환하지만, pathname 인수를 생략하면 오류가 발생합니다.