summaryrefslogtreecommitdiffstats
path: root/editor/libeditor/DeleteTextTransaction.h
diff options
context:
space:
mode:
Diffstat (limited to 'editor/libeditor/DeleteTextTransaction.h')
-rw-r--r--editor/libeditor/DeleteTextTransaction.h99
1 files changed, 99 insertions, 0 deletions
diff --git a/editor/libeditor/DeleteTextTransaction.h b/editor/libeditor/DeleteTextTransaction.h
new file mode 100644
index 0000000000..8db1d4ae5f
--- /dev/null
+++ b/editor/libeditor/DeleteTextTransaction.h
@@ -0,0 +1,99 @@
+/* -*- 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 DeleteTextTransaction_h
+#define DeleteTextTransaction_h
+
+#include "EditTransactionBase.h"
+
+#include "EditorForwards.h"
+
+#include "mozilla/dom/Text.h"
+#include "nsCOMPtr.h"
+#include "nsCycleCollectionParticipant.h"
+#include "nsID.h"
+#include "nsString.h"
+#include "nscore.h"
+
+namespace mozilla {
+
+/**
+ * A transaction that removes text from a content node.
+ */
+class DeleteTextTransaction final : public EditTransactionBase {
+ protected:
+ DeleteTextTransaction(EditorBase& aEditorBase, dom::Text& aTextNode,
+ uint32_t aOffset, uint32_t aLengthToDelete);
+
+ public:
+ /**
+ * Creates a delete text transaction to remove given range. This returns
+ * nullptr if it cannot modify the text node.
+ *
+ * @param aEditorBase The provider of basic editing operations.
+ * @param aTextNode The content node to remove text from.
+ * @param aOffset The location in aElement to begin the deletion.
+ * @param aLenthToDelete The length to delete.
+ */
+ static already_AddRefed<DeleteTextTransaction> MaybeCreate(
+ EditorBase& aEditorBase, dom::Text& aTextNode, uint32_t aOffset,
+ uint32_t aLengthToDelete);
+
+ /**
+ * Creates a delete text transaction to remove a previous or next character.
+ * Those methods MAY return nullptr.
+ *
+ * @param aEditorBase The provider of basic editing operations.
+ * @param aTextNode The content node to remove text from.
+ * @param aOffset The location in aElement to begin the deletion.
+ */
+ static already_AddRefed<DeleteTextTransaction>
+ MaybeCreateForPreviousCharacter(EditorBase& aEditorBase, dom::Text& aTextNode,
+ uint32_t aOffset);
+ static already_AddRefed<DeleteTextTransaction> MaybeCreateForNextCharacter(
+ EditorBase& aEditorBase, dom::Text& aTextNode, uint32_t aOffset);
+
+ /**
+ * CanDoIt() returns true if there are enough members and can modify the
+ * text. Otherwise, false.
+ */
+ bool CanDoIt() const;
+
+ NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(DeleteTextTransaction,
+ EditTransactionBase)
+ NS_IMETHOD QueryInterface(REFNSIID aIID, void** aInstancePtr) override;
+
+ NS_DECL_EDITTRANSACTIONBASE
+ NS_DECL_EDITTRANSACTIONBASE_GETASMETHODS_OVERRIDE(DeleteTextTransaction)
+
+ MOZ_CAN_RUN_SCRIPT NS_IMETHOD RedoTransaction() override;
+
+ dom::Text* GetText() const { return mTextNode; }
+ uint32_t Offset() const { return mOffset; }
+ uint32_t LengthToDelete() const { return mLengthToDelete; }
+
+ friend std::ostream& operator<<(std::ostream& aStream,
+ const DeleteTextTransaction& aTransaction);
+
+ protected:
+ // The provider of basic editing operations.
+ RefPtr<EditorBase> mEditorBase;
+
+ // The CharacterData node to operate upon.
+ RefPtr<dom::Text> mTextNode;
+
+ // The offset into mTextNode where the deletion is to take place.
+ uint32_t mOffset;
+
+ // The length to delete.
+ uint32_t mLengthToDelete;
+
+ // The text that was deleted.
+ nsString mDeletedText;
+};
+
+} // namespace mozilla
+
+#endif // #ifndef DeleteTextTransaction_h