Selection API: Do not change focus by Selection functions.

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

 /*
  * Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009, 2010 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
@@ skipping 101 matching lines @@
 
   const VisibleSelection& computeVisibleSelectionInDOMTree() const;
   const VisibleSelectionInFlatTree& computeVisibleSelectionInFlatTree() const;
 
   // TODO(editing-dev): We should replace
   // |computeVisibleSelectionInDOMTreeDeprecated()| with update layout and
   // |computeVisibleSelectionInDOMTree()| to increase places hoisting update
   // layout.
   const VisibleSelection& computeVisibleSelectionInDOMTreeDeprecated() const;
 
+  // setSelection() and setSelectedRange() functions may dispatch focus-related
+  // synchronous events unless DoNotSetFocus is specified.
   void setSelection(const SelectionInDOMTree&,
                     SetSelectionOptions = CloseTyping | ClearTypingStyle,
                     CursorAlignOnScroll = CursorAlignOnScroll::IfNeeded,
                     TextGranularity = CharacterGranularity);
 
   void setSelection(const SelectionInFlatTree&,
                     SetSelectionOptions = CloseTyping | ClearTypingStyle,
                     CursorAlignOnScroll = CursorAlignOnScroll::IfNeeded,
                     TextGranularity = CharacterGranularity);
 
@@ skipping 10 matching lines @@
   void setSelection(const VisibleSelectionInFlatTree&,
                     HandleVisibility = HandleVisibility::NotVisible,
                     SetSelectionOptions = CloseTyping | ClearTypingStyle,
                     CursorAlignOnScroll = CursorAlignOnScroll::IfNeeded,
                     TextGranularity = CharacterGranularity);
   bool setSelectedRange(
       const EphemeralRange&,
       TextAffinity,
       SelectionDirectionalMode = SelectionDirectionalMode::NonDirectional,
       FrameSelection::SetSelectionOptions = CloseTyping | ClearTypingStyle);
+
+  // selectAll() may dispatch focus-related synchronous events.
   void selectAll();
+
   void clear();
 
   // Call this after doing user-triggered selections to make it easy to delete
   // the frame you entirely selected.
   void selectFrameElementInParentIfFullySelected();
 
   bool contains(const LayoutPoint&);
 
+  // This function may dispatch focus-related synchronous events unless
+  // DoNotSetFocus is specified.
+  //
+  // |noFocusFlag| must be 0 or SetSelectionOptions::DoNotSetFocus.
   bool modify(EAlteration,
               SelectionDirection,
               TextGranularity,
-              EUserTriggered = NotUserTriggered);
+              EUserTriggered = NotUserTriggered,
+              SetSelectionOptions noFocusFlag = 0);
   enum VerticalDirection { DirectionUp, DirectionDown };
   bool modify(EAlteration, unsigned verticalDistance, VerticalDirection);
 
   // Moves the selection extent based on the selection granularity strategy.
   // This function does not allow the selection to collapse. If the new
   // extent is resolved to the same position as the current base, this
   // function will do nothing.
   void moveRangeSelectionExtent(const IntPoint&);
   void moveRangeSelection(const VisiblePosition& base,
                           const VisiblePosition& extent,
@@ skipping 161 matching lines @@
 
 }  // namespace blink
 
 #ifndef NDEBUG
 // Outside the WebCore namespace for ease of invocation from gdb.
 void showTree(const blink::FrameSelection&);
 void showTree(const blink::FrameSelection*);
 #endif
 
 #endif  // FrameSelection_h