2001-09-25 00:48:50 +00:00
|
|
|
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
|
|
/* ***** BEGIN LICENSE BLOCK *****
|
2004-04-17 21:52:36 +00:00
|
|
|
* Version: MPL 1.1/GPL 2.0/LGPL 2.1
|
2001-02-14 20:51:33 +00:00
|
|
|
*
|
2004-04-17 21:52:36 +00:00
|
|
|
* The contents of this file are subject to the Mozilla Public License Version
|
|
|
|
* 1.1 (the "License"); you may not use this file except in compliance with
|
|
|
|
* the License. You may obtain a copy of the License at
|
|
|
|
* http://www.mozilla.org/MPL/
|
2001-02-14 20:51:33 +00:00
|
|
|
*
|
2001-09-25 00:48:50 +00:00
|
|
|
* Software distributed under the License is distributed on an "AS IS" basis,
|
|
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
|
|
|
|
* for the specific language governing rights and limitations under the
|
|
|
|
* License.
|
2001-02-14 20:51:33 +00:00
|
|
|
*
|
|
|
|
* The Original Code is mozilla.org code.
|
|
|
|
*
|
2004-04-17 21:52:36 +00:00
|
|
|
* The Initial Developer of the Original Code is
|
2001-09-25 00:48:50 +00:00
|
|
|
* Netscape Communications Corporation.
|
|
|
|
* Portions created by the Initial Developer are Copyright (C) 1998
|
|
|
|
* the Initial Developer. All Rights Reserved.
|
2001-02-14 20:51:33 +00:00
|
|
|
*
|
2001-09-25 00:48:50 +00:00
|
|
|
* Contributor(s):
|
2004-04-17 21:52:36 +00:00
|
|
|
* John Gaunt (jgaunt@netscape.com)
|
2001-09-25 00:48:50 +00:00
|
|
|
*
|
|
|
|
* Alternatively, the contents of this file may be used under the terms of
|
2004-04-17 21:52:36 +00:00
|
|
|
* either of the GNU General Public License Version 2 or later (the "GPL"),
|
|
|
|
* or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
|
2001-09-25 00:48:50 +00:00
|
|
|
* in which case the provisions of the GPL or the LGPL are applicable instead
|
|
|
|
* of those above. If you wish to allow use of your version of this file only
|
|
|
|
* under the terms of either the GPL or the LGPL, and not to allow others to
|
2004-04-17 21:52:36 +00:00
|
|
|
* use your version of this file under the terms of the MPL, indicate your
|
2001-09-25 00:48:50 +00:00
|
|
|
* decision by deleting the provisions above and replace them with the notice
|
|
|
|
* and other provisions required by the GPL or the LGPL. If you do not delete
|
|
|
|
* the provisions above, a recipient may use your version of this file under
|
2004-04-17 21:52:36 +00:00
|
|
|
* the terms of any one of the MPL, the GPL or the LGPL.
|
|
|
|
*
|
2001-09-25 00:48:50 +00:00
|
|
|
* ***** END LICENSE BLOCK ***** */
|
2001-02-14 20:51:33 +00:00
|
|
|
|
|
|
|
#ifndef _nsAccessible_H_
|
|
|
|
#define _nsAccessible_H_
|
|
|
|
|
2003-04-01 20:02:51 +00:00
|
|
|
#include "nsAccessNodeWrap.h"
|
2001-10-09 21:52:36 +00:00
|
|
|
#include "nsIAccessible.h"
|
2003-07-09 07:01:46 +00:00
|
|
|
#include "nsPIAccessible.h"
|
2001-10-09 21:52:36 +00:00
|
|
|
#include "nsWeakReference.h"
|
2001-10-26 23:47:52 +00:00
|
|
|
#include "nsIDOMNodeList.h"
|
2003-04-15 08:45:55 +00:00
|
|
|
#include "nsString.h"
|
2001-02-14 20:51:33 +00:00
|
|
|
|
2003-04-15 08:45:55 +00:00
|
|
|
struct nsRect;
|
2001-10-09 21:52:36 +00:00
|
|
|
class nsIContent;
|
|
|
|
class nsIFrame;
|
2003-04-15 08:45:55 +00:00
|
|
|
class nsIPresShell;
|
|
|
|
class nsIDOMNode;
|
|
|
|
class nsIAtom;
|
2001-02-14 20:51:33 +00:00
|
|
|
|
2003-04-15 08:45:55 +00:00
|
|
|
// When mNextSibling is set to this, it indicates there ar eno more siblings
|
|
|
|
#define DEAD_END_ACCESSIBLE NS_STATIC_CAST(nsIAccessible*, (void*)1)
|
2001-10-26 23:47:52 +00:00
|
|
|
|
2005-01-28 02:35:26 +00:00
|
|
|
struct nsStateMapEntry
|
|
|
|
{
|
|
|
|
const char* attributeName; // magic value of nsnull means last entry in map
|
|
|
|
const char* attributeValue; // magic value of nsnull means any value
|
|
|
|
PRUint32 state; // OR state with this
|
|
|
|
};
|
|
|
|
|
|
|
|
struct nsRoleMapEntry
|
|
|
|
{
|
|
|
|
const char *roleString; // such as "button"
|
|
|
|
PRUint32 role; // use this role
|
|
|
|
PRUint32 state; // always OR state with this
|
|
|
|
// For this role with a DOM attribute/value match definined in
|
|
|
|
// nsStateMapEntry.attributeName && .attributeValue, OR accessible state with
|
|
|
|
// nsStateMapEntry.state
|
|
|
|
// Currently you can have up to 3 DOM attributes with accessible state mappings.
|
|
|
|
// A variable sized array would not allow use of C++'s struct initialization feature.
|
|
|
|
nsStateMapEntry attributeMap1;
|
|
|
|
nsStateMapEntry attributeMap2;
|
|
|
|
nsStateMapEntry attributeMap3;
|
|
|
|
};
|
|
|
|
|
2003-07-09 07:01:46 +00:00
|
|
|
class nsAccessible : public nsAccessNodeWrap,
|
|
|
|
public nsIAccessible,
|
|
|
|
public nsPIAccessible
|
2001-02-14 20:51:33 +00:00
|
|
|
{
|
2001-06-30 00:25:09 +00:00
|
|
|
public:
|
2001-11-07 00:12:16 +00:00
|
|
|
// to eliminate the confusion of "magic numbers" -- if ( 0 ){ foo; }
|
2005-02-01 03:51:57 +00:00
|
|
|
enum { eAction_Switch=0, eAction_Jump=0, eAction_Click=0, eAction_Select=0, eAction_Expand=1 };
|
2001-11-07 00:12:16 +00:00
|
|
|
// how many actions
|
2005-02-01 03:51:57 +00:00
|
|
|
enum { eNo_Action=0, eSingle_Action=1, eDouble_Action=2 };
|
2001-11-07 00:12:16 +00:00
|
|
|
|
Bug 109851, bug 108629, bug 109921, bug 109977, bug 109153, bug 109187, bug 109213, bug 109221. Check in latest XUL accessibility support - menus, <colorpicker>, <progressmeter>, <groupbox>, mixed states for checkboxes, buttons that can be 'checked' ie pressed down, fixes extra MSAA events being generated, couldn't see HTML content
2001-11-20 02:05:26 +00:00
|
|
|
nsAccessible(nsIDOMNode* aNode, nsIWeakReference* aShell);
|
|
|
|
virtual ~nsAccessible();
|
|
|
|
|
2003-04-01 20:02:51 +00:00
|
|
|
NS_DECL_ISUPPORTS_INHERITED
|
|
|
|
NS_DECL_NSIACCESSIBLE
|
2003-07-09 07:01:46 +00:00
|
|
|
NS_DECL_NSPIACCESSIBLE
|
2003-04-01 20:02:51 +00:00
|
|
|
|
2003-05-01 10:25:45 +00:00
|
|
|
// nsIAccessNode
|
2005-01-28 02:35:26 +00:00
|
|
|
NS_IMETHOD Init();
|
2003-05-01 10:25:45 +00:00
|
|
|
NS_IMETHOD Shutdown();
|
|
|
|
|
2005-01-28 02:35:26 +00:00
|
|
|
// Support GetFinalState(), GetFinalValue()
|
|
|
|
NS_IMETHOD GetState(PRUint32 *aState);
|
|
|
|
NS_IMETHOD GetValue(nsAString & aValue);
|
|
|
|
|
2003-03-20 08:27:31 +00:00
|
|
|
#ifdef MOZ_ACCESSIBILITY_ATK
|
2003-09-14 12:56:21 +00:00
|
|
|
static nsresult GetParentBlockNode(nsIPresShell *aPresShell, nsIDOMNode *aCurrentNode, nsIDOMNode **aBlockNode);
|
|
|
|
static nsIFrame* GetParentBlockFrame(nsIFrame *aFrame);
|
2004-07-31 23:15:21 +00:00
|
|
|
static PRBool FindTextFrame(PRInt32 &index, nsPresContext *aPresContext, nsIFrame *aCurFrame,
|
2003-09-14 12:56:21 +00:00
|
|
|
nsIFrame **aFirstTextFrame, const nsIFrame *aTextFrame);
|
2003-03-20 08:27:31 +00:00
|
|
|
#endif
|
|
|
|
|
2003-04-15 08:45:55 +00:00
|
|
|
static PRBool IsCorrectFrameType(nsIFrame* aFrame, nsIAtom* aAtom);
|
|
|
|
|
2001-02-14 20:51:33 +00:00
|
|
|
protected:
|
2005-01-28 02:35:26 +00:00
|
|
|
PRUint32 MappedAttrState(nsIContent *aContent, nsStateMapEntry *aStateMapEntry);
|
2001-03-28 00:49:05 +00:00
|
|
|
virtual nsIFrame* GetBoundsFrame();
|
2003-07-31 08:09:39 +00:00
|
|
|
virtual void GetBoundsRect(nsRect& aRect, nsIFrame** aRelativeFrame);
|
2002-10-08 17:49:52 +00:00
|
|
|
PRBool IsPartiallyVisible(PRBool *aIsOffscreen);
|
2004-07-06 13:00:40 +00:00
|
|
|
static nsIContent *GetLabelForId(nsIContent *aLookContent, nsIAtom *forAttrib,
|
|
|
|
const nsAString *aId);
|
|
|
|
static nsIContent *GetXULLabelContent(nsIContent *aForNode);
|
|
|
|
static nsIContent *GetHTMLLabelContent(nsIContent *aForNode);
|
|
|
|
nsresult GetHTMLName(nsAString& _retval);
|
|
|
|
nsresult GetXULName(nsAString& _retval);
|
2004-06-02 04:06:28 +00:00
|
|
|
// For accessibles that are not lists of choices, the name of the subtree should be the
|
|
|
|
// sum of names in the subtree
|
2004-07-06 13:00:40 +00:00
|
|
|
nsresult AppendFlatStringFromSubtree(nsIContent *aContent, nsAString *aFlatString);
|
|
|
|
nsresult AppendFlatStringFromContentNode(nsIContent *aContent, nsAString *aFlatString);
|
|
|
|
nsresult AppendStringWithSpaces(nsAString *aFlatString, const nsAString& textEquivalent);
|
2003-04-15 08:45:55 +00:00
|
|
|
|
Bug 109851, bug 108629, bug 109921, bug 109977, bug 109153, bug 109187, bug 109213, bug 109221. Check in latest XUL accessibility support - menus, <colorpicker>, <progressmeter>, <groupbox>, mixed states for checkboxes, buttons that can be 'checked' ie pressed down, fixes extra MSAA events being generated, couldn't see HTML content
2001-11-20 02:05:26 +00:00
|
|
|
// helper method to verify frames
|
2002-05-08 20:43:49 +00:00
|
|
|
static nsresult GetFullKeyName(const nsAString& aModifierName, const nsAString& aKeyName, nsAString& aStringOut);
|
2002-03-23 21:52:27 +00:00
|
|
|
static nsresult GetTranslatedString(const nsAString& aKey, nsAString& aStringOut);
|
2004-07-31 23:15:21 +00:00
|
|
|
void GetScreenOrigin(nsPresContext *aPresContext, nsIFrame *aFrame, nsRect *aRect);
|
2002-08-01 21:36:02 +00:00
|
|
|
nsresult AppendFlatStringFromSubtreeRecurse(nsIContent *aContent, nsAString *aFlatString);
|
2004-06-04 19:28:36 +00:00
|
|
|
virtual void CacheChildren(PRBool aWalkAnonContent);
|
2001-09-25 22:32:32 +00:00
|
|
|
|
2001-05-11 21:11:38 +00:00
|
|
|
// Data Members
|
2003-06-24 08:41:28 +00:00
|
|
|
nsCOMPtr<nsIAccessible> mParent;
|
|
|
|
nsIAccessible *mFirstChild, *mNextSibling;
|
2005-01-28 02:35:26 +00:00
|
|
|
nsRoleMapEntry *mRoleMapEntry; // Non-null indicates author-supplied role; possibly state & value as well
|
|
|
|
|
|
|
|
static nsRoleMapEntry gWAIRoleMap[];
|
|
|
|
static nsStateMapEntry gDisabledStateMap;
|
Bug 109851, bug 108629, bug 109921, bug 109977, bug 109153, bug 109187, bug 109213, bug 109221. Check in latest XUL accessibility support - menus, <colorpicker>, <progressmeter>, <groupbox>, mixed states for checkboxes, buttons that can be 'checked' ie pressed down, fixes extra MSAA events being generated, couldn't see HTML content
2001-11-20 02:05:26 +00:00
|
|
|
};
|
|
|
|
|
2005-01-28 02:35:26 +00:00
|
|
|
|
2001-02-14 20:51:33 +00:00
|
|
|
#endif
|
2003-04-15 08:45:55 +00:00
|
|
|
|