1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
// Copyright 2018 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.
#ifndef UI_EVENTS_WIN_EVENTS_WIN_UTILS_H_
#define UI_EVENTS_WIN_EVENTS_WIN_UTILS_H_
#include <stdint.h>
#include <windows.h>
#include "build/build_config.h"
#include "ui/display/display.h"
#include "ui/events/event.h"
#include "ui/events/event_constants.h"
#include "ui/events/event_utils.h"
#include "ui/events/keycodes/keyboard_codes.h"
#include "ui/events/platform_event.h"
#include "ui/events/types/event_type.h"
#include "ui/gfx/native_widget_types.h"
namespace gfx {
class Point;
class Vector2d;
} // namespace gfx
namespace base {
class TickClock;
class TimeTicks;
}
// Utility functions for Windows specific events code.
namespace ui {
enum class DomCode;
// Get the EventType from a native event.
EVENTS_EXPORT EventType EventTypeFromMSG(const MSG& native_event);
// Get the EventFlags from a native event.
EVENTS_EXPORT int EventFlagsFromMSG(const MSG& native_event);
// Get the timestamp from a native event.
// Note: This is not a pure function meaning that multiple applications on the
// same native event may return different values.
EVENTS_EXPORT base::TimeTicks EventTimeFromMSG(const MSG& native_event);
// Convert |event_time|, a count of milliseconds from the clock used by
// ::GetTickCount(), to a value comparable to the base::TimeTicks clock.
// |current_time| is a value returned in the recent past by EventTimeForNow,
// which will be compared to the current result of ::GetTickCount() for
// calibration.
EVENTS_EXPORT base::TimeTicks EventLatencyTimeFromTickClock(
DWORD event_time,
base::TimeTicks current_time);
// Convert |event_time|, a timestamp from the clock used by
// ::QueryPerformanceCounter(), to a value comparable to the base::TimeTicks
// clock. Must not be called if base::TimeTicks::IsHighResolution() returns
// false.
EVENTS_EXPORT base::TimeTicks EventLatencyTimeFromPerformanceCounter(
UINT64 event_time);
// Get the location from a native event. The coordinate system of the resultant
// |Point| has the origin at top-left of the "root window". The nature of
// this "root window" and how it maps to platform-specific drawing surfaces is
// defined in ui/aura/root_window.* and ui/aura/window_tree_host*.
EVENTS_EXPORT gfx::Point EventLocationFromMSG(const MSG& native_event);
// Gets the location in native system coordinate space.
EVENTS_EXPORT gfx::Point EventSystemLocationFromMSG(const MSG& native_event);
// Returns the KeyboardCode from a native event.
EVENTS_EXPORT KeyboardCode KeyboardCodeFromMSG(const MSG& native_event);
// Returns the DOM KeyboardEvent code (physical location in the
// keyboard) from a native event.
EVENTS_EXPORT DomCode CodeFromMSG(const MSG& native_event);
// Returns true if the keyboard event is a character event rather than
// a keystroke event.
EVENTS_EXPORT bool IsCharFromMSG(const MSG& native_event);
// Returns the flags of the button that changed during a press/release.
EVENTS_EXPORT int GetChangedMouseButtonFlagsFromMSG(const MSG& native_event);
// Returns the detailed pointer information for mouse events.
EVENTS_EXPORT PointerDetails
GetMousePointerDetailsFromMSG(const MSG& native_event);
// Gets the mouse wheel offsets from a native event.
EVENTS_EXPORT gfx::Vector2d GetMouseWheelOffsetFromMSG(const MSG& native_event);
// Returns a copy of |native_event|. Depending on the platform, this copy may
// need to be deleted with ReleaseCopiedMSGEvent().
EVENTS_EXPORT MSG CopyMSGEvent(const MSG& native_event);
// Delete a |native_event| previously created by CopyMSGEvent().
EVENTS_EXPORT void ReleaseCopiedMSGEvent(const MSG& native_event);
// Returns the detailed pointer information for touch events.
EVENTS_EXPORT PointerDetails
GetTouchPointerDetailsFromMSG(const MSG& native_event);
// Clear the touch id from bookkeeping if it is a release/cancel event.
EVENTS_EXPORT void ClearTouchIdIfReleased(const MSG& native_event);
// Gets the fling velocity from a native event. is_cancel is set to true if
// this was a tap down, intended to stop an ongoing fling.
EVENTS_EXPORT bool GetFlingData(const MSG& native_event,
float* vx,
float* vy,
float* vx_ordinal,
float* vy_ordinal,
bool* is_cancel);
// Returns whether this is a scroll event and optionally gets the amount to be
// scrolled.
EVENTS_EXPORT bool GetScrollOffsetsFromMSG(const MSG& native_event);
// Makes EventLatencyTimeFromTickClock call the given |clock| to find the
// current time ticks. If |clock| is nullptr, it will call ::GetTickCount(),
// which is the default.
EVENTS_EXPORT void SetEventLatencyTickClockForTesting(
const base::TickClock* clock);
} // namespace ui
#endif // UI_EVENTS_WIN_EVENTS_WIN_UTILS_H_
|
