/* -*- 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 mozilla_a11y_XULTreeAccessible_h__ #define mozilla_a11y_XULTreeAccessible_h__ #include "nsITreeBoxObject.h" #include "nsITreeView.h" #include "nsITreeColumns.h" #include "XULListboxAccessible.h" class nsTreeBodyFrame; namespace mozilla { namespace a11y { class XULTreeGridCellAccessible; /* * A class the represents the XUL Tree widget. */ const uint32_t kMaxTreeColumns = 100; const uint32_t kDefaultTreeCacheLength = 128; /** * Accessible class for XUL tree element. */ class XULTreeAccessible : public AccessibleWrap { public: XULTreeAccessible(nsIContent* aContent, DocAccessible* aDoc, nsTreeBodyFrame* aTreeframe); // nsISupports and cycle collection NS_DECL_ISUPPORTS_INHERITED NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(XULTreeAccessible, Accessible) // Accessible virtual void Shutdown() override; virtual void Value(nsString& aValue) override; virtual a11y::role NativeRole() override; virtual uint64_t NativeState() override; virtual Accessible* ChildAtPoint(int32_t aX, int32_t aY, EWhichChildAtPoint aWhichChild) override; virtual Accessible* GetChildAt(uint32_t aIndex) const override; virtual uint32_t ChildCount() const override; virtual Relation RelationByType(RelationType aType) override; // SelectAccessible virtual void SelectedItems(nsTArray* aItems) override; virtual uint32_t SelectedItemCount() override; virtual Accessible* GetSelectedItem(uint32_t aIndex) override; virtual bool IsItemSelected(uint32_t aIndex) override; virtual bool AddItemToSelection(uint32_t aIndex) override; virtual bool RemoveItemFromSelection(uint32_t aIndex) override; virtual bool SelectAll() override; virtual bool UnselectAll() override; // Widgets virtual bool IsWidget() const override; virtual bool IsActiveWidget() const override; virtual bool AreItemsOperable() const override; virtual Accessible* CurrentItem() override; virtual void SetCurrentItem(Accessible* aItem) override; virtual Accessible* ContainerWidget() const override; // XULTreeAccessible /** * Return tree item accessible at the givem row. If accessible doesn't exist * in the cache then create and cache it. * * @param aRow [in] the given row index */ Accessible* GetTreeItemAccessible(int32_t aRow) const; /** * Invalidates the number of cached treeitem accessibles. * * @param aRow [in] row index the invalidation starts from * @param aCount [in] the number of treeitem accessibles to invalidate, * the number sign specifies whether rows have been * inserted (plus) or removed (minus) */ void InvalidateCache(int32_t aRow, int32_t aCount); /** * Fires name change events for invalidated area of tree. * * @param aStartRow [in] row index invalidation starts from * @param aEndRow [in] row index invalidation ends, -1 means last row index * @param aStartCol [in] column index invalidation starts from * @param aEndCol [in] column index invalidation ends, -1 mens last column * index */ void TreeViewInvalidated(int32_t aStartRow, int32_t aEndRow, int32_t aStartCol, int32_t aEndCol); /** * Invalidates children created for previous tree view. */ void TreeViewChanged(nsITreeView* aView); protected: virtual ~XULTreeAccessible(); /** * Creates tree item accessible for the given row index. */ virtual already_AddRefed CreateTreeItemAccessible(int32_t aRow) const; nsCOMPtr mTree; nsITreeView* mTreeView; mutable AccessibleHashtable mAccessibleCache; }; /** * Base class for tree item accessibles. */ #define XULTREEITEMBASEACCESSIBLE_IMPL_CID \ { /* 1ab79ae7-766a-443c-940b-b1e6b0831dfc */ \ 0x1ab79ae7, \ 0x766a, \ 0x443c, \ { 0x94, 0x0b, 0xb1, 0xe6, 0xb0, 0x83, 0x1d, 0xfc } \ } class XULTreeItemAccessibleBase : public AccessibleWrap { public: XULTreeItemAccessibleBase(nsIContent* aContent, DocAccessible* aDoc, Accessible* aParent, nsITreeBoxObject* aTree, nsITreeView* aTreeView, int32_t aRow); // nsISupports and cycle collection NS_DECL_ISUPPORTS_INHERITED NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(XULTreeItemAccessibleBase, AccessibleWrap) // Accessible virtual void Shutdown() override; virtual nsIntRect Bounds() const override; virtual GroupPos GroupPosition() override; virtual uint64_t NativeState() override; virtual uint64_t NativeInteractiveState() const override; virtual int32_t IndexInParent() const override; virtual Relation RelationByType(RelationType aType) override; virtual Accessible* FocusedChild() override; virtual void SetSelected(bool aSelect) override; virtual void TakeFocus() override; // ActionAccessible virtual uint8_t ActionCount() override; virtual void ActionNameAt(uint8_t aIndex, nsAString& aName) override; virtual bool DoAction(uint8_t aIndex) override; // Widgets virtual Accessible* ContainerWidget() const override; // XULTreeItemAccessibleBase NS_DECLARE_STATIC_IID_ACCESSOR(XULTREEITEMBASEACCESSIBLE_IMPL_CID) /** * Return row index associated with the accessible. */ int32_t GetRowIndex() const { return mRow; } /** * Return cell accessible for the given column. If XUL tree accessible is not * accessible table then return null. */ virtual XULTreeGridCellAccessible* GetCellAccessible(nsITreeColumn* aColumn) const { return nullptr; } /** * Proccess row invalidation. Used to fires name change events. */ virtual void RowInvalidated(int32_t aStartColIdx, int32_t aEndColIdx) = 0; protected: virtual ~XULTreeItemAccessibleBase(); enum { eAction_Click = 0, eAction_Expand = 1 }; // Accessible virtual void DispatchClickEvent(nsIContent *aContent, uint32_t aActionIndex) override; virtual Accessible* GetSiblingAtOffset(int32_t aOffset, nsresult *aError = nullptr) const override; // XULTreeItemAccessibleBase /** * Return true if the tree item accessible is expandable (contains subrows). */ bool IsExpandable(); /** * Return name for cell at the given column. */ void GetCellName(nsITreeColumn* aColumn, nsAString& aName); nsCOMPtr mTree; nsITreeView* mTreeView; int32_t mRow; }; NS_DEFINE_STATIC_IID_ACCESSOR(XULTreeItemAccessibleBase, XULTREEITEMBASEACCESSIBLE_IMPL_CID) /** * Accessible class for items for XUL tree. */ class XULTreeItemAccessible : public XULTreeItemAccessibleBase { public: XULTreeItemAccessible(nsIContent* aContent, DocAccessible* aDoc, Accessible* aParent, nsITreeBoxObject* aTree, nsITreeView* aTreeView, int32_t aRow); // nsISupports and cycle collection NS_DECL_ISUPPORTS_INHERITED NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(XULTreeItemAccessible, XULTreeItemAccessibleBase) // Accessible virtual void Shutdown() override; virtual ENameValueFlag Name(nsString& aName) override; virtual a11y::role NativeRole() override; // XULTreeItemAccessibleBase virtual void RowInvalidated(int32_t aStartColIdx, int32_t aEndColIdx) override; protected: virtual ~XULTreeItemAccessible(); // Accessible virtual void CacheChildren() override; // XULTreeItemAccessible nsCOMPtr mColumn; nsString mCachedName; }; /** * Accessible class for columns element of XUL tree. */ class XULTreeColumAccessible : public XULColumAccessible { public: XULTreeColumAccessible(nsIContent* aContent, DocAccessible* aDoc); protected: // Accessible virtual Accessible* GetSiblingAtOffset(int32_t aOffset, nsresult* aError = nullptr) const override; }; //////////////////////////////////////////////////////////////////////////////// // Accessible downcasting method inline XULTreeAccessible* Accessible::AsXULTree() { return IsXULTree() ? static_cast(this) : nullptr; } } // namespace a11y } // namespace mozilla #endif