X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/c6e2af4570ee868c93fc504b02f321efe5d5acee..32485259c1342115488d219776dfebeb3d4d81b1:/include/wx/access.h diff --git a/include/wx/access.h b/include/wx/access.h index 7e06de9a16..4d320fef47 100644 --- a/include/wx/access.h +++ b/include/wx/access.h @@ -12,7 +12,7 @@ #ifndef _WX_ACCESSBASE_H_ #define _WX_ACCESSBASE_H_ -#if defined(__GNUG__) && !defined(__APPLE__) +#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA) #pragma interface "accessbase.h" #endif @@ -40,414 +40,127 @@ typedef enum typedef enum { wxNAVDIR_DOWN, - // Navigate to the sibling object located below the starting object. - wxNAVDIR_FIRSTCHILD, - // Navigate to the first child of this object. When using this flag, - // the lVal member of the varStart parameter must be CHILDID_SELF. - wxNAVDIR_LASTCHILD, - // Navigate to the last child of this object. When using this flag, - // the lVal member of the varStart parameter must be CHILDID_SELF. - wxNAVDIR_LEFT, - // Navigate to the sibling object located to the left of the starting object. - wxNAVDIR_NEXT, - // Navigate to the next logical object, generally a sibling to the starting object. - wxNAVDIR_PREVIOUS, - // Navigate to the previous logical object, generally a sibling to the starting object. - wxNAVDIR_RIGHT, - // Navigate to the sibling object located to the right of the starting object. - wxNAVDIR_UP - // Navigate to the sibling object located above the starting object. } wxNavDir; // Role constants -typedef enum { +typedef enum { wxROLE_NONE, - // No assigned role. wxROLE_SYSTEM_ALERT, - // The object represents an alert or a condition that a user should - // be notified about. This role is used only for objects that embody - // an alert but are not associated with another user interface element - // such as a message box, graphic, text, or sound. wxROLE_SYSTEM_ANIMATION, - // The object represents an animation control, which contains content - // that changes over time, such as a control that displays a series of - // bitmap frames, like a film strip. Animation controls are displayed - // when files are copied, or when some other time-consuming task is performed. wxROLE_SYSTEM_APPLICATION, - // The object represents a main window for an application. wxROLE_SYSTEM_BORDER, - // The object represents a window border. The entire border is - // represented by a single object, rather than by separate objects - // for each side. wxROLE_SYSTEM_BUTTONDROPDOWN, - // The object represents a button that drops down a list of items. wxROLE_SYSTEM_BUTTONDROPDOWNGRID, - // The object represents a button that drops down a grid. wxROLE_SYSTEM_BUTTONMENU, - // The object represents a button that drops down a menu. wxROLE_SYSTEM_CARET, - // The object represents the system caret. wxROLE_SYSTEM_CELL, - // The object represents a cell within a table. wxROLE_SYSTEM_CHARACTER, - // The object represents a cartoon-like graphic object which is - // displayed to provide help to users of an application. wxROLE_SYSTEM_CHART, - // The object represents a graphical image used to represent data. wxROLE_SYSTEM_CHECKBUTTON, - // The object represents a check box control, an option turned on - // or off independently of other options. wxROLE_SYSTEM_CLIENT, - // The object represents a window's client area. wxROLE_SYSTEM_CLOCK, - // The object represents a control that displays time. wxROLE_SYSTEM_COLUMN, - // The object represents a column of cells within a table. wxROLE_SYSTEM_COLUMNHEADER, - // The object represents a column header, providing a visual label - // for a column in a table. wxROLE_SYSTEM_COMBOBOX, - // The object represents a combo box; an edit control with an - // associated list box that provides a set of predefined choices. wxROLE_SYSTEM_CURSOR, - // The object represents the system mouse pointer. wxROLE_SYSTEM_DIAGRAM, - // The object represents a graphical image used to diagram data. wxROLE_SYSTEM_DIAL, - // The object represents a dial or knob. This is also a read-only - // object with like a speedometer. wxROLE_SYSTEM_DIALOG, - // The object represents a dialog box or message box. wxROLE_SYSTEM_DOCUMENT, - // The object represents a document window. A document window is - // always contained within an application window. This role applies - // only to multiple-document interface (MDI) windows and refers to - // the object that contains the MDI title bar. wxROLE_SYSTEM_DROPLIST, - // The object represents a drop-down list box. It shows one item and - // allows the user to display and select another from a list of - // alternative values. wxROLE_SYSTEM_EQUATION, - // The object represents a mathematical equation. wxROLE_SYSTEM_GRAPHIC, - // The object represents a picture. wxROLE_SYSTEM_GRIP, - // The object represents a special mouse pointer, which allows a user - // to manipulate user interface elements such as a window. For - // example, a user clicks and drags a sizing grip in the lower-right - // corner of a window to resize it. wxROLE_SYSTEM_GROUPING, - // The object logically groups other objects. There is not always a - // parent-child relationship between the grouping object and the - // objects it contains. wxROLE_SYSTEM_HELPBALLOON, - // The object displays help in the form of a ToolTip or help balloon. wxROLE_SYSTEM_HOTKEYFIELD, - // The object represents a hot-key field that allows the user to - // enter a combination or sequence of keystrokes. wxROLE_SYSTEM_INDICATOR, - // The object represents an indicator such as a pointer graphic - // that points to the current item. wxROLE_SYSTEM_LINK, - // The object represents a link to something else. This object might - // look like text or a graphic, but it acts like a button. wxROLE_SYSTEM_LIST, - // The object represents a list box, allowing the user to select - // one or more items. wxROLE_SYSTEM_LISTITEM, - // The object represents an item in a list box or the list portion - // of a combo box, drop-down list box, or drop-down combo box. wxROLE_SYSTEM_MENUBAR, - // The object represents the menu bar, following (beneath) the title - // bar of a window, from which menus are selected by the user. wxROLE_SYSTEM_MENUITEM, - // The object represents a menu item, which is an entry in a menu - // that a user can choose to carry out a command, select an option, - // or display another menu. Functionally, a menu item is equivalent - // to a push button, radio button, check box, or menu. wxROLE_SYSTEM_MENUPOPUP, - // The object represents a menu, which presents a list of options - // from which the user can make a selection to perform an action. - // All menu types must have this role, including drop-down menus - // that are displayed by selection from a menu bar, and shortcut - // menus that are displayed when the right mouse button is clicked. wxROLE_SYSTEM_OUTLINE, - // The object represents an outline or tree structure, such as a - // tree view control, which displays a hierarchical list and allows - // the user to expand and collapse branches. wxROLE_SYSTEM_OUTLINEITEM, - // The object represents an item in an outline or tree structure. wxROLE_SYSTEM_PAGETAB, - // The object represents a page tab. The only child of a page tab - // control is a wxROLE_SYSTEM_GROUPING object that contains the - // contents of the associated page. wxROLE_SYSTEM_PAGETABLIST, - // The object represents a container of page tab controls. wxROLE_SYSTEM_PANE, - // The object represents a pane within a frame or document window. - // Users can navigate between panes and within the contents of the - // current pane, but cannot navigate between items in different panes. - // Thus, panes represent a level of grouping lower than frame windows - // or documents, but above individual controls. The user navigates - // between panes by pressing TAB, F6, or CTRL+TAB, depending on - // the context. wxROLE_SYSTEM_PROGRESSBAR, - // The object represents a progress bar, dynamically showing the user - // the percent complete of an operation in progress. This control takes no user input. wxROLE_SYSTEM_PROPERTYPAGE, - // The object represents a property sheet. wxROLE_SYSTEM_PUSHBUTTON, - // The object represents a push button control. wxROLE_SYSTEM_RADIOBUTTON, - // The object represents an option button, also called a radio button. - // It is one of a group of mutually exclusive options. All objects - // sharing a single parent that have this attribute are assumed to - // be part of single mutually exclusive group. Use - // wxROLE_SYSTEM_GROUPING objects to divide them into separate groups. wxROLE_SYSTEM_ROW, - // The object represents a row of cells within a table. wxROLE_SYSTEM_ROWHEADER, - // The object represents a row header, that provides a visual label - // for a table row. wxROLE_SYSTEM_SCROLLBAR, - // The object represents a vertical or horizontal scroll bar, which - // is part of the client area or used in a control. wxROLE_SYSTEM_SEPARATOR, - // The object is used to visually divide a space into two regions, - // such as a separator menu item or a bar that divides split panes - // within a window. wxROLE_SYSTEM_SLIDER, - // The object represents a slider, which allows the user to adjust - // a setting in given increments between minimum and maximum values. wxROLE_SYSTEM_SOUND, - // The object represents a system sound, which is associated with - // various system events. wxROLE_SYSTEM_SPINBUTTON, - // The object represents a spin box, which is a control that allows - // the user to increment or decrement the value displayed in a - // separate "buddy" control associated with the spin box. wxROLE_SYSTEM_STATICTEXT, - // The object represents read-only text such as labels for other - // controls or instructions in a dialog box. Static text cannot be - // modified or selected. wxROLE_SYSTEM_STATUSBAR, - // The object represents a status bar, which is an area at the - // bottom of a window that displays information about the current - // operation, state of the application, or selected object. The - // status bar has multiple fields, which display different kinds - // of information. wxROLE_SYSTEM_TABLE, - // The object represents a table that contains rows and columns of - // cells, and optionally, row headers and column headers. wxROLE_SYSTEM_TEXT, - // The object represents selectable text that allows edits or is read-only. wxROLE_SYSTEM_TITLEBAR, - // The object represents a title or caption bar for a window. wxROLE_SYSTEM_TOOLBAR, - // The object represents a toolbar, which is a grouping of controls - // that provide easy access to frequently used features. wxROLE_SYSTEM_TOOLTIP, - // The object represents a ToolTip that provides helpful hints. wxROLE_SYSTEM_WHITESPACE, - // The object represents blank space between other objects. wxROLE_SYSTEM_WINDOW - // The object represents the window frame, which contains child objects - // such as a title bar, client, and other objects contained in a window. } wxAccRole; -// Accessible states +// Object types + +typedef enum { + wxOBJID_WINDOW = 0x00000000, + wxOBJID_SYSMENU = 0xFFFFFFFF, + wxOBJID_TITLEBAR = 0xFFFFFFFE, + wxOBJID_MENU = 0xFFFFFFFD, + wxOBJID_CLIENT = 0xFFFFFFFC, + wxOBJID_VSCROLL = 0xFFFFFFFB, + wxOBJID_HSCROLL = 0xFFFFFFFA, + wxOBJID_SIZEGRIP = 0xFFFFFFF9, + wxOBJID_CARET = 0xFFFFFFF8, + wxOBJID_CURSOR = 0xFFFFFFF7, + wxOBJID_ALERT = 0xFFFFFFF6, + wxOBJID_SOUND = 0xFFFFFFF5 +} wxAccObject; -#define wxACC_STATE_SYSTEM_ALERT_HIGH 0x0000001 -/* - Indicates important information to convey to the user - immediately. For example, a battery level indicator that - reaches a critical low level transitions to this state, - in which case a blind access utility announces this - information immediately to the user, and a screen - magnification program scrolls the screen so the battery - indicator is in view. This state is also appropriate for - any prompt or operation that must be completed before - the user can continue. -*/ +// Accessible states +#define wxACC_STATE_SYSTEM_ALERT_HIGH 0x00000001 #define wxACC_STATE_SYSTEM_ALERT_MEDIUM 0x00000002 -/* - Indicates important information that is not conveyed to - the user immediately. For example, when a battery level - indicator is starting to reach a low level, it generates - a medium-level alert. Blind access utilities then - generate a sound to let the user know that important - information is available, without actually interrupting - the user's work. The user could then query the alert - information at his or her leisure. -*/ - #define wxACC_STATE_SYSTEM_ALERT_LOW 0x00000004 -/* - Indicates low-priority information that is not important - to the user. This state is used, for example, when Word - changes the appearance of the TipWizard button on its - toolbar to indicate that it has a hint for the user. -*/ - #define wxACC_STATE_SYSTEM_ANIMATED 0x00000008 -/* - The object's appearance changes rapidly or constantly. - Graphics that are occasionally animated are described as - wxROLE_SYSTEM_GRAPHIC with the State property set to - This state is be used to indicate - that the object's location is changing. -*/ - #define wxACC_STATE_SYSTEM_BUSY 0x00000010 -/* - The control cannot accept input at this time. -*/ - #define wxACC_STATE_SYSTEM_CHECKED 0x00000020 -/* - The object's check box is selected. -*/ - #define wxACC_STATE_SYSTEM_COLLAPSED 0x00000040 -/* - Children of this object that have the - ROLE_SYSTEM_OUTLINEITEM role are hidden. -*/ - #define wxACC_STATE_SYSTEM_DEFAULT 0x00000080 -/* - The default button or menu item. -*/ - #define wxACC_STATE_SYSTEM_EXPANDED 0x00000100 -/* - Children of this object that have the - ROLE_SYSTEM_OUTLINEITEM role are displayed. -*/ - #define wxACC_STATE_SYSTEM_EXTSELECTABLE 0x00000200 -/* - Indicates that an object extends its selection using - SELFLAG_EXTENDSELECTION in the IAccessible::accSelect - method. -*/ - #define wxACC_STATE_SYSTEM_FLOATING 0x00000400 -/* - The object is not clipped to the boundary of its parent - object and does not move automatically when the parent - moves. -*/ - #define wxACC_STATE_SYSTEM_FOCUSABLE 0x00000800 -/* - The object is on the active window and ready to receive - keyboard focus. -*/ - #define wxACC_STATE_SYSTEM_FOCUSED 0x00001000 -/* - The object has the keyboard focus. Do not confuse object - focus with object selection. For more information, see - Selection and Focus Properties and Methods. -*/ - #define wxACC_STATE_SYSTEM_HOTTRACKED 0x00002000 -/* - The object is hot-tracked by the mouse, meaning that its - appearance has changed to indicate that the mouse - pointer is located over it. -*/ - #define wxACC_STATE_SYSTEM_INVISIBLE 0x00004000 -/* - Object is hidden or not visible. A list of files names - in a list box contain several hundred names, but only a - few are visible to the user. The rest are clipped by the - parent and have wxACC_STATE_SYSTEM_INVISIBLE set. Objects that - are never visible are set as wxACC_STATE_SYSTEM_OFFSCREEN. - Note that an object is considered visible when the - wxACC_STATE_SYSTEM_INVISIBLE flag is not set, and yet obscured - by another application, so is not visible to the user. - For example, an object is considered visible if it - appears in the main window of an application even though - it is obscured by a dialog. -*/ - #define wxACC_STATE_SYSTEM_MARQUEED 0x00008000 -/* - Indicates scrolling or moving text or graphics. -*/ - #define wxACC_STATE_SYSTEM_MIXED 0x00010000 -/* - Indicates that the state of a three-state check box or - toolbar button is not determined. The check box is - neither checked nor unchecked and is therefore in the - third or mixed state. -*/ - #define wxACC_STATE_SYSTEM_MULTISELECTABLE 0x00020000 -/* - Object accepts multiple selected items, - SELFLAG_ADDSELECTION for the IAccessible::accSelect - method is valid. -*/ - #define wxACC_STATE_SYSTEM_OFFSCREEN 0x00040000 -/* - Indicates that the object has no on-screen - representation. A sound or alert object has this state, - or a hidden window that is never made visible. -*/ - #define wxACC_STATE_SYSTEM_PRESSED 0x00080000 -/* - The object is pressed. -*/ - #define wxACC_STATE_SYSTEM_PROTECTED 0x00100000 -/* - The object is a password-protected edit control. -*/ - #define wxACC_STATE_SYSTEM_READONLY 0x00200000 -/* - The object is read-only. -*/ - #define wxACC_STATE_SYSTEM_SELECTABLE 0x00400000 -/* - The object accepts selection. -*/ - #define wxACC_STATE_SYSTEM_SELECTED 0x00800000 -/* - The object is selected. -*/ - #define wxACC_STATE_SYSTEM_SELFVOICING 0x01000000 -/* - The object or child uses text-to-speech (TTS) for - description purposes. A speech-based accessibility aid - does not announce information when an object with this - state has the focus because the object automatically - announces information. -*/ - #define wxACC_STATE_SYSTEM_UNAVAILABLE 0x02000000 -/* - The object is unavailable. -*/ // Selection flag @@ -461,28 +174,78 @@ typedef enum wxACC_SEL_REMOVESELECTION = 16 } wxAccSelectionFlags; +// Accessibility event identifiers + +#define wxACC_EVENT_SYSTEM_SOUND 0x0001 +#define wxACC_EVENT_SYSTEM_ALERT 0x0002 +#define wxACC_EVENT_SYSTEM_FOREGROUND 0x0003 +#define wxACC_EVENT_SYSTEM_MENUSTART 0x0004 +#define wxACC_EVENT_SYSTEM_MENUEND 0x0005 +#define wxACC_EVENT_SYSTEM_MENUPOPUPSTART 0x0006 +#define wxACC_EVENT_SYSTEM_MENUPOPUPEND 0x0007 +#define wxACC_EVENT_SYSTEM_CAPTURESTART 0x0008 +#define wxACC_EVENT_SYSTEM_CAPTUREEND 0x0009 +#define wxACC_EVENT_SYSTEM_MOVESIZESTART 0x000A +#define wxACC_EVENT_SYSTEM_MOVESIZEEND 0x000B +#define wxACC_EVENT_SYSTEM_CONTEXTHELPSTART 0x000C +#define wxACC_EVENT_SYSTEM_CONTEXTHELPEND 0x000D +#define wxACC_EVENT_SYSTEM_DRAGDROPSTART 0x000E +#define wxACC_EVENT_SYSTEM_DRAGDROPEND 0x000F +#define wxACC_EVENT_SYSTEM_DIALOGSTART 0x0010 +#define wxACC_EVENT_SYSTEM_DIALOGEND 0x0011 +#define wxACC_EVENT_SYSTEM_SCROLLINGSTART 0x0012 +#define wxACC_EVENT_SYSTEM_SCROLLINGEND 0x0013 +#define wxACC_EVENT_SYSTEM_SWITCHSTART 0x0014 +#define wxACC_EVENT_SYSTEM_SWITCHEND 0x0015 +#define wxACC_EVENT_SYSTEM_MINIMIZESTART 0x0016 +#define wxACC_EVENT_SYSTEM_MINIMIZEEND 0x0017 +#define wxACC_EVENT_OBJECT_CREATE 0x8000 +#define wxACC_EVENT_OBJECT_DESTROY 0x8001 +#define wxACC_EVENT_OBJECT_SHOW 0x8002 +#define wxACC_EVENT_OBJECT_HIDE 0x8003 +#define wxACC_EVENT_OBJECT_REORDER 0x8004 +#define wxACC_EVENT_OBJECT_FOCUS 0x8005 +#define wxACC_EVENT_OBJECT_SELECTION 0x8006 +#define wxACC_EVENT_OBJECT_SELECTIONADD 0x8007 +#define wxACC_EVENT_OBJECT_SELECTIONREMOVE 0x8008 +#define wxACC_EVENT_OBJECT_SELECTIONWITHIN 0x8009 +#define wxACC_EVENT_OBJECT_STATECHANGE 0x800A +#define wxACC_EVENT_OBJECT_LOCATIONCHANGE 0x800B +#define wxACC_EVENT_OBJECT_NAMECHANGE 0x800C +#define wxACC_EVENT_OBJECT_DESCRIPTIONCHANGE 0x800D +#define wxACC_EVENT_OBJECT_VALUECHANGE 0x800E +#define wxACC_EVENT_OBJECT_PARENTCHANGE 0x800F +#define wxACC_EVENT_OBJECT_HELPCHANGE 0x8010 +#define wxACC_EVENT_OBJECT_DEFACTIONCHANGE 0x8011 +#define wxACC_EVENT_OBJECT_ACCELERATORCHANGE 0x8012 + // ---------------------------------------------------------------------------- // wxAccessible // All functions return an indication of success, failure, or not implemented. // ---------------------------------------------------------------------------- class WXDLLEXPORT wxAccessible; +class WXDLLEXPORT wxWindow; +class WXDLLEXPORT wxPoint; +class WXDLLEXPORT wxRect; class WXDLLEXPORT wxAccessibleBase : public wxObject { DECLARE_NO_COPY_CLASS(wxAccessibleBase) public: - wxAccessibleBase(wxWindow* win): m_window(win) {}; - virtual ~wxAccessibleBase() {}; + wxAccessibleBase(wxWindow* win): m_window(win) {} + virtual ~wxAccessibleBase() {} // Overridables // Can return either a child object, or an integer // representing the child element, starting from 1. + // pt is in screen coordinates. virtual wxAccStatus HitTest(const wxPoint& WXUNUSED(pt), int* WXUNUSED(childId), wxAccessible** WXUNUSED(childObject)) { return wxACC_NOT_IMPLEMENTED; } // Returns the rectangle for this object (id = 0) or a child element (id > 0). + // rect is in screen coordinates. virtual wxAccStatus GetLocation(wxRect& WXUNUSED(rect), int WXUNUSED(elementId)) { return wxACC_NOT_IMPLEMENTED; } @@ -496,7 +259,7 @@ public: { return wxACC_NOT_IMPLEMENTED; } // Gets the number of children. - virtual wxAccStatus GetChildCount(int* WXUNUSED(childId)) + virtual wxAccStatus GetChildCount(int* WXUNUSED(childCount)) { return wxACC_NOT_IMPLEMENTED; } // Gets the specified child (starting from 1). @@ -584,6 +347,12 @@ public: void SetWindow(wxWindow* window) { m_window = window; } +// Operations + + // Each platform's implementation must define this + // static void NotifyEvent(int eventType, wxWindow* window, wxAccObject objectType, + // int objectId); + private: // Data members @@ -592,18 +361,6 @@ private: }; -/* - -NOTES -Possibly have ways to access other accessible objects. -What if they're not explicitly implemented? Should be able to use -the accessible API to retrieve info about them. Probably -should use a quite different client API, to be able to -retrieve info from other apps too. -But try to avoid implementing this unless absolutely necessary. - - */ - // ---------------------------------------------------------------------------- // now include the declaration of the real class // ----------------------------------------------------------------------------