/* Copyright (c) 2012 The Chromium Authors. All rights reserved. * Use of this source code is governed by a BSD-style license that can be * found in the LICENSE file. */ /* From ppp_messaging.idl modified Wed Jan 25 11:41:09 2012. */ #ifndef PPAPI_C_PPP_MESSAGING_H_ #define PPAPI_C_PPP_MESSAGING_H_ #include "ppapi/c/pp_bool.h" #include "ppapi/c/pp_instance.h" #include "ppapi/c/pp_macros.h" #include "ppapi/c/pp_stdint.h" #include "ppapi/c/pp_var.h" #define PPP_MESSAGING_INTERFACE_1_0 "PPP_Messaging;1.0" #define PPP_MESSAGING_INTERFACE PPP_MESSAGING_INTERFACE_1_0 /** * @file * This file defines the PPP_Messaging interface containing pointers to * functions that you must implement to handle postMessage messages * on the associated DOM element. * */ /** * @addtogroup Interfaces * @{ */ /** * The PPP_Messaging interface contains pointers to functions * that you must implement to handle postMessage events on the associated * DOM element. */ struct PPP_Messaging_1_0 { /** * HandleMessage() is a function that the browser calls when PostMessage() * is invoked on the DOM element for the module instance in JavaScript. Note * that PostMessage() in the JavaScript interface is asynchronous, meaning * JavaScript execution will not be blocked while HandleMessage() is * processing the message. * * @param[in] instance A PP_Instance identifying one instance * of a module. * @param[in] message A PP_Var containing the data to be sent * to JavaScript. Message can have an int32_t, double, bool, or string value * (objects are not supported). * * The following JavaScript code invokes HandleMessage, passing * the module instance on which it was invoked, with message * being a string PP_Var containing "Hello world!" * * Example: * * @code * * * * * * * @endcode * */ void (*HandleMessage)(PP_Instance instance, struct PP_Var message); }; typedef struct PPP_Messaging_1_0 PPP_Messaging; /** * @} */ #endif /* PPAPI_C_PPP_MESSAGING_H_ */