reflow comments in core/input

third_party/WebKit/Source/core/input/MouseEventManager.cpp

 // Copyright 2016 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.
 
 #include "core/input/MouseEventManager.h"
 
 #include "core/clipboard/DataObject.h"
 #include "core/clipboard/DataTransfer.h"
 #include "core/dom/Element.h"
 #include "core/dom/ElementTraversal.h"
@@ skipping 27 matching lines @@
                                         const PlatformMouseEvent& mouseEvent) {
   if (!node->isElementNode())
     return mouseEvent;
 
   Element* element = toElement(node);
   if (!element->isInCanvasSubtree())
     return mouseEvent;
 
   HTMLCanvasElement* canvas =
       Traversal<HTMLCanvasElement>::firstAncestorOrSelf(*element);
-  // In this case, the event target is canvas and mouse rerouting doesn't happen.
+  // In this case, the event target is canvas and mouse rerouting doesn't
+  // happen.
   if (canvas == element)
     return mouseEvent;
   String region = canvas->getIdFromControl(element);
   PlatformMouseEvent newMouseEvent = mouseEvent;
   newMouseEvent.setRegion(region);
   return newMouseEvent;
 }
 
 // The amount of time to wait before sending a fake mouse event triggered
 // during a scroll.
 const double kFakeMouseMoveInterval = 0.1;
 
 #if OS(MACOSX)
 const double kTextDragDelay = 0.15;
 #else
 const double kTextDragDelay = 0.0;
 #endif
 
 // The link drag hysteresis is much larger than the others because there
-// needs to be enough space to cancel the link press without starting a link drag,
-// and because dragging links is rare.
+// needs to be enough space to cancel the link press without starting a link
+// drag, and because dragging links is rare.
 const int kLinkDragHysteresis = 40;
 const int kImageDragHysteresis = 5;
 const int kTextDragHysteresis = 3;
 const int kGeneralDragHysteresis = 3;
 
 }  // namespace
 
 enum class DragInitiator { Mouse, Touch };
 
 MouseEventManager::MouseEventManager(LocalFrame* frame,
@@ skipping 147 matching lines @@
 }
 
 WebInputEventResult MouseEventManager::dispatchMouseClickIfNeeded(
     const MouseEventWithHitTestResults& mev) {
   // We only prevent click event when the click may cause contextmenu to popup.
   // However, we always send auxclick.
   bool contextMenuEvent = !RuntimeEnabledFeatures::auxclickEnabled() &&
                           mev.event().pointerProperties().button ==
                               WebPointerProperties::Button::Right;
 #if OS(MACOSX)
-  // FIXME: The Mac port achieves the same behavior by checking whether the context menu is currently open in WebPage::mouseEvent(). Consider merging the implementations.
+  // FIXME: The Mac port achieves the same behavior by checking whether the
+  // context menu is currently open in WebPage::mouseEvent(). Consider merging
+  // the implementations.
   if (mev.event().pointerProperties().button ==
           WebPointerProperties::Button::Left &&
       mev.event().getModifiers() & PlatformEvent::CtrlKey)
     contextMenuEvent = true;
 #endif
 
   WebInputEventResult clickEventResult = WebInputEventResult::NotHandled;
   const bool shouldDispatchClickEvent =
       m_clickCount > 0 && !contextMenuEvent && mev.innerNode() && m_clickNode &&
       mev.innerNode()->canParticipateInFlatTree() &&
@@ skipping 36 matching lines @@
   if (settings && !settings->deviceSupportsMouse())
     return;
 
   FrameView* view = m_frame->view();
   if (!view)
     return;
 
   if (!m_frame->page() || !m_frame->page()->focusController().isActive())
     return;
 
-  // Don't dispatch a synthetic mouse move event if the mouse cursor is not visible to the user.
+  // Don't dispatch a synthetic mouse move event if the mouse cursor is not
+  // visible to the user.
   if (!m_frame->page()->isCursorVisible())
     return;
 
   PlatformMouseEvent fakeMouseMoveEvent(
       m_lastKnownMousePosition, m_lastKnownMouseGlobalPosition,
       WebPointerProperties::Button::NoButton, PlatformEvent::MouseMoved, 0,
       static_cast<PlatformEvent::Modifiers>(
           KeyboardEventManager::getCurrentModifierState()),
       PlatformMouseEvent::RealOrIndistinguishable,
       monotonicallyIncreasingTime(), WebPointerProperties::PointerType::Mouse);
@@ skipping 148 matching lines @@
 bool MouseEventManager::slideFocusOnShadowHostIfNecessary(
     const Element& element) {
   if (element.authorShadowRoot() &&
       element.authorShadowRoot()->delegatesFocus()) {
     Document* doc = m_frame->document();
     if (element.isShadowIncludingInclusiveAncestorOf(doc->focusedElement())) {
       // If the inner element is already focused, do nothing.
       return true;
     }
 
-    // If the host has a focusable inner element, focus it. Otherwise, the host takes focus.
+    // If the host has a focusable inner element, focus it. Otherwise, the host
+    // takes focus.
     Page* page = m_frame->page();
     DCHECK(page);
     Element* found =
         page->focusController().findFocusableElementInShadowHost(element);
     if (found && element.isShadowIncludingInclusiveAncestorOf(found)) {
-      // Use WebFocusTypeForward instead of WebFocusTypeMouse here to mean the focus has slided.
+      // Use WebFocusTypeForward instead of WebFocusTypeMouse here to mean the
+      // focus has slided.
       found->focus(FocusParams(SelectionBehaviorOnFocus::Reset,
                                WebFocusTypeForward, nullptr));
       return true;
     }
   }
   return false;
 }
 
 void MouseEventManager::handleMousePressEventUpdateStates(
     const PlatformMouseEvent& mouseEvent) {
@@ skipping 249 matching lines @@
 
   m_frame->eventHandler().selectionController().handleMouseDraggedEvent(
       event, m_mouseDownPos, m_dragStartPos, m_mousePressNode.get(),
       m_lastKnownMousePosition);
   return WebInputEventResult::HandledSystem;
 }
 
 bool MouseEventManager::handleDrag(const MouseEventWithHitTestResults& event,
                                    DragInitiator initiator) {
   DCHECK(event.event().type() == PlatformEvent::MouseMoved);
-  // Callers must protect the reference to FrameView, since this function may dispatch DOM
-  // events, causing page/FrameView to go away.
+  // Callers must protect the reference to FrameView, since this function may
+  // dispatch DOM events, causing page/FrameView to go away.
   DCHECK(m_frame);
   DCHECK(m_frame->view());
   if (!m_frame->page())
     return false;
 
   if (m_mouseDownMayStartDrag) {
     HitTestRequest request(HitTestRequest::ReadOnly);
     HitTestResult result(request, m_mouseDownPos);
     m_frame->contentLayoutItem().hitTest(result);
     Node* node = result.innerNode();
@@ skipping 15 matching lines @@
 
   if (!m_mouseDownMayStartDrag) {
     return initiator == DragInitiator::Mouse &&
            !m_frame->eventHandler()
                 .selectionController()
                 .mouseDownMayStartSelect() &&
            !m_mouseDownMayStartAutoscroll;
   }
 
   // We are starting a text/image/url drag, so the cursor should be an arrow
-  // FIXME <rdar://7577595>: Custom cursors aren't supported during drag and drop (default to pointer).
+  // FIXME <rdar://7577595>: Custom cursors aren't supported during drag and
+  // drop (default to pointer).
   m_frame->view()->setCursor(pointerCursor());
 
   if (initiator == DragInitiator::Mouse &&
       !dragHysteresisExceeded(event.event().position()))
     return true;
 
-  // Once we're past the hysteresis point, we don't want to treat this gesture as a click
+  // Once we're past the hysteresis point, we don't want to treat this gesture
+  // as a click
   invalidateClick();
 
   if (!tryStartDrag(event)) {
     // Something failed to start the drag, clean up.
     clearDragDataTransfer();
     dragState().m_dragSrc = nullptr;
   }
 
   m_mouseDownMayStartDrag = false;
-  // Whether or not the drag actually started, no more default handling (like selection).
+  // Whether or not the drag actually started, no more default handling (like
+  // selection).
   return true;
 }
 
 DataTransfer* MouseEventManager::createDraggingDataTransfer() const {
   return DataTransfer::create(DataTransfer::DragAndDrop, DataTransferWritable,
                               DataObject::create());
 }
 
 bool MouseEventManager::tryStartDrag(
     const MouseEventWithHitTestResults& event) {
   // The DataTransfer would only be non-empty if we missed a dragEnd.
   // Clear it anyway, just to make sure it gets numbified.
   clearDragDataTransfer();
 
   dragState().m_dragDataTransfer = createDraggingDataTransfer();
 
   // Check to see if this a DOM based drag, if it is get the DOM specified drag
   // image and offset
   if (dragState().m_dragType == DragSourceActionDHTML) {
     if (LayoutObject* layoutObject = dragState().m_dragSrc->layoutObject()) {
       IntRect boundingIncludingDescendants =
           layoutObject->absoluteBoundingBoxRectIncludingDescendants();
       IntSize delta = m_mouseDownPos - boundingIncludingDescendants.location();
       dragState().m_dragDataTransfer->setDragImageElement(
           dragState().m_dragSrc.get(), IntPoint(delta));
     } else {
-      // The layoutObject has disappeared, this can happen if the onStartDrag handler has hidden
-      // the element in some way. In this case we just kill the drag.
+      // The layoutObject has disappeared, this can happen if the onStartDrag
+      // handler has hidden the element in some way. In this case we just kill
+      // the drag.
       return false;
     }
   }
 
   DragController& dragController = m_frame->page()->dragController();
   if (!dragController.populateDragDataTransfer(m_frame, dragState(),
                                                m_mouseDownPos))
     return false;
 
   // If dispatching dragstart brings about another mouse down -- one way
   // this will happen is if a DevTools user breaks within a dragstart
   // handler and then clicks on the suspended page -- the drag state is
   // reset. Hence, need to check if this particular drag operation can
   // continue even if dispatchEvent() indicates no (direct) cancellation.
   // Do that by checking if m_dragSrc is still set.
   m_mouseDownMayStartDrag =
       dispatchDragSrcEvent(EventTypeNames::dragstart, m_mouseDown) ==
           WebInputEventResult::NotHandled &&
       !m_frame->selection().isInPasswordField() && dragState().m_dragSrc;
 
-  // Invalidate clipboard here against anymore pasteboard writing for security. The drag
-  // image can still be changed as we drag, but not the pasteboard data.
+  // Invalidate clipboard here against anymore pasteboard writing for security.
+  // The drag image can still be changed as we drag, but not the pasteboard
+  // data.
   dragState().m_dragDataTransfer->setAccessPolicy(DataTransferImageWritable);
 
   if (m_mouseDownMayStartDrag) {
-    // Dispatching the event could cause Page to go away. Make sure it's still valid before trying to use DragController.
+    // Dispatching the event could cause Page to go away. Make sure it's still
+    // valid before trying to use DragController.
     if (m_frame->page() &&
         dragController.startDrag(m_frame, dragState(), event.event(),
                                  m_mouseDownPos))
       return true;
     // Drag was canned at the last minute - we owe m_dragSrc a DRAGEND event
     dispatchDragSrcEvent(EventTypeNames::dragend, event.event());
   }
 
   return false;
 }
 
-// returns if we should continue "default processing", i.e., whether eventhandler canceled
+// Returns if we should continue "default processing", i.e., whether
+// eventhandler canceled.
 WebInputEventResult MouseEventManager::dispatchDragSrcEvent(
     const AtomicString& eventType,
     const PlatformMouseEvent& event) {
   return dispatchDragEvent(eventType, dragState().m_dragSrc.get(), event,
                            dragState().m_dragDataTransfer.get());
 }
 
 WebInputEventResult MouseEventManager::dispatchDragEvent(
     const AtomicString& eventType,
     Node* dragTarget,
@@ skipping 19 matching lines @@
 
 void MouseEventManager::clearDragDataTransfer() {
   if (dragState().m_dragDataTransfer) {
     dragState().m_dragDataTransfer->clearDragImage();
     dragState().m_dragDataTransfer->setAccessPolicy(DataTransferNumb);
   }
 }
 
 void MouseEventManager::dragSourceEndedAt(const PlatformMouseEvent& event,
                                           DragOperation operation) {
-  // Send a hit test request so that Layer gets a chance to update the :hover and :active pseudoclasses.
+  // Send a hit test request so that Layer gets a chance to update the :hover
+  // and :active pseudoclasses..
   HitTestRequest request(HitTestRequest::Release);
   EventHandlingUtil::performMouseEventHitTest(m_frame, request, event);
 
   if (dragState().m_dragSrc) {
     dragState().m_dragDataTransfer->setDestinationOperation(operation);
-    // for now we don't care if event handler cancels default behavior, since there is none
+    // For now we don't care if event handler cancels default behavior, since
+    // there is none.
     dispatchDragSrcEvent(EventTypeNames::dragend, event);
   }
   clearDragDataTransfer();
   dragState().m_dragSrc = nullptr;
   // In case the drag was ended due to an escape key press we need to ensure
   // that consecutive mousemove events don't reinitiate the drag and drop.
   m_mouseDownMayStartDrag = false;
 }
 
 DragState& MouseEventManager::dragState() {
@@ skipping 82 matching lines @@
 
 void MouseEventManager::setClickCount(int clickCount) {
   m_clickCount = clickCount;
 }
 
 bool MouseEventManager::mouseDownMayStartDrag() {
   return m_mouseDownMayStartDrag;
 }
 
 }  // namespace blink