]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/accessible.tex
First step in background erase optimization
[wxWidgets.git] / docs / latex / wx / accessible.tex
index c0935232f04c4a89a75e865d079ca96556b9dae0..323c90a76fd079b69ab8aed7bf65e86b8914d6f3 100644 (file)
@@ -5,10 +5,10 @@
 
 \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.
@@ -32,7 +32,7 @@ wxAccessible; for example, the sash of a splitter window.
 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}
@@ -48,7 +48,8 @@ symbol is set to 1.
 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
@@ -57,12 +58,14 @@ typedef enum
     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,
@@ -74,12 +77,14 @@ typedef enum
     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,
@@ -144,11 +149,13 @@ typedef enum {
     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,
@@ -163,12 +170,14 @@ typedef enum {
     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,
@@ -178,11 +187,13 @@ typedef enum
     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
@@ -209,12 +220,14 @@ States are represented by the following:
 #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
@@ -257,7 +270,8 @@ as follows:
 #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}}}
 
@@ -291,9 +305,9 @@ this means that the child is a simple element and not an accessible object.
 
 \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}
 
@@ -336,6 +350,7 @@ Return e.g. ALT+K.
 \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}
 
@@ -401,15 +416,17 @@ Returns a status value and object id to indicate whether the given point was on
 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.