[Editing] Introduce |EditCommandComposition::willUn/Reapply()| in prepare for 'beforeinput' (2/3)

third_party/WebKit/Source/core/editing/commands/CompositeEditCommand.h

 /*
  * Copyright (C) 2005, 2006, 2008 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
@@ skipping 34 matching lines @@
 enum class EditCommandSource { kMenuOrKeyBinding, kDOM };
 
 class EditCommandComposition final : public UndoStep {
  public:
   static EditCommandComposition* create(Document*,
                                         const VisibleSelection&,
                                         const VisibleSelection&,
                                         InputEvent::InputType);
 
   bool belongsTo(const LocalFrame&) const override;
-  void unapply() override;
-  void reapply() override;
+  void unapply(EditCommandSource) override;
+  void reapply(EditCommandSource) override;
   InputEvent::InputType inputType() const override;
   void append(SimpleEditCommand*);
   void append(EditCommandComposition*);
 
   const VisibleSelection& startingSelection() const {
     return m_startingSelection;
   }
   const VisibleSelection& endingSelection() const { return m_endingSelection; }
   void setStartingSelection(const VisibleSelection&);
   void setEndingSelection(const VisibleSelection&);
   Element* startingRootEditableElement() const {
     return m_startingRootEditableElement.get();
   }
   Element* endingRootEditableElement() const {
     return m_endingRootEditableElement.get();
   }
 
   DECLARE_VIRTUAL_TRACE();
 
  private:
   EditCommandComposition(Document*,
                          const VisibleSelection& startingSelection,
                          const VisibleSelection& endingSelection,
                          InputEvent::InputType);
 
+  // Fires "beforeinput". Returns |false| to cancel unapply / reapply when

[Xiaocheng, 2016/12/19 03:43:00]

Please add a "TODO: implementation" note that the two functions are not really
firing beforeinput for now.

[chongz, 2016/12/19 20:56:24]

Done.

+  //   * "beforeinput" was canceled, or
+  //   * |frame| was destroyed by event handlers.
+  // Note: Undo stack will always get popped.
+  bool willUnapply(EditCommandSource);
+  bool willReapply(EditCommandSource);
+
   Member<Document> m_document;
   VisibleSelection m_startingSelection;
   VisibleSelection m_endingSelection;
   HeapVector<Member<SimpleEditCommand>> m_commands;
   Member<Element> m_startingRootEditableElement;
   Member<Element> m_endingRootEditableElement;
   InputEvent::InputType m_inputType;
 };
 
 class CORE_EXPORT CompositeEditCommand : public EditCommand {
@@ skipping 191 matching lines @@
 
 DEFINE_TYPE_CASTS(CompositeEditCommand,
                   EditCommand,
                   command,
                   command->isCompositeEditCommand(),
                   command.isCompositeEditCommand());
 
 }  // namespace blink
 
 #endif  // CompositeEditCommand_h