summaryrefslogtreecommitdiffstats
path: root/accessible/base/nsAccessiblePivot.h
diff options
context:
space:
mode:
Diffstat (limited to 'accessible/base/nsAccessiblePivot.h')
-rw-r--r--accessible/base/nsAccessiblePivot.h140
1 files changed, 140 insertions, 0 deletions
diff --git a/accessible/base/nsAccessiblePivot.h b/accessible/base/nsAccessiblePivot.h
new file mode 100644
index 0000000000..dd5808a429
--- /dev/null
+++ b/accessible/base/nsAccessiblePivot.h
@@ -0,0 +1,140 @@
+/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim: set ts=2 et sw=2 tw=80: */
+/* 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 _nsAccessiblePivot_H_
+#define _nsAccessiblePivot_H_
+
+#include "nsIAccessiblePivot.h"
+
+#include "LocalAccessible-inl.h"
+#include "nsTObserverArray.h"
+#include "nsCycleCollectionParticipant.h"
+#include "mozilla/Attributes.h"
+
+class RuleCache;
+
+/**
+ * Class represents an accessible pivot.
+ */
+class nsAccessiblePivot final : public nsIAccessiblePivot {
+ public:
+ typedef mozilla::a11y::LocalAccessible LocalAccessible;
+
+ explicit nsAccessiblePivot(LocalAccessible* aRoot);
+
+ NS_DECL_CYCLE_COLLECTING_ISUPPORTS
+ NS_DECL_CYCLE_COLLECTION_CLASS_AMBIGUOUS(nsAccessiblePivot,
+ nsIAccessiblePivot)
+
+ NS_DECL_NSIACCESSIBLEPIVOT
+
+ /*
+ * A simple getter for the pivot's position.
+ */
+ LocalAccessible* Position() { return mPosition; }
+
+ int32_t StartOffset() { return mStartOffset; }
+
+ int32_t EndOffset() { return mEndOffset; }
+
+ private:
+ ~nsAccessiblePivot();
+ nsAccessiblePivot() = delete;
+ nsAccessiblePivot(const nsAccessiblePivot&) = delete;
+ void operator=(const nsAccessiblePivot&) = delete;
+
+ /*
+ * Notify all observers on a pivot change. Return true if it has changed and
+ * observers have been notified.
+ */
+ bool NotifyOfPivotChange(LocalAccessible* aOldAccessible, int32_t aOldStart,
+ int32_t aOldEnd, PivotMoveReason aReason,
+ TextBoundaryType aBoundaryType,
+ bool aIsFromUserInput);
+
+ /*
+ * Check to see that the given accessible is a descendant of given ancestor
+ */
+ bool IsDescendantOf(LocalAccessible* aAccessible, LocalAccessible* aAncestor);
+
+ /*
+ * Search in preorder for the first accessible to match the rule.
+ */
+ LocalAccessible* SearchForward(LocalAccessible* aAccessible,
+ nsIAccessibleTraversalRule* aRule,
+ bool aSearchCurrent, nsresult* aResult);
+
+ /*
+ * Reverse search in preorder for the first accessible to match the rule.
+ */
+ LocalAccessible* SearchBackward(LocalAccessible* aAccessible,
+ nsIAccessibleTraversalRule* aRule,
+ bool aSearchCurrent, nsresult* aResult);
+
+ /*
+ * Get the effective root for this pivot, either the true root or modal root.
+ */
+ LocalAccessible* GetActiveRoot() const {
+ if (mModalRoot) {
+ NS_ENSURE_FALSE(mModalRoot->IsDefunct(), mRoot);
+ return mModalRoot;
+ }
+
+ return mRoot;
+ }
+
+ /*
+ * Update the pivot, and notify observers. Return true if it moved.
+ */
+ bool MovePivotInternal(LocalAccessible* aPosition, PivotMoveReason aReason,
+ bool aIsFromUserInput);
+
+ /*
+ * Get initial node we should start a search from with a given rule.
+ *
+ * When we do a move operation from one position to another,
+ * the initial position can be inside of a subtree that is ignored by
+ * the given rule. We need to step out of the ignored subtree and start
+ * the search from there.
+ *
+ */
+ LocalAccessible* AdjustStartPosition(LocalAccessible* aAccessible,
+ RuleCache& aCache,
+ uint16_t* aFilterResult,
+ nsresult* aResult);
+
+ /*
+ * The root accessible.
+ */
+ RefPtr<LocalAccessible> mRoot;
+
+ /*
+ * The temporary modal root accessible.
+ */
+ RefPtr<LocalAccessible> mModalRoot;
+
+ /*
+ * The current pivot position.
+ */
+ RefPtr<LocalAccessible> mPosition;
+
+ /*
+ * The text start offset ofthe pivot.
+ */
+ int32_t mStartOffset;
+
+ /*
+ * The text end offset ofthe pivot.
+ */
+ int32_t mEndOffset;
+
+ /*
+ * The list of pivot-changed observers.
+ */
+ nsTObserverArray<nsCOMPtr<nsIAccessiblePivotObserver> > mObservers;
+};
+
+#endif