Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(18)

Side by Side Diff: ppapi/c/ppp_input_event.h

Issue 228653006: Pepper: Fix comments for PPB and PPP InputEvent. (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src
Patch Set: Created 6 years, 8 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
OLDNEW
1 /* Copyright (c) 2012 The Chromium Authors. All rights reserved. 1 /* Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 * Use of this source code is governed by a BSD-style license that can be 2 * Use of this source code is governed by a BSD-style license that can be
3 * found in the LICENSE file. 3 * found in the LICENSE file.
4 */ 4 */
5 5
6 /* From ppp_input_event.idl modified Mon Dec 19 19:44:12 2011. */ 6 /* From ppp_input_event.idl modified Thu Apr 3 14:52:48 2014. */
7 7
8 #ifndef PPAPI_C_PPP_INPUT_EVENT_H_ 8 #ifndef PPAPI_C_PPP_INPUT_EVENT_H_
9 #define PPAPI_C_PPP_INPUT_EVENT_H_ 9 #define PPAPI_C_PPP_INPUT_EVENT_H_
10 10
11 #include "ppapi/c/pp_bool.h" 11 #include "ppapi/c/pp_bool.h"
12 #include "ppapi/c/pp_instance.h" 12 #include "ppapi/c/pp_instance.h"
13 #include "ppapi/c/pp_macros.h" 13 #include "ppapi/c/pp_macros.h"
14 #include "ppapi/c/pp_resource.h" 14 #include "ppapi/c/pp_resource.h"
15 #include "ppapi/c/pp_stdint.h" 15 #include "ppapi/c/pp_stdint.h"
16 16
(...skipping 11 matching lines...) Expand all
28 * @{ 28 * @{
29 */ 29 */
30 struct PPP_InputEvent_0_1 { 30 struct PPP_InputEvent_0_1 {
31 /** 31 /**
32 * Function for receiving input events from the browser. 32 * Function for receiving input events from the browser.
33 * 33 *
34 * In order to receive input events, you must register for them by calling 34 * In order to receive input events, you must register for them by calling
35 * PPB_InputEvent.RequestInputEvents() or RequestFilteringInputEvents(). By 35 * PPB_InputEvent.RequestInputEvents() or RequestFilteringInputEvents(). By
36 * default, no events are delivered. 36 * default, no events are delivered.
37 * 37 *
38 * If the event was handled, it will not be forwarded to the web page or 38 * If the event was handled, it will not be forwarded to the default handlers
39 * browser. If it was not handled, it will bubble according to the normal 39 * in the web page. If it was not handled, it will bubble according to the
40 * rules. So it is important that an instance respond accurately with whether 40 * normal rules. So it is important that an instance respond accurately with
41 * event propagation should continue. 41 * whether event propagation should continue.
42 * 42 *
43 * Event propagation also controls focus. If you handle an event like a mouse 43 * Event propagation also controls focus. If you handle an event like a mouse
44 * event, typically the instance will be given focus. Returning false from 44 * event, typically the instance will be given focus. Returning false from
45 * a filtered event handler or not registering for an event type means that 45 * a filtered event handler or not registering for an event type means that
46 * the click will be given to a lower part of the page and your instance will 46 * the click will be given to a lower part of the page and your instance will
47 * not receive focus. This allows an instance to be partially transparent, 47 * not receive focus. This allows an instance to be partially transparent,
48 * where clicks on the transparent areas will behave like clicks to the 48 * where clicks on the transparent areas will behave like clicks to the
49 * underlying page. 49 * underlying page.
50 * 50 *
51 * In general, you should try to keep input event handling short. Especially 51 * In general, you should try to keep input event handling short. Especially
(...skipping 23 matching lines...) Expand all
75 PP_Bool (*HandleInputEvent)(PP_Instance instance, PP_Resource input_event); 75 PP_Bool (*HandleInputEvent)(PP_Instance instance, PP_Resource input_event);
76 }; 76 };
77 77
78 typedef struct PPP_InputEvent_0_1 PPP_InputEvent; 78 typedef struct PPP_InputEvent_0_1 PPP_InputEvent;
79 /** 79 /**
80 * @} 80 * @}
81 */ 81 */
82 82
83 #endif /* PPAPI_C_PPP_INPUT_EVENT_H_ */ 83 #endif /* PPAPI_C_PPP_INPUT_EVENT_H_ */
84 84
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698