third_party/WebKit/Source/core/editing/SelectionController.h

   1 /*
   2  * Copyright (C) 2006, 2007, 2009, 2010, 2011 Apple Inc. All rights reserved.
   3  * Copyright (C) 2015 Google Inc. All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  *
  14  * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
  15  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  17  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
  18  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  19  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  20  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  21  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  22  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  24  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25  */
  26
  27 #ifndef SelectionController_h
  28 #define SelectionController_h
  29
  30 #include "core/CoreExport.h"
  31 #include "core/editing/TextGranularity.h"
  32 #include "core/editing/VisibleSelection.h"
  33 #include "core/page/EventWithHitTestResults.h"
  34 #include "platform/heap/Handle.h"
  35
  36 namespace blink {
  37
  38 class FrameSelection;
  39 class HitTestResult;
  40 class LocalFrame;
  41
  42 class SelectionController final : public NoBaseWillBeGarbageCollected<SelectionController> {
  43     WTF_MAKE_NONCOPYABLE(SelectionController);
  44     WTF_MAKE_FAST_ALLOCATED_WILL_BE_REMOVED(SelectionController);
  45 public:
  46     static PassOwnPtrWillBeRawPtr<SelectionController> create(LocalFrame&);
  47     DECLARE_TRACE();
  48
  49     void handleMousePressEvent(const MouseEventWithHitTestResults&);
  50     bool handleMousePressEventSingleClick(const MouseEventWithHitTestResults&);
  51     bool handleMousePressEventDoubleClick(const MouseEventWithHitTestResults&);
  52     bool handleMousePressEventTripleClick(const MouseEventWithHitTestResults&);
  53     void handleMouseDraggedEvent(const MouseEventWithHitTestResults&, const IntPoint&, const LayoutPoint&, Node*, const IntPoint&);
  54     bool handleMouseReleaseEvent(const MouseEventWithHitTestResults&, const LayoutPoint&);
  55     bool handlePasteGlobalSelection(const PlatformMouseEvent&);
  56     bool handleGestureLongPress(const PlatformGestureEvent&, const HitTestResult&);
  57
  58     void updateSelectionForMouseDrag(Node*, const LayoutPoint&, const IntPoint&);
  59     void updateSelectionForMouseDrag(const HitTestResult&, Node*, const LayoutPoint&, const IntPoint&);
  60     void sendContextMenuEvent(const MouseEventWithHitTestResults&, const LayoutPoint&);
  61     void passMousePressEventToSubframe(const MouseEventWithHitTestResults&);
  62
  63     void initializeSelectionState();
  64     void setMouseDownMayStartSelect(bool);
  65     bool mouseDownMayStartSelect() const;
  66     bool mouseDownWasSingleClickInSelection() const;
  67     void notifySelectionChanged();
  68
  69 private:
  70     explicit SelectionController(LocalFrame&);
  71
  72     template <typename Strategy>
  73     bool handleMousePressEventSingleClickAlgorithm(const MouseEventWithHitTestResults&);
  74
  75     template <typename Strategy>
  76     void updateSelectionForMouseDragAlgorithm(const HitTestResult&, Node*, const LayoutPoint&, const IntPoint&);
  77
  78     enum class AppendTrailingWhitespace { ShouldAppend, DontAppend };
  79     void selectClosestWordFromHitTestResult(const HitTestResult&, AppendTrailingWhitespace);
  80     void selectClosestMisspellingFromHitTestResult(const HitTestResult&, AppendTrailingWhitespace);
  81     void selectClosestWordFromMouseEvent(const MouseEventWithHitTestResults&);
  82     void selectClosestMisspellingFromMouseEvent(const MouseEventWithHitTestResults&);
  83     void selectClosestWordOrLinkFromMouseEvent(const MouseEventWithHitTestResults&);
  84
  85     template <typename Strategy>
  86     bool updateSelectionForMouseDownDispatchingSelectStart(Node*, const VisibleSelectionTemplate<Strategy>&, TextGranularity);
  87
  88     FrameSelection& selection() const;
  89
  90     RawPtrWillBeMember<LocalFrame> const m_frame;
  91     bool m_mouseDownMayStartSelect;
  92     bool m_mouseDownWasSingleClickInSelection;
  93     enum class SelectionState { HaveNotStartedSelection, PlacedCaret, ExtendedSelection };
  94     SelectionState m_selectionState;
  95 };
  96
  97 } // namespace blink
  98 #endif // SelectionController_h