NPAPI指令碼化介面

標籤：c   blog   a   http   int   get   

 

http://blog.csdn.net/hgl868/article/details/8576531

scriptable介面的實現，與屬性有關的函數為HasProperty、GetProperty、SetProperty。在JS中設定屬性（以bar為例）用plugin.bar=barvalue;來設定，擷取屬性直接用plugin.bar;如果要為外掛程式建立屬性，必須要在HasProperty中返回true，在GetProperty一般調用NPN_GetProperty(mNpp,sWindowObj,name,result);即可，如果有特殊目的也可以自行編寫其實現代碼；設定屬性用NPN_SetProperty(mNpp,sWindowObj,name,value);與method相關的函數為HasMethod和Invoke，如果要為外掛程式建立一個method，那麼必須在HasMethod中為該函數返回true，method的實現代碼應在Invoke實現或者由Invoke調用。如果既是method又是property，那麼在JS中既可以plugin.foo=value;和plugin.foo進行設定或擷取屬性值，又可以用plugin.foo();調用相應的函數功能，但是使用plugin.foo()的時候是先調用GetProperty再調用foo()方法的實現代碼的。

最簡單的一個例子是：

bool ScriptablePluginObject::HasMethod(NPIdentifier name){return true;}  
bool ScriptablePluginObject::HasProperty(NPIdentifier name){return true;}  
bool ScriptablePluginObject::GetProperty(NPIdentifier name, NPVariant *result)  
{return NPN_GetProperty(mNpp,sWindowObj,name,result);}  
bool ScriptablePluginObject::SetProperty(NPIdentifier name, const NPVariant *value)  
{return NPN_SetProperty(mNpp,sWindowObj,name,value);}  
bool ScriptablePluginObject::Invoke(NPIdentifier name, const NPVariant *args, uint32_t argCount, NPVariant *result)  
{MessageBox(NULL,"functions called","msg",0);return true;}  

這樣在JS中用任意的字串代替前面的foo或者bar都會正常的調用前述相關代碼。有一點需要指出的是在JS中任何Object都可以設定屬性如：

var t=new Object();  
t.anystr=val;  
alert(t.anystr);

這種方式與前面的不同點在於，這種方式只是JS核心的操作，其設定的屬性在外掛程式代碼中是無法訪問的，外掛程式實現屬性設定的機制的目的也就是為了能夠方便的訪問通過JS設定的屬性吧！
要設定幾個特定的屬性或者方法就需要結合NPN_GetStringIdentifier來實現了。具體見例子程式。
在scriptable的外掛程式中，在Plugin類和ScriptableObject類之間共用資料是非常必要的，使用全域變數當然是一種辦法，但是這樣會在一個頁面中有多個外掛程式執行個體時產生嚴重的後果。因此不提倡這樣做。注意ScriptableObject的成員mNpp是getScriptObject返回的，而這個mNpp就是Plugin類中的NPP結構，而這個NPP結構的pdata指向的就是Plugin類本身( 在NPP_New中有instance->pdata = (void *)plugin;)。將mNpp->pdata強制轉換為Plugin類的指標，然後就可以訪問其中的公有成員了。
設定或者擷取屬性一般也不需要調用NPN的相關介面了，只需要在Plugin中定義一個公有成員變數，在SetProperty中Plugin* plugin=(Plugin*)mNpp->pdata;
plugin->m_bar = NPVARIANT_TO_INT32(*value);在GetProperty中使用Plugin* plugin=(Plugin*)mNpp->pdata;INT32_TO_NPVARIANT(plugin->m_bar,*result);就可以了。