/* * Copyright (C) 2004-2016 Apple Inc. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #pragma once #include "FloatPoint.h" #include "IntPoint.h" #include "PlatformEvent.h" #include #if PLATFORM(GTK) typedef struct _GdkEventScroll GdkEventScroll; #endif namespace WebCore { // The ScrollByPixelWheelEvent is a fine-grained event that specifies the precise number of pixels to scroll. // It is sent directly by touch pads on macOS, or synthesized when platforms generate line-by-line scrolling events. // // The ScrollByPageWheelEvent indicates that the wheel event should scroll an entire page. // In this case, WebKit built in paging behavior is used to page up and down. // This yields the same behavior as clicking in a scrollbar track to page up and down. enum PlatformWheelEventGranularity : uint8_t { ScrollByPageWheelEvent, ScrollByPixelWheelEvent, }; #if PLATFORM(COCOA) enum PlatformWheelEventPhase : uint8_t { PlatformWheelEventPhaseNone = 0, PlatformWheelEventPhaseBegan = 1 << 0, PlatformWheelEventPhaseStationary = 1 << 1, PlatformWheelEventPhaseChanged = 1 << 2, PlatformWheelEventPhaseEnded = 1 << 3, PlatformWheelEventPhaseCancelled = 1 << 4, PlatformWheelEventPhaseMayBegin = 1 << 5, }; #endif class PlatformWheelEvent : public PlatformEvent { public: PlatformWheelEvent() : PlatformEvent(PlatformEvent::Wheel) { } PlatformWheelEvent(IntPoint position, IntPoint globalPosition, float deltaX, float deltaY, float wheelTicksX, float wheelTicksY, PlatformWheelEventGranularity granularity, bool shiftKey, bool ctrlKey, bool altKey, bool metaKey) : PlatformEvent(PlatformEvent::Wheel, shiftKey, ctrlKey, altKey, metaKey, 0) , m_position(position) , m_globalPosition(globalPosition) , m_deltaX(deltaX) , m_deltaY(deltaY) , m_wheelTicksX(wheelTicksX) , m_wheelTicksY(wheelTicksY) , m_granularity(granularity) { } PlatformWheelEvent copyTurningVerticalTicksIntoHorizontalTicks() const { PlatformWheelEvent copy = *this; copy.m_deltaX = copy.m_deltaY; copy.m_deltaY = 0; copy.m_wheelTicksX = copy.m_wheelTicksY; copy.m_wheelTicksY = 0; return copy; } PlatformWheelEvent copyWithDeltasAndVelocity(float deltaX, float deltaY, const FloatSize& velocity) const { PlatformWheelEvent copy = *this; copy.m_deltaX = deltaX; copy.m_deltaY = deltaY; copy.m_scrollingVelocity = velocity; return copy; } const IntPoint& position() const { return m_position; } // PlatformWindow coordinates. const IntPoint& globalPosition() const { return m_globalPosition; } // Screen coordinates. float deltaX() const { return m_deltaX; } float deltaY() const { return m_deltaY; } float wheelTicksX() const { return m_wheelTicksX; } float wheelTicksY() const { return m_wheelTicksY; } PlatformWheelEventGranularity granularity() const { return m_granularity; } bool directionInvertedFromDevice() const { return m_directionInvertedFromDevice; } const FloatSize& scrollingVelocity() const { return m_scrollingVelocity; } #if PLATFORM(GTK) explicit PlatformWheelEvent(GdkEventScroll*); #endif #if PLATFORM(COCOA) bool hasPreciseScrollingDeltas() const { return m_hasPreciseScrollingDeltas; } void setHasPreciseScrollingDeltas(bool hasPreciseScrollingDeltas) { m_hasPreciseScrollingDeltas = hasPreciseScrollingDeltas; } PlatformWheelEventPhase phase() const { return m_phase; } PlatformWheelEventPhase momentumPhase() const { return m_momentumPhase; } unsigned scrollCount() const { return m_scrollCount; } float unacceleratedScrollingDeltaX() const { return m_unacceleratedScrollingDeltaX; } float unacceleratedScrollingDeltaY() const { return m_unacceleratedScrollingDeltaY; } bool useLatchedEventElement() const; bool shouldConsiderLatching() const; bool shouldResetLatching() const; bool isEndOfMomentumScroll() const; bool isEndOfNonMomentumScroll() const; bool isTransitioningToMomentumScroll() const; #else bool useLatchedEventElement() const { return false; } #endif #if PLATFORM(WIN) PlatformWheelEvent(HWND, WPARAM, LPARAM, bool isMouseHWheel); PlatformWheelEvent(HWND, const FloatSize& delta, const FloatPoint& location); #endif protected: IntPoint m_position; IntPoint m_globalPosition; float m_deltaX { 0 }; float m_deltaY { 0 }; float m_wheelTicksX { 0 }; float m_wheelTicksY { 0 }; PlatformWheelEventGranularity m_granularity { ScrollByPixelWheelEvent }; bool m_directionInvertedFromDevice { false }; // Scrolling velocity in pixels per second. FloatSize m_scrollingVelocity; #if PLATFORM(COCOA) bool m_hasPreciseScrollingDeltas { false }; PlatformWheelEventPhase m_phase { PlatformWheelEventPhaseNone }; PlatformWheelEventPhase m_momentumPhase { PlatformWheelEventPhaseNone }; unsigned m_scrollCount { 0 }; float m_unacceleratedScrollingDeltaX { 0 }; float m_unacceleratedScrollingDeltaY { 0 }; #endif }; #if PLATFORM(COCOA) inline bool PlatformWheelEvent::useLatchedEventElement() const { return m_phase == PlatformWheelEventPhaseBegan || m_phase == PlatformWheelEventPhaseChanged || m_momentumPhase == PlatformWheelEventPhaseBegan || m_momentumPhase == PlatformWheelEventPhaseChanged || (m_phase == PlatformWheelEventPhaseEnded && m_momentumPhase == PlatformWheelEventPhaseNone); } inline bool PlatformWheelEvent::shouldConsiderLatching() const { return m_phase == PlatformWheelEventPhaseBegan || m_phase == PlatformWheelEventPhaseMayBegin; } inline bool PlatformWheelEvent::shouldResetLatching() const { return m_phase == PlatformWheelEventPhaseCancelled || m_phase == PlatformWheelEventPhaseMayBegin || isEndOfMomentumScroll(); } inline bool PlatformWheelEvent::isEndOfMomentumScroll() const { return m_phase == PlatformWheelEventPhaseNone && m_momentumPhase == PlatformWheelEventPhaseEnded; } inline bool PlatformWheelEvent::isEndOfNonMomentumScroll() const { return m_phase == PlatformWheelEventPhaseEnded && m_momentumPhase == PlatformWheelEventPhaseNone; } inline bool PlatformWheelEvent::isTransitioningToMomentumScroll() const { return m_phase == PlatformWheelEventPhaseNone && m_momentumPhase == PlatformWheelEventPhaseBegan; } #endif } // namespace WebCore