Home | History | Annotate | Download | only in editing 
      1 /*
      2  * Copyright (C) 2005, 2006, 2007, 2008 Apple Inc. All rights reserved.
      3  *
      4  * Redistribution and use in source and binary forms, with or without
      5  * modification, are permitted provided that the following conditions
      6  * are met:
      7  * 1. Redistributions of source code must retain the above copyright
      8  *    notice, this list of conditions and the following disclaimer.
      9  * 2. Redistributions in binary form must reproduce the above copyright
     10  *    notice, this list of conditions and the following disclaimer in the
     11  *    documentation and/or other materials provided with the distribution.
     12  *
     13  * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
     14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
     17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
     18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
     19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
     20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
     21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
     23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     24  */
     25 
     26 #ifndef TypingCommand_h
     27 #define TypingCommand_h
     28 
     29 #include "core/editing/TextInsertionBaseCommand.h"
     30 
     31 namespace blink {
     32 
     33 class TypingCommand FINAL : public TextInsertionBaseCommand {
     34 public:
     35     enum ETypingCommand {
     36         DeleteSelection,
     37         DeleteKey,
     38         ForwardDeleteKey,
     39         InsertText,
     40         InsertLineBreak,
     41         InsertParagraphSeparator,
     42         InsertParagraphSeparatorInQuotedContent
     43     };
     44 
     45     enum TextCompositionType {
     46         TextCompositionNone,
     47         TextCompositionUpdate,
     48         TextCompositionConfirm
     49     };
     50 
     51     enum Option {
     52         SelectInsertedText = 1 << 0,
     53         KillRing = 1 << 1,
     54         RetainAutocorrectionIndicator = 1 << 2,
     55         PreventSpellChecking = 1 << 3,
     56         SmartDelete = 1 << 4
     57     };
     58     typedef unsigned Options;
     59 
     60     static void deleteSelection(Document&, Options = 0);
     61     static void deleteKeyPressed(Document&, Options = 0, TextGranularity = CharacterGranularity);
     62     static void forwardDeleteKeyPressed(Document&, Options = 0, TextGranularity = CharacterGranularity);
     63     static void insertText(Document&, const String&, Options, TextCompositionType = TextCompositionNone);
     64     static void insertText(Document&, const String&, const VisibleSelection&, Options, TextCompositionType = TextCompositionNone);
     65     static void insertLineBreak(Document&, Options);
     66     static void insertParagraphSeparator(Document&, Options);
     67     static void insertParagraphSeparatorInQuotedContent(Document&);
     68     static void closeTyping(LocalFrame*);
     69 
     70     void insertText(const String &text, bool selectInsertedText);
     71     void insertTextRunWithoutNewlines(const String &text, bool selectInsertedText);
     72     void insertLineBreak();
     73     void insertParagraphSeparatorInQuotedContent();
     74     void insertParagraphSeparator();
     75     void deleteKeyPressed(TextGranularity, bool killRing);
     76     void forwardDeleteKeyPressed(TextGranularity, bool killRing);
     77     void deleteSelection(bool smartDelete);
     78     void setCompositionType(TextCompositionType type) { m_compositionType = type; }
     79 
     80 private:
     81     static PassRefPtrWillBeRawPtr<TypingCommand> create(Document& document, ETypingCommand command, const String& text = "", Options options = 0, TextGranularity granularity = CharacterGranularity)
     82     {
     83         return adoptRefWillBeNoop(new TypingCommand(document, command, text, options, granularity, TextCompositionNone));
     84     }
     85 
     86     static PassRefPtrWillBeRawPtr<TypingCommand> create(Document& document, ETypingCommand command, const String& text, Options options, TextCompositionType compositionType)
     87     {
     88         return adoptRefWillBeNoop(new TypingCommand(document, command, text, options, CharacterGranularity, compositionType));
     89     }
     90 
     91     TypingCommand(Document&, ETypingCommand, const String& text, Options, TextGranularity, TextCompositionType);
     92 
     93     void setSmartDelete(bool smartDelete) { m_smartDelete = smartDelete; }
     94     bool isOpenForMoreTyping() const { return m_openForMoreTyping; }
     95     void closeTyping() { m_openForMoreTyping = false; }
     96 
     97     static PassRefPtrWillBeRawPtr<TypingCommand> lastTypingCommandIfStillOpenForTyping(LocalFrame*);
     98 
     99     virtual void doApply() OVERRIDE;
    100     virtual EditAction editingAction() const OVERRIDE;
    101     virtual bool isTypingCommand() const OVERRIDE;
    102     virtual bool preservesTypingStyle() const OVERRIDE { return m_preservesTypingStyle; }
    103     virtual void setShouldRetainAutocorrectionIndicator(bool retain) OVERRIDE { m_shouldRetainAutocorrectionIndicator = retain; }
    104     virtual bool shouldStopCaretBlinking() const OVERRIDE { return true; }
    105     void setShouldPreventSpellChecking(bool prevent) { m_shouldPreventSpellChecking = prevent; }
    106 
    107     static void updateSelectionIfDifferentFromCurrentSelection(TypingCommand*, LocalFrame*);
    108 
    109     void updatePreservesTypingStyle(ETypingCommand);
    110     void markMisspellingsAfterTyping(ETypingCommand);
    111     void typingAddedToOpenCommand(ETypingCommand);
    112     bool makeEditableRootEmpty();
    113 
    114     void updateCommandTypeOfOpenCommand(ETypingCommand typingCommand) { m_commandType = typingCommand; }
    115     ETypingCommand commandTypeOfOpenCommand() const { return m_commandType; }
    116 
    117     ETypingCommand m_commandType;
    118     String m_textToInsert;
    119     bool m_openForMoreTyping;
    120     bool m_selectInsertedText;
    121     bool m_smartDelete;
    122     TextGranularity m_granularity;
    123     TextCompositionType m_compositionType;
    124     bool m_killRing;
    125     bool m_preservesTypingStyle;
    126 
    127     // Undoing a series of backward deletes will restore a selection around all of the
    128     // characters that were deleted, but only if the typing command being undone
    129     // was opened with a backward delete.
    130     bool m_openedByBackwardDelete;
    131 
    132     bool m_shouldRetainAutocorrectionIndicator;
    133     bool m_shouldPreventSpellChecking;
    134 };
    135 
    136 } // namespace blink
    137 
    138 #endif // TypingCommand_h
    139