1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/accessible/public/nsIAccessibleStates.idl Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,76 @@
1.4 +/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
1.5 +/* This Source Code Form is subject to the terms of the Mozilla Public
1.6 + * License, v. 2.0. If a copy of the MPL was not distributed with this
1.7 + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
1.8 +
1.9 +#include "nsISupports.idl"
1.10 +
1.11 +[scriptable, uuid(f1e0fbb7-fde4-4519-9383-2bcbee428513)]
1.12 +interface nsIAccessibleStates : nsISupports
1.13 +{
1.14 + /**
1.15 + * MSAA State flags - used for bitfield. More than 1 allowed.
1.16 + */
1.17 + const unsigned long STATE_UNAVAILABLE = 0x00000001; // Disabled, maps to opposite of Java ENABLED, Gnome/ATK SENSITIVE?
1.18 + const unsigned long STATE_SELECTED = 0x00000002;
1.19 + const unsigned long STATE_FOCUSED = 0x00000004;
1.20 + const unsigned long STATE_PRESSED = 0x00000008;
1.21 + const unsigned long STATE_CHECKED = 0x00000010;
1.22 + const unsigned long STATE_MIXED = 0x00000020; // 3-state checkbox or toolbar button
1.23 + const unsigned long STATE_READONLY = 0x00000040; // Maps to opposite of Java/Gnome/ATK EDITABLE state
1.24 + const unsigned long STATE_HOTTRACKED = 0x00000080;
1.25 + const unsigned long STATE_DEFAULT = 0x00000100;
1.26 + const unsigned long STATE_EXPANDED = 0x00000200;
1.27 + const unsigned long STATE_COLLAPSED = 0x00000400;
1.28 + const unsigned long STATE_BUSY = 0x00000800;
1.29 + const unsigned long STATE_FLOATING = 0x00001000; // Children "owned" not "contained" by parent
1.30 + const unsigned long STATE_MARQUEED = 0x00002000;
1.31 + const unsigned long STATE_ANIMATED = 0x00004000;
1.32 + const unsigned long STATE_INVISIBLE = 0x00008000; // Programatically hidden
1.33 + const unsigned long STATE_OFFSCREEN = 0x00010000; // Scrolled off
1.34 + const unsigned long STATE_SIZEABLE = 0x00020000;
1.35 + const unsigned long STATE_MOVEABLE = 0x00040000;
1.36 + const unsigned long STATE_SELFVOICING = 0x00080000;
1.37 + const unsigned long STATE_FOCUSABLE = 0x00100000;
1.38 + const unsigned long STATE_SELECTABLE = 0x00200000;
1.39 + const unsigned long STATE_LINKED = 0x00400000;
1.40 + const unsigned long STATE_TRAVERSED = 0x00800000;
1.41 + const unsigned long STATE_MULTISELECTABLE = 0x01000000; // Supports multiple selection
1.42 + const unsigned long STATE_EXTSELECTABLE = 0x02000000; // Supports extended selection
1.43 + const unsigned long STATE_ALERT_LOW = 0x04000000; // This information is of low priority
1.44 + const unsigned long STATE_ALERT_MEDIUM = 0x08000000; // This information is of medium priority
1.45 + const unsigned long STATE_ALERT_HIGH = 0x10000000; // This information is of high priority
1.46 + const unsigned long STATE_PROTECTED = 0x20000000; // Maps to Gnome's *Role* ATK_ROLE_PASSWD_TEXT, nothing for Java?
1.47 + const unsigned long STATE_HASPOPUP = 0x40000000; // New in MSAA 2.0
1.48 +
1.49 + // Mapping important states that we don't have to unused alert states on MSAA
1.50 + // as per discussions with AT vendors. On ATK there will be legitimate states for
1.51 + // STATE_REQUIRED AND STATE_INVALID
1.52 + const unsigned long STATE_REQUIRED = STATE_ALERT_LOW;
1.53 + const unsigned long STATE_IMPORTANT = STATE_ALERT_MEDIUM; // Not currently used
1.54 + const unsigned long STATE_INVALID = STATE_ALERT_HIGH;
1.55 + const unsigned long STATE_CHECKABLE = STATE_MARQUEED;
1.56 +
1.57 +/**
1.58 + * Extended state flags (for now non-MSAA, for Java and Gnome/ATK support)
1.59 + * "Extended state flags" has separate value space from "MSAA State flags".
1.60 + */
1.61 + const unsigned long EXT_STATE_SUPPORTS_AUTOCOMPLETION = 0x00000001; // For editable areas that have any kind of autocompletion
1.62 + const unsigned long EXT_STATE_DEFUNCT = 0x00000002; // Object no longer exists
1.63 + const unsigned long EXT_STATE_SELECTABLE_TEXT = 0x00000004; // For text which is selectable, object must implement nsIAccessibleText
1.64 + const unsigned long EXT_STATE_EDITABLE = 0x00000008; // Implements nsIAccessibleEditableText
1.65 + const unsigned long EXT_STATE_ACTIVE = 0x00000010; // This window is currently the active window
1.66 + const unsigned long EXT_STATE_MODAL = 0x00000020; // Must do something with control before leaving it
1.67 + const unsigned long EXT_STATE_MULTI_LINE = 0x00000040; // Edit control that can take multiple lines
1.68 + const unsigned long EXT_STATE_HORIZONTAL = 0x00000080; // Uses horizontal layout
1.69 + const unsigned long EXT_STATE_OPAQUE = 0x00000100; // Indicates this object paints every pixel within its rectangular region.
1.70 + const unsigned long EXT_STATE_SINGLE_LINE = 0x00000200; // This text object can only contain 1 line of text
1.71 + const unsigned long EXT_STATE_TRANSIENT = 0x00000400; //
1.72 + const unsigned long EXT_STATE_VERTICAL = 0x00000800; // Especially used for sliders and scrollbars
1.73 + const unsigned long EXT_STATE_STALE = 0x00001000; // Object not dead, but not up-to-date either
1.74 + const unsigned long EXT_STATE_ENABLED = 0x00002000; // A widget that is not unavailable
1.75 + const unsigned long EXT_STATE_SENSITIVE = 0x00004000; // Same as ENABLED for now
1.76 + const unsigned long EXT_STATE_EXPANDABLE = 0x00008000; // If COLLAPSED or EXPANDED
1.77 + const unsigned long EXT_STATE_PINNED = 0x00010000; // Indicates object is pinned.
1.78 +};
1.79 +
