diff options
Diffstat (limited to 'editor/libeditor/InsertTextTransaction.h')
-rw-r--r-- | editor/libeditor/InsertTextTransaction.h | 84 |
1 files changed, 84 insertions, 0 deletions
diff --git a/editor/libeditor/InsertTextTransaction.h b/editor/libeditor/InsertTextTransaction.h new file mode 100644 index 0000000000..6b839a7773 --- /dev/null +++ b/editor/libeditor/InsertTextTransaction.h @@ -0,0 +1,84 @@ +/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ +/* This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ + +#ifndef InsertTextTransaction_h +#define InsertTextTransaction_h + +#include "EditTransactionBase.h" // base class + +#include "EditorForwards.h" + +#include "nsCycleCollectionParticipant.h" // various macros +#include "nsID.h" // NS_DECLARE_STATIC_IID_ACCESSOR +#include "nsISupportsImpl.h" // NS_DECL_ISUPPORTS_INHERITED +#include "nsString.h" // nsString members +#include "nscore.h" // NS_IMETHOD, nsAString + +namespace mozilla { +namespace dom { +class Text; +} // namespace dom + +/** + * A transaction that inserts text into a content node. + */ +class InsertTextTransaction final : public EditTransactionBase { + protected: + InsertTextTransaction(EditorBase& aEditorBase, + const nsAString& aStringToInsert, + const EditorDOMPointInText& aPointToInsert); + + public: + /** + * Creates new InsertTextTransaction instance. This never returns nullptr. + * + * @param aEditorBase The editor which manages the transaction. + * @param aPointToInsert The insertion point. + * @param aStringToInsert The new string to insert. + */ + static already_AddRefed<InsertTextTransaction> Create( + EditorBase& aEditorBase, const nsAString& aStringToInsert, + const EditorDOMPointInText& aPointToInsert); + + NS_DECL_ISUPPORTS_INHERITED + NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(InsertTextTransaction, + EditTransactionBase) + + NS_DECL_EDITTRANSACTIONBASE + NS_DECL_EDITTRANSACTIONBASE_GETASMETHODS_OVERRIDE(InsertTextTransaction) + + MOZ_CAN_RUN_SCRIPT NS_IMETHOD RedoTransaction() override; + NS_IMETHOD Merge(nsITransaction* aOtherTransaction, bool* aDidMerge) override; + + /** + * Return the string data associated with this transaction. + */ + void GetData(nsString& aResult); + + friend std::ostream& operator<<(std::ostream& aStream, + const InsertTextTransaction& aTransaction); + + private: + virtual ~InsertTextTransaction() = default; + + // Return true if aOtherTransaction immediately follows this transaction. + bool IsSequentialInsert(InsertTextTransaction& aOtherTrasaction); + + // The Text node to operate upon. + RefPtr<dom::Text> mTextNode; + + // The offset into mTextNode where the insertion is to take place. + uint32_t mOffset; + + // The text to insert into mTextNode at mOffset. + nsString mStringToInsert; + + // The editor, which we'll need to get the selection. + RefPtr<EditorBase> mEditorBase; +}; + +} // namespace mozilla + +#endif // #ifndef InsertTextTransaction_h |