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 "TextInsertionBaseCommand.h"
30
31namespace WebCore {
32
33class TypingCommand : public TextInsertionBaseCommand {
34public:
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(Frame*);
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
80private:
81    static PassRefPtr<TypingCommand> create(Document* document, ETypingCommand command, const String& text = "", Options options = 0, TextGranularity granularity = CharacterGranularity)
82    {
83        return adoptRef(new TypingCommand(document, command, text, options, granularity, TextCompositionNone));
84    }
85
86    static PassRefPtr<TypingCommand> create(Document* document, ETypingCommand command, const String& text, Options options, TextCompositionType compositionType)
87    {
88        return adoptRef(new TypingCommand(document, command, text, options, CharacterGranularity, compositionType));
89    }
90
91    TypingCommand(Document*, ETypingCommand, const String& text, Options, TextGranularity, TextCompositionType);
92
93    bool smartDelete() const { return m_smartDelete; }
94    void setSmartDelete(bool smartDelete) { m_smartDelete = smartDelete; }
95    bool isOpenForMoreTyping() const { return m_openForMoreTyping; }
96    void closeTyping() { m_openForMoreTyping = false; }
97
98    static PassRefPtr<TypingCommand> lastTypingCommandIfStillOpenForTyping(Frame*);
99
100    virtual void doApply();
101    virtual EditAction editingAction() const;
102    virtual bool isTypingCommand() const;
103    virtual bool preservesTypingStyle() const { return m_preservesTypingStyle; }
104    virtual bool shouldRetainAutocorrectionIndicator() const
105    {
106        ASSERT(isTopLevelCommand());
107        return m_shouldRetainAutocorrectionIndicator;
108    }
109    virtual void setShouldRetainAutocorrectionIndicator(bool retain) { m_shouldRetainAutocorrectionIndicator = retain; }
110    virtual bool shouldStopCaretBlinking() const { return true; }
111    void setShouldPreventSpellChecking(bool prevent) { m_shouldPreventSpellChecking = prevent; }
112
113    static void updateSelectionIfDifferentFromCurrentSelection(TypingCommand*, Frame*);
114
115    void updatePreservesTypingStyle(ETypingCommand);
116    void markMisspellingsAfterTyping(ETypingCommand);
117    void typingAddedToOpenCommand(ETypingCommand);
118    bool makeEditableRootEmpty();
119
120    ETypingCommand m_commandType;
121    String m_textToInsert;
122    bool m_openForMoreTyping;
123    bool m_selectInsertedText;
124    bool m_smartDelete;
125    TextGranularity m_granularity;
126    TextCompositionType m_compositionType;
127    bool m_killRing;
128    bool m_preservesTypingStyle;
129
130    // Undoing a series of backward deletes will restore a selection around all of the
131    // characters that were deleted, but only if the typing command being undone
132    // was opened with a backward delete.
133    bool m_openedByBackwardDelete;
134
135    bool m_shouldRetainAutocorrectionIndicator;
136    bool m_shouldPreventSpellChecking;
137};
138
139} // namespace WebCore
140
141#endif // TypingCommand_h
142