diff -r 000000000000 -r 6474c204b198 accessible/src/xul/XULTreeAccessible.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/accessible/src/xul/XULTreeAccessible.h Wed Dec 31 06:09:35 2014 +0100 @@ -0,0 +1,283 @@ +/* -*- 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 { + +/* + * A class the represents the XUL Tree widget. + */ +const uint32_t kMaxTreeColumns = 100; +const uint32_t kDefaultTreeCacheSize = 256; + +/** + * Accessible class for XUL tree element. + */ + +class XULTreeAccessible : public AccessibleWrap +{ +public: + using Accessible::GetChildAt; + + 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(); + virtual void Value(nsString& aValue); + virtual a11y::role NativeRole(); + virtual uint64_t NativeState(); + virtual Accessible* ChildAtPoint(int32_t aX, int32_t aY, + EWhichChildAtPoint aWhichChild); + + virtual Accessible* GetChildAt(uint32_t aIndex) const MOZ_OVERRIDE; + virtual uint32_t ChildCount() const MOZ_OVERRIDE; + virtual Relation RelationByType(RelationType aType) MOZ_OVERRIDE; + + // SelectAccessible + virtual already_AddRefed SelectedItems(); + virtual uint32_t SelectedItemCount(); + virtual Accessible* GetSelectedItem(uint32_t aIndex); + virtual bool IsItemSelected(uint32_t aIndex); + virtual bool AddItemToSelection(uint32_t aIndex); + virtual bool RemoveItemFromSelection(uint32_t aIndex); + virtual bool SelectAll(); + virtual bool UnselectAll(); + + // Widgets + virtual bool IsWidget() const; + virtual bool IsActiveWidget() const; + virtual bool AreItemsOperable() const; + virtual Accessible* CurrentItem(); + virtual void SetCurrentItem(Accessible* aItem); + + virtual Accessible* ContainerWidget() const; + + // 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: + /** + * 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: + using Accessible::GetParent; + + 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) + + // nsIAccessible + NS_IMETHOD GetBounds(int32_t *aX, int32_t *aY, + int32_t *aWidth, int32_t *aHeight); + + NS_IMETHOD SetSelected(bool aSelect); + NS_IMETHOD TakeFocus(); + + NS_IMETHOD GetActionName(uint8_t aIndex, nsAString& aName); + NS_IMETHOD DoAction(uint8_t aIndex); + + // Accessible + virtual void Shutdown(); + virtual GroupPos GroupPosition(); + virtual uint64_t NativeState(); + virtual uint64_t NativeInteractiveState() const; + virtual int32_t IndexInParent() const; + virtual Relation RelationByType(RelationType aType) MOZ_OVERRIDE; + virtual Accessible* FocusedChild(); + + // ActionAccessible + virtual uint8_t ActionCount(); + + // Widgets + virtual Accessible* ContainerWidget() const; + + // 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 Accessible* 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: + enum { eAction_Click = 0, eAction_Expand = 1 }; + + // Accessible + virtual void DispatchClickEvent(nsIContent *aContent, uint32_t aActionIndex); + virtual Accessible* GetSiblingAtOffset(int32_t aOffset, + nsresult *aError = nullptr) const; + + // 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(); + virtual ENameValueFlag Name(nsString& aName); + virtual a11y::role NativeRole(); + + // XULTreeItemAccessibleBase + virtual void RowInvalidated(int32_t aStartColIdx, int32_t aEndColIdx); + +protected: + + // Accessible + virtual void CacheChildren(); + + // 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; +}; + + +//////////////////////////////////////////////////////////////////////////////// +// Accessible downcasting method + +inline XULTreeAccessible* +Accessible::AsXULTree() +{ + return IsXULTree() ? static_cast(this) : nullptr; +} + +} // namespace a11y +} // namespace mozilla + +#endif