OLD | NEW |
1 /* | 1 /* |
2 * Copyright (C) 2011 Google Inc. All rights reserved. | 2 * Copyright (C) 2011 Google Inc. All rights reserved. |
3 * | 3 * |
4 * Redistribution and use in source and binary forms, with or without | 4 * Redistribution and use in source and binary forms, with or without |
5 * modification, are permitted provided that the following conditions are | 5 * modification, are permitted provided that the following conditions are |
6 * met: | 6 * met: |
7 * | 7 * |
8 * * Redistributions of source code must retain the above copyright | 8 * * Redistributions of source code must retain the above copyright |
9 * notice, this list of conditions and the following disclaimer. | 9 * notice, this list of conditions and the following disclaimer. |
10 * * Redistributions in binary form must reproduce the above | 10 * * Redistributions in binary form must reproduce the above |
(...skipping 16 matching lines...) Expand all Loading... |
27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | 27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
28 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | 28 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
29 */ | 29 */ |
30 | 30 |
31 #ifndef WebScopedUserGesture_h | 31 #ifndef WebScopedUserGesture_h |
32 #define WebScopedUserGesture_h | 32 #define WebScopedUserGesture_h |
33 | 33 |
34 #include "../platform/WebPrivateOwnPtr.h" | 34 #include "../platform/WebPrivateOwnPtr.h" |
35 | 35 |
36 namespace blink { | 36 namespace blink { |
| 37 |
37 class UserGestureIndicator; | 38 class UserGestureIndicator; |
38 } | |
39 | |
40 namespace blink { | |
41 | |
42 class WebUserGestureToken; | 39 class WebUserGestureToken; |
43 | 40 |
44 // An instance of this class, while kept alive, will indicate that we are in | 41 // An instance of this class, while kept alive, will indicate that we are in |
45 // the context of a known user gesture. To use, create one, perform whatever | 42 // the context of a known user gesture. To use, create one, perform whatever |
46 // actions were done under color of a known user gesture, and then delete it. | 43 // actions were done under color of a known user gesture, and then delete it. |
47 // Usually this will be done on the stack. | 44 // Usually this will be done on the stack. |
48 // | 45 // |
49 // SECURITY WARNING: Do not create several instances of this class for the same | 46 // SECURITY WARNING: Do not create several instances of this class for the same |
50 // user gesture. Doing so might enable malicious code to work around certain | 47 // user gesture. Doing so might enable malicious code to work around certain |
51 // restrictions such as opening multiple windows. | 48 // restrictions such as opening multiple windows. |
52 // Instead, obtain the current WebUserGestureToken from the | 49 // Instead, obtain the current WebUserGestureToken from the |
53 // WebUserGestureIndicator, and use this token to create a | 50 // WebUserGestureIndicator, and use this token to create a |
54 // WebScopedUserGesture. If the token was alrady consumed, the new | 51 // WebScopedUserGesture. If the token was alrady consumed, the new |
55 // WebScopedUserGesture will not indicate that we are in the context of a user | 52 // WebScopedUserGesture will not indicate that we are in the context of a user |
56 // gesture. | 53 // gesture. |
57 class WebScopedUserGesture { | 54 class WebScopedUserGesture { |
58 public: | 55 public: |
59 explicit WebScopedUserGesture(const WebUserGestureToken& token) { initialize
WithToken(token); } | 56 explicit WebScopedUserGesture(const WebUserGestureToken& token) { initialize
WithToken(token); } |
60 WebScopedUserGesture() { initialize(); } | 57 WebScopedUserGesture() { initialize(); } |
61 ~WebScopedUserGesture() { reset(); } | 58 ~WebScopedUserGesture() { reset(); } |
62 | 59 |
63 private: | 60 private: |
64 BLINK_EXPORT void initialize(); | 61 BLINK_EXPORT void initialize(); |
65 BLINK_EXPORT void initializeWithToken(const WebUserGestureToken&); | 62 BLINK_EXPORT void initializeWithToken(const WebUserGestureToken&); |
66 BLINK_EXPORT void reset(); | 63 BLINK_EXPORT void reset(); |
67 | 64 |
68 WebPrivateOwnPtr<blink::UserGestureIndicator> m_indicator; | 65 WebPrivateOwnPtr<UserGestureIndicator> m_indicator; |
69 }; | 66 }; |
70 | 67 |
71 } // namespace blink | 68 } // namespace blink |
72 | 69 |
73 #endif // WebScopedUserGesture_h | 70 #endif // WebScopedUserGesture_h |
OLD | NEW |