/* -*- 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/. */ #include "mozilla/TextEvents.h" #include "mozilla/TextEventDispatcher.h" #include "nsIDocShell.h" #include "nsIFrame.h" #include "nsIPresShell.h" #include "nsIWidget.h" #include "nsPIDOMWindow.h" #include "nsView.h" namespace mozilla { namespace widget { /****************************************************************************** * TextEventDispatcher *****************************************************************************/ TextEventDispatcher::TextEventDispatcher(nsIWidget* aWidget) : mWidget(aWidget) , mForTests(false) , mIsComposing(false) { MOZ_RELEASE_ASSERT(mWidget, "aWidget must not be nullptr"); } nsresult TextEventDispatcher::BeginInputTransaction( TextEventDispatcherListener* aListener) { return BeginInputTransactionInternal(aListener, false); } nsresult TextEventDispatcher::BeginInputTransactionForTests( TextEventDispatcherListener* aListener) { return BeginInputTransactionInternal(aListener, true); } nsresult TextEventDispatcher::BeginInputTransactionInternal( TextEventDispatcherListener* aListener, bool aForTests) { if (NS_WARN_IF(!aListener)) { return NS_ERROR_INVALID_ARG; } nsCOMPtr listener = do_QueryReferent(mListener); if (listener) { if (listener == aListener && mForTests == aForTests) { return NS_OK; } // If this has composition, any other listener can steal ownership. if (IsComposing()) { return NS_ERROR_ALREADY_INITIALIZED; } } mListener = do_GetWeakReference(aListener); mForTests = aForTests; if (listener && listener != aListener) { listener->OnRemovedFrom(this); } return NS_OK; } void TextEventDispatcher::OnDestroyWidget() { mWidget = nullptr; mPendingComposition.Clear(); nsCOMPtr listener = do_QueryReferent(mListener); mListener = nullptr; if (listener) { listener->OnRemovedFrom(this); } } nsresult TextEventDispatcher::GetState() const { nsCOMPtr listener = do_QueryReferent(mListener); if (!listener) { return NS_ERROR_NOT_INITIALIZED; } if (!mWidget || mWidget->Destroyed()) { return NS_ERROR_NOT_AVAILABLE; } return NS_OK; } void TextEventDispatcher::InitEvent(WidgetCompositionEvent& aEvent) const { aEvent.time = PR_IntervalNow(); aEvent.mFlags.mIsSynthesizedForTests = mForTests; } nsresult TextEventDispatcher::StartComposition(nsEventStatus& aStatus) { aStatus = nsEventStatus_eIgnore; nsresult rv = GetState(); if (NS_WARN_IF(NS_FAILED(rv))) { return rv; } if (NS_WARN_IF(mIsComposing)) { return NS_ERROR_FAILURE; } mIsComposing = true; nsCOMPtr widget(mWidget); WidgetCompositionEvent compositionStartEvent(true, NS_COMPOSITION_START, widget); InitEvent(compositionStartEvent); rv = widget->DispatchEvent(&compositionStartEvent, aStatus); if (NS_WARN_IF(NS_FAILED(rv))) { return rv; } return NS_OK; } nsresult TextEventDispatcher::StartCompositionAutomaticallyIfNecessary( nsEventStatus& aStatus) { if (IsComposing()) { return NS_OK; } nsresult rv = StartComposition(aStatus); if (NS_WARN_IF(NS_FAILED(rv))) { return rv; } // If started composition has already been committed, we shouldn't dispatch // the compositionchange event. if (!IsComposing()) { aStatus = nsEventStatus_eConsumeNoDefault; return NS_OK; } // Note that the widget might be destroyed during a call of // StartComposition(). In such case, we shouldn't keep dispatching next // event. rv = GetState(); if (NS_FAILED(rv)) { MOZ_ASSERT(rv != NS_ERROR_NOT_INITIALIZED, "aDispatcher must still be initialized in this case"); aStatus = nsEventStatus_eConsumeNoDefault; return NS_OK; // Don't throw exception in this case } aStatus = nsEventStatus_eIgnore; return NS_OK; } nsresult TextEventDispatcher::CommitComposition(nsEventStatus& aStatus, const nsAString* aCommitString) { aStatus = nsEventStatus_eIgnore; nsresult rv = GetState(); if (NS_WARN_IF(NS_FAILED(rv))) { return rv; } // When there is no composition, caller shouldn't try to commit composition // with non-existing composition string nor commit composition with empty // string. if (NS_WARN_IF(!IsComposing() && (!aCommitString || aCommitString->IsEmpty()))) { return NS_ERROR_FAILURE; } nsCOMPtr widget(mWidget); rv = StartCompositionAutomaticallyIfNecessary(aStatus); if (NS_WARN_IF(NS_FAILED(rv))) { return rv; } if (aStatus == nsEventStatus_eConsumeNoDefault) { return NS_OK; } // End current composition and make this free for other IMEs. mIsComposing = false; uint32_t message = aCommitString ? NS_COMPOSITION_COMMIT : NS_COMPOSITION_COMMIT_AS_IS; WidgetCompositionEvent compositionCommitEvent(true, message, widget); InitEvent(compositionCommitEvent); if (message == NS_COMPOSITION_COMMIT) { compositionCommitEvent.mData = *aCommitString; } rv = widget->DispatchEvent(&compositionCommitEvent, aStatus); if (NS_WARN_IF(NS_FAILED(rv))) { return rv; } return NS_OK; } nsresult TextEventDispatcher::NotifyIME(const IMENotification& aIMENotification) { nsCOMPtr listener = do_QueryReferent(mListener); if (!listener) { return NS_ERROR_NOT_IMPLEMENTED; } nsresult rv = listener->NotifyIME(this, aIMENotification); // If the listener isn't available, it means that it cannot handle the // notification or request for now. In this case, we should return // NS_ERROR_NOT_IMPLEMENTED because it's not implemented at such moment. if (rv == NS_ERROR_NOT_AVAILABLE) { return NS_ERROR_NOT_IMPLEMENTED; } return rv; } /****************************************************************************** * TextEventDispatcher::PendingComposition *****************************************************************************/ TextEventDispatcher::PendingComposition::PendingComposition() { Clear(); } void TextEventDispatcher::PendingComposition::Clear() { mString.Truncate(); mClauses = nullptr; mCaret.mRangeType = 0; } void TextEventDispatcher::PendingComposition::EnsureClauseArray() { if (mClauses) { return; } mClauses = new TextRangeArray(); } nsresult TextEventDispatcher::PendingComposition::SetString(const nsAString& aString) { mString = aString; return NS_OK; } nsresult TextEventDispatcher::PendingComposition::AppendClause(uint32_t aLength, uint32_t aAttribute) { if (NS_WARN_IF(!aLength)) { return NS_ERROR_INVALID_ARG; } switch (aAttribute) { case NS_TEXTRANGE_RAWINPUT: case NS_TEXTRANGE_SELECTEDRAWTEXT: case NS_TEXTRANGE_CONVERTEDTEXT: case NS_TEXTRANGE_SELECTEDCONVERTEDTEXT: { EnsureClauseArray(); TextRange textRange; textRange.mStartOffset = mClauses->IsEmpty() ? 0 : mClauses->LastElement().mEndOffset; textRange.mEndOffset = textRange.mStartOffset + aLength; textRange.mRangeType = aAttribute; mClauses->AppendElement(textRange); return NS_OK; } default: return NS_ERROR_INVALID_ARG; } } nsresult TextEventDispatcher::PendingComposition::SetCaret(uint32_t aOffset, uint32_t aLength) { mCaret.mStartOffset = aOffset; mCaret.mEndOffset = mCaret.mStartOffset + aLength; mCaret.mRangeType = NS_TEXTRANGE_CARETPOSITION; return NS_OK; } nsresult TextEventDispatcher::PendingComposition::Flush(TextEventDispatcher* aDispatcher, nsEventStatus& aStatus) { aStatus = nsEventStatus_eIgnore; nsresult rv = aDispatcher->GetState(); if (NS_WARN_IF(NS_FAILED(rv))) { return rv; } if (mClauses && !mClauses->IsEmpty() && mClauses->LastElement().mEndOffset != mString.Length()) { NS_WARNING("Sum of length of the all clauses must be same as the string " "length"); Clear(); return NS_ERROR_ILLEGAL_VALUE; } if (mCaret.mRangeType == NS_TEXTRANGE_CARETPOSITION) { if (mCaret.mEndOffset > mString.Length()) { NS_WARNING("Caret position is out of the composition string"); Clear(); return NS_ERROR_ILLEGAL_VALUE; } EnsureClauseArray(); mClauses->AppendElement(mCaret); } nsCOMPtr widget(aDispatcher->mWidget); WidgetCompositionEvent compChangeEvent(true, NS_COMPOSITION_CHANGE, widget); aDispatcher->InitEvent(compChangeEvent); compChangeEvent.mData = mString; if (mClauses) { MOZ_ASSERT(!mClauses->IsEmpty(), "mClauses must be non-empty array when it's not nullptr"); compChangeEvent.mRanges = mClauses; } // While this method dispatches a composition event, some other event handler // cause more clauses to be added. So, we should clear pending composition // before dispatching the event. Clear(); rv = aDispatcher->StartCompositionAutomaticallyIfNecessary(aStatus); if (NS_WARN_IF(NS_FAILED(rv))) { return rv; } if (aStatus == nsEventStatus_eConsumeNoDefault) { return NS_OK; } rv = widget->DispatchEvent(&compChangeEvent, aStatus); if (NS_WARN_IF(NS_FAILED(rv))) { return rv; } return NS_OK; } } // namespace widget } // namespace mozilla