파워빌더 "Activate" 함수

Activate PowerScript function

  
설명

OLE container에 있는 object를 활성화하고, 서버 명령을 사용하는 object를 사용하여 작업하는 것을 허락한다.

Platform 정보

이 함수 및 다른 OLE 함수들은 Macintosh와 UNIX 환경에서 무시된다.

 

적용

OLE 2.0 control과 OLE DWObjects 

 

문법

objectref.Activate ( activationtype )

 

Argument

objectref

- OLE 2.0 control 또는 활성화 하려는 object를 포함하고있는 
  DataWindow control내의 OLE DWObject 이름. 
  OLE DWObject 이름의 문법은 dwcontrol.Object.dwobjectname 이어야 한다.

 

activationtype(옵션)

- OLE object와 작업할 장소를 명시하기 위하여 활성화 타입을 명시하는 것으로 
  활성화 타입은 다음과 같다:
1) InPlace!(기본설정값) object : control내에서 활성화된다. 
  서버 응용프로그램에 의하여 마련된 메뉴의 일부는 
  PowerBuilder 응용프로그램의 메뉴와 병합된다.
2) OffSite! object : 서버 응용 프로그램내에서 활성화되고, 
  사용자에게 서버 응용 프로그램의 기능을 더 많이 사용할 수 있도록 한다. 
  OLE 2.0 control의 경우, activationtype을 명시하여야 한다.
 

Return 값

Integer. 
활성화에 성공하였을 경우에는 0, 에러가 발생하였을 경우에는 다음 중 하나를 되돌린다.
-1 Container가 비어있다.
-2 object에 관한 명령(verb)이 올바르지 않다.
-3 object에 의하여 명령(verb)을 사용할 수 없다.
-4 object에 의하여 제공되는 명령(verb)이 없다.
-5 object가 지금 명령(verb)을 실행할 수 없다.
-9 그 밖의 에러
argument의 값이 NULL일 경우에, Activate 함수는 NULL을 되돌린다.
 

예제

서버 응용프로그램내에 있는 ole_1에서 object를 활성화 하는 경우.

integer result
result = ole_1.Activate(OffSite!)

 
Microsoft Graph 서버 응용 프로그램에있는 dw_1 DataWindow control에서 OLE DWObject ole_graph를 활성화 하는 경우.

integer result
result = dw_1.Object.ole_graph.Activate(OffSite!)

Activate (썸네일)