internal static CefV8Handler FromNativeOrNull(cef_v8handler_t *ptr)
{
CefV8Handler value = null;
bool found;
lock (_roots)
{
found = _roots.TryGetValue((IntPtr)ptr, out value);
}
return(found ? value : null);
}
/// <summary>
/// Create a new CefV8Value object of type function. This method should only be
/// called from within the scope of a CefRenderProcessHandler, CefV8Handler or
/// CefV8Accessor callback, or in combination with calling Enter() and Exit()
/// on a stored CefV8Context reference.
/// </summary>
public static CefV8Value CreateFunction(string name, CefV8Handler handler)
{
fixed(char *name_str = name)
{
var n_name = new cef_string_t(name_str, name != null ? name.Length : 0);
return(CefV8Value.FromNative(
cef_v8value_t.create_function(&n_name, handler.ToNative())
));
}
}
/// <summary>
/// Register a new V8 extension with the specified JavaScript extension code and
/// handler. Functions implemented by the handler are prototyped using the
/// keyword 'native'. The calling of a native function is restricted to the scope
/// in which the prototype of the native function is defined. This function may
/// only be called on the render process main thread.
///
/// Example JavaScript extension code:
/// <code>
/// // create the 'example' global object if it doesn't already exist.
/// if (!example)
/// example = {};
/// // create the 'example.test' global object if it doesn't already exist.
/// if (!example.test)
/// example.test = {};
/// (function() {
/// // Define the function 'example.test.myfunction'.
/// example.test.myfunction = function() {
/// // Call CefV8Handler::Execute() with the function name 'MyFunction'
/// // and no arguments.
/// native function MyFunction();
/// return MyFunction();
/// };
/// // Define the getter function for parameter 'example.test.myparam'.
/// example.test.__defineGetter__('myparam', function() {
/// // Call CefV8Handler::Execute() with the function name 'GetMyParam'
/// // and no arguments.
/// native function GetMyParam();
/// return GetMyParam();
/// });
/// // Define the setter function for parameter 'example.test.myparam'.
/// example.test.__defineSetter__('myparam', function(b) {
/// // Call CefV8Handler::Execute() with the function name 'SetMyParam'
/// // and a single argument.
/// native function SetMyParam();
/// if(b) SetMyParam(b);
/// });
///
/// // Extension definitions can also contain normal JavaScript variables
/// // and functions.
/// var myint = 0;
/// example.test.increment = function() {
/// myint += 1;
/// return myint;
/// };
/// })();
/// </code>
/// Example usage in the page:
/// <code>
/// // Call the function.
/// example.test.myfunction();
/// // Set the parameter.
/// example.test.myparam = value;
/// // Get the parameter.
/// value = example.test.myparam;
/// // Call another function.
/// example.test.increment();
/// </code>
/// </summary>
public static bool RegisterExtension(string extensionName, string javascriptCode, CefV8Handler handler)
{
if (string.IsNullOrEmpty(extensionName))
{
throw new ArgumentNullException("extensionName");
}
if (string.IsNullOrEmpty(javascriptCode))
{
throw new ArgumentNullException("javascriptCode");
fixed(char *extensionName_str = extensionName)
fixed(char *javascriptCode_str = javascriptCode)
{
var n_extensionName = new cef_string_t(extensionName_str, extensionName.Length);
var n_javascriptCode = new cef_string_t(javascriptCode_str, javascriptCode.Length);
return(libcef.register_extension(&n_extensionName, &n_javascriptCode, handler != null ? handler.ToNative() : null) != 0);
}
}
/// <summary>
/// Returns the function handler or NULL if not a CEF-created function.
/// </summary>
public CefV8Handler GetFunctionHandler()
{
return(CefV8Handler.FromNativeOrNull(
cef_v8value_t.get_function_handler(_self)
));
}
