\section{\class{wxAccessible}}\label{wxaccessible}
-The wxAccessible class allows wxWindows applications, and
-wxWindows itself, to return extended information about user interface elements
+The wxAccessible class allows wxWidgets applications, and
+wxWidgets itself, to return extended information about user interface elements
to client applications such as screen readers. This is the
-main way in which wxWindows implements accessibility features.
+main way in which wxWidgets implements accessibility features.
At present, only Microsoft Active Accessibility is supported
by this class.
For details on the semantics of functions and types, please refer to the
Microsoft Active Accessibility 1.2 documentation.
-This class is compiled into wxWindows only if the wxUSE\_ACCESSIBILITY setup
+This class is compiled into wxWidgets only if the wxUSE\_ACCESSIBILITY setup
symbol is set to 1.
\wxheading{Derived from}
Functions return a wxAccStatus error code, which
may be one of the following:
-{\small \begin{verbatim}
+{\small
+\begin{verbatim}
typedef enum
{
wxACC\_FAIL, // The function failed
wxACC\_NOT\_IMPLEMENTED, // The function is not implemented
wxACC\_NOT\_SUPPORTED // The function is not supported
} wxAccStatus
-\end{verbatim}}
+\end{verbatim}
+}
Directions of navigation are represented by
the following:
-{\small \begin{verbatim}
+{\small
+\begin{verbatim}
typedef enum
{
wxNAVDIR\_DOWN,
wxNAVDIR\_RIGHT,
wxNAVDIR\_UP
} wxNavDir
-\end{verbatim}}
+\end{verbatim}
+}
The role of a user interface element is represented
by the following type:
-{\small \begin{verbatim}
+{\small
+\begin{verbatim}
typedef enum {
wxROLE\_NONE,
wxROLE\_SYSTEM\_ALERT,
wxROLE\_SYSTEM\_WHITESPACE,
wxROLE\_SYSTEM\_WINDOW
} wxAccRole
-\end{verbatim}}
+\end{verbatim}
+}
Objects are represented by the following type:
-{\small \begin{verbatim}
+{\small
+\begin{verbatim}
typedef enum {
wxOBJID\_WINDOW = 0x00000000,
wxOBJID\_SYSMENU = 0xFFFFFFFF,
wxOBJID\_ALERT = 0xFFFFFFF6,
wxOBJID\_SOUND = 0xFFFFFFF5
} wxAccObject
-\end{verbatim}}
+\end{verbatim}
+}
Selection actions are identified by
this type:
-{\small \begin{verbatim}
+{\small
+\begin{verbatim}
typedef enum
{
wxACC\_SEL\_NONE = 0,
wxACC\_SEL\_ADDSELECTION = 8,
wxACC\_SEL\_REMOVESELECTION = 16
} wxAccSelectionFlags
-\end{verbatim}}
+\end{verbatim}
+}
States are represented by the following:
-{\small \begin{verbatim}
+{\small
+\begin{verbatim}
#define wxACC\_STATE\_SYSTEM\_ALERT\_HIGH 0x00000001
#define wxACC\_STATE\_SYSTEM\_ALERT\_MEDIUM 0x00000002
#define wxACC\_STATE\_SYSTEM\_ALERT\_LOW 0x00000004
#define wxACC\_STATE\_SYSTEM\_SELECTED 0x00800000
#define wxACC\_STATE\_SYSTEM\_SELFVOICING 0x01000000
#define wxACC\_STATE\_SYSTEM\_UNAVAILABLE 0x02000000
-\end{verbatim}}
+\end{verbatim}
+}
Event identifiers that can be sent via \helpref{wxAccessible::NotifyEvent}{wxaccessiblenotifyevent} are
as follows:
-{\small \begin{verbatim}
+{\small
+\begin{verbatim}
#define wxACC\_EVENT\_SYSTEM\_SOUND 0x0001
#define wxACC\_EVENT\_SYSTEM\_ALERT 0x0002
#define wxACC\_EVENT\_SYSTEM\_FOREGROUND 0x0003
#define wxACC\_EVENT\_OBJECT\_HELPCHANGE 0x8010
#define wxACC\_EVENT\_OBJECT\_DEFACTIONCHANGE 0x8011
#define wxACC\_EVENT\_OBJECT\_ACCELERATORCHANGE 0x8012
-\end{verbatim}}
+\end{verbatim}
+}
\latexignore{\rtfignore{\wxheading{Members}}}
\membersection{wxAccessible::GetChildCount}\label{wxaccessiblegetchildcount}
-\func{virtual wxAccStatus}{GetChildCount}{\param{int* }{childId}}
+\func{virtual wxAccStatus}{GetChildCount}{\param{int* }{childCount}}
-Returns the number of children in {\it childId}.
+Returns the number of children in {\it childCount}.
\membersection{wxAccessible::GetDefaultAction}\label{wxaccessiblegetdefaultaction}
\func{virtual wxAccStatus}{GetLocation}{\param{wxRect\& }{rect}, \param{int }{elementId}}
Returns the rectangle for this object (id is 0) or a child element (id is greater than 0).
+{\it rect} is in screen coordinates.
\membersection{wxAccessible::GetName}\label{wxaccessiblegetname}
a child object. Can return either a child object, or an integer
representing the child element, starting from 1.
+{\it pt} is in screen coordinates.
+
\membersection{wxAccessible::Navigate}\label{wxaccessiblenavigate}
\func{virtual wxAccStatus}{Navigate}{\param{wxNavDir }{navDir}, \param{int }{fromId}, \param{int* }{toId}, \param{wxAccessible** }{toObject}}
Navigates from {\it fromId} to {\it toId}/{\it toObject}.
-\membersection{wxAccessible::Notify}\label{wxaccessiblenotify}
+\membersection{wxAccessible::NotifyEvent}\label{wxaccessiblenotifyevent}
-\func{virtual static void}{Notify}{\param{int}{ eventType}, \param{wxWindow* }{window}, \param{wxAccObjectt }{objectType}, \param{int }{objectType}}
+\func{virtual static void}{NotifyEvent}{\param{int}{ eventType}, \param{wxWindow* }{window}, \param{wxAccObjectt }{objectType}, \param{int }{objectType}}
Allows the application to send an event when something changes in an accessible object.