You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
84 lines
3.2 KiB
84 lines
3.2 KiB
/* 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_input_event.idl modified Tue Apr 8 15:19:45 2014. */
|
|
|
|
#ifndef PPAPI_C_PPP_INPUT_EVENT_H_
|
|
#define PPAPI_C_PPP_INPUT_EVENT_H_
|
|
|
|
#include "ppapi/c/pp_bool.h"
|
|
#include "ppapi/c/pp_instance.h"
|
|
#include "ppapi/c/pp_macros.h"
|
|
#include "ppapi/c/pp_resource.h"
|
|
#include "ppapi/c/pp_stdint.h"
|
|
|
|
#define PPP_INPUT_EVENT_INTERFACE_0_1 "PPP_InputEvent;0.1"
|
|
#define PPP_INPUT_EVENT_INTERFACE PPP_INPUT_EVENT_INTERFACE_0_1
|
|
|
|
/**
|
|
* @file
|
|
* This file defines the API for receiving input events from the browser.
|
|
*/
|
|
|
|
|
|
/**
|
|
* @addtogroup Interfaces
|
|
* @{
|
|
*/
|
|
struct PPP_InputEvent_0_1 {
|
|
/**
|
|
* Function for receiving input events from the browser.
|
|
*
|
|
* In order to receive input events, you must register for them by calling
|
|
* PPB_InputEvent.RequestInputEvents() or RequestFilteringInputEvents(). By
|
|
* default, no events are delivered.
|
|
*
|
|
* If the event was handled, it will not be forwarded to the default handlers
|
|
* in the web page. If it was not handled, it may be dispatched to a default
|
|
* handler. So it is important that an instance respond accurately with
|
|
* whether event propagation should continue.
|
|
*
|
|
* Event propagation also controls focus. If you handle an event like a mouse
|
|
* event, typically the instance will be given focus. Returning false from
|
|
* a filtered event handler or not registering for an event type means that
|
|
* the click will be given to a lower part of the page and your instance will
|
|
* not receive focus. This allows an instance to be partially transparent,
|
|
* where clicks on the transparent areas will behave like clicks to the
|
|
* underlying page.
|
|
*
|
|
* In general, you should try to keep input event handling short. Especially
|
|
* for filtered input events, the browser or page may be blocked waiting for
|
|
* you to respond.
|
|
*
|
|
* The caller of this function will maintain a reference to the input event
|
|
* resource during this call. Unless you take a reference to the resource
|
|
* to hold it for later, you don't need to release it.
|
|
*
|
|
* <strong>Note:</strong> If you're not receiving input events, make sure you
|
|
* register for the event classes you want by calling RequestInputEvents or
|
|
* RequestFilteringInputEvents. If you're still not receiving keyboard input
|
|
* events, make sure you're returning true (or using a non-filtered event
|
|
* handler) for mouse events. Otherwise, the instance will not receive focus
|
|
* and keyboard events will not be sent.
|
|
*
|
|
* \see PPB_InputEvent.RequestInputEvents and
|
|
* PPB_InputEvent.RequestFilteringInputEvents
|
|
*
|
|
* @return PP_TRUE if the event was handled, PP_FALSE if not. If you have
|
|
* registered to filter this class of events by calling
|
|
* RequestFilteringInputEvents, and you return PP_FALSE, the event will
|
|
* be forwarded to the page (and eventually the browser) for the default
|
|
* handling. For non-filtered events, the return value will be ignored.
|
|
*/
|
|
PP_Bool (*HandleInputEvent)(PP_Instance instance, PP_Resource input_event);
|
|
};
|
|
|
|
typedef struct PPP_InputEvent_0_1 PPP_InputEvent;
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#endif /* PPAPI_C_PPP_INPUT_EVENT_H_ */
|
|
|
|
|