Source code

Revision control

Copy as Markdown

Other Tools

/* -*- 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 */
#ifndef InsertTextTransaction_h
#define InsertTextTransaction_h
#include "EditTransactionBase.h" // base class
#include "EditorDOMPoint.h"
#include "EditorForwards.h"
#include "nsCycleCollectionParticipant.h" // various macros
#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 {
InsertTextTransaction(EditorBase& aEditorBase,
const nsAString& aStringToInsert,
const EditorDOMPointInText& aPointToInsert);
* 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);
MOZ_CAN_RUN_SCRIPT NS_IMETHOD RedoTransaction() override;
NS_IMETHOD Merge(nsITransaction* aOtherTransaction, bool* aDidMerge) override;
* Return the string data associated with this transaction.
const nsString& GetData() const { return mStringToInsert; }
template <typename EditorDOMPointType>
EditorDOMPointType SuggestPointToPutCaret() const {
if (NS_WARN_IF(!mTextNode)) {
return EditorDOMPointType();
return EditorDOMPointType(mTextNode, mOffset + mStringToInsert.Length());
friend std::ostream& operator<<(std::ostream& aStream,
const InsertTextTransaction& aTransaction);
virtual ~InsertTextTransaction() = default;
// Return true if aOtherTransaction immediately follows this transaction.
bool IsSequentialInsert(InsertTextTransaction& aOtherTransaction) const;
// 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