개요

WebBrowser, Plugin 컴포넌트에서 반환하는 오브젝트를 Wrapping 하는 Wrapper 오브젝트입니다.

지원 환경

- WebBrowser 컴포넌트에서 getProperty() 메소드 실행 시 로드된 웹페이지의 window 또는 document 객체를 PluginObject 로 Wrapping 하여 반환합니다.
   WebBrowser 컴포넌트에서 callMethod() 메소드 실행 시 오브젝트를 리턴한 경우 PluginObject 로 Wrapping 되어 반환될 수 있습니다.

- Plugin 컴포넌트에서 getProperty(), callMethod() 메소드 실행 시 오브젝트를 리턴한 경우 PluginObject 로 Wrapping 되어 반환될 수 있습니다.

- 반환된 PluginObject 에서 getProperty() 메소드 실행 시 반환값이 객체일 경우 PluginObject 로 Wrapping 하여 반환합니다.

- 사용을 완료한 PluginObject 객체는 명시적으로 destroy 하여야 합니다.
   PluginObject 객체를 destroy 하지 않을 경우 메모리 누수가 발생할 수 있습니다.

메서드

callMethod

PluginObject 로 Wrapping 된 객체에 정의된 메소드를 호출하는 메소드입니다.

지원 환경

문법

PluginObject.callMethod( strMethodID [, varArg1 [, varArg2 ]]);

파라미터

참고

- Cross Domain 상황이면 사용에 제한이 있습니다.

getProperty

PluginObject 로 Wrapping 된 객체에 정의된 속성의 값을 반환하는 메소드입니다.

지원 환경

문법

PluginObject.getProperty( strPropID );

파라미터

var objDoc = this.WebBrowser00.getProperty( "document" );  // PluginObject

var objSub = objDoc.getProperty( "objSub" );
var varVal = objDoc.getProperty( "PropID" );

반환

참고

- Cross Domain 상황이면 사용에 제한이 있습니다.

- 반환된 PluginObject 객체에서 getProperty(), setProperty(), callMethod() 메소드를 사용할 수 있습니다.
   각 메소드로 하위 객체나 속성에 접근하고, 메소드를 실행 할 수 있습니다.

- 사용을 완료한 PluginObject 객체는 명시적으로 destroy 하여야 합니다.
   PluginObject 객체를 destroy 하지 않을 경우 메모리 누수가 발생할 수 있습니다.


◆ Android NRE 제약

- Android NRE 는 WebKit Library 에서 document 객체의 접근을 제공하지 않아 사용할 수 없는 메소드입니다.

setProperty

PluginObject 로 Wrapping 된 객체에 정의된 속성에 값을 설정하는 메소드입니다.

지원 환경

문법

PluginObject.setProperty( strPropID, varValue );

파라미터

var objDoc = this.WebBrowser00.getProperty( "document" );  // PluginObject
objDoc.setProperty( "prop1", 3 );