]> git.saurik.com Git - wxWidgets.git/commitdiff
Corrected some wxAccessible mistakes
authorJulian Smart <julian@anthemion.co.uk>
Mon, 19 May 2003 14:00:18 +0000 (14:00 +0000)
committerJulian Smart <julian@anthemion.co.uk>
Mon, 19 May 2003 14:00:18 +0000 (14:00 +0000)
Implemented some SplitterWindowAccessible functions
in sample

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@20664 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

docs/latex/wx/accessible.tex
include/wx/access.h
include/wx/window.h
samples/access/accesstest.cpp
src/msw/ole/access.cpp

index c0935232f04c4a89a75e865d079ca96556b9dae0..faa5c9e9fca2a5f0b073449df9e40cd42cb215f1 100644 (file)
@@ -291,9 +291,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 +336,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,6 +402,8 @@ 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}}
index 1480538eed4ac22d941ca404586594a91db3f378..b78642463e458307f08027f09979faa8d167a9a4 100644 (file)
@@ -237,10 +237,12 @@ public:
 
         // 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; }
 
@@ -254,7 +256,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).
index 6f50ef8f7f2f3b68cb402c8988cfeae637e97265..6b45c4a7b49cecc4f493187ad72e4ea17fc30611 100644 (file)
@@ -1231,7 +1231,7 @@ public:
     virtual wxAccStatus GetName(int childId, wxString* name);
 
         // Gets the number of children.
-    virtual wxAccStatus GetChildCount(int* childId);
+    virtual wxAccStatus GetChildCount(int* childCount);
 
         // Gets the specified child (starting from 1).
         // If *child is NULL and return value is wxACC_OK,
index 285edb016c18b67a8cca4cfe400018ee9f44bb35..c07fa9f9416a66169eed70ea063561a9aab6b087 100644 (file)
@@ -32,6 +32,7 @@
 
 #include "wx/access.h"
 #include "wx/splitter.h"
+#include "wx/cshelp.h"
 
 #ifdef __WXMSW__
 #include "windows.h"
@@ -152,6 +153,13 @@ IMPLEMENT_APP(MyApp)
 // 'Main program' equivalent: the program execution "starts" here
 bool MyApp::OnInit()
 {
+    // Note: JAWS for Windows will only speak the context-sensitive
+    // help if you use this help provider:
+    // wxHelpProvider::Set(new wxHelpControllerHelpProvider(m_helpController)).
+    // JAWS does not seem to be getting the help text from
+    // the wxAccessible object.
+    wxHelpProvider::Set(new wxSimpleHelpProvider());
+
     // create the main application window
     MyFrame *frame = new MyFrame(_T("AccessTest wxWindows App"),
                                  wxPoint(50, 50), wxSize(450, 340));
@@ -174,14 +182,12 @@ public:
             // Gets the name of the specified object.
     virtual wxAccStatus GetName(int childId, wxString* name)
     {
-#if 1
         if (childId == wxACC_SELF)
         {
             * name = wxT("Julian's Frame");
             return wxACC_OK;
         }
         else
-#endif
             return wxACC_NOT_IMPLEMENTED;
     }
 };
@@ -210,52 +216,36 @@ public:
     SplitterWindowAccessible(wxWindow* win): wxWindowAccessible(win) {}
 
             // Gets the name of the specified object.
-    virtual wxAccStatus GetName(int childId, wxString* name)
-    {
-        if (childId == wxACC_SELF)
-        {
-            * name = wxT("Splitter window");
-            return wxACC_OK;
-        }
-        else
-            return wxACC_NOT_IMPLEMENTED;
-    }
+    virtual wxAccStatus GetName(int childId, wxString* name);
 
         // Can return either a child object, or an integer
         // representing the child element, starting from 1.
-    virtual wxAccStatus HitTest(const wxPoint& pt, int* childId, wxAccessible** childObject)
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus HitTest(const wxPoint& pt, int* childId, wxAccessible** childObject);
 
         // Returns the rectangle for this object (id = 0) or a child element (id > 0).
-    virtual wxAccStatus GetLocation(wxRect& WXUNUSED(rect), int WXUNUSED(elementId))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus GetLocation(wxRect& rect, int elementId);
 
         // Navigates from fromId to toId/toObject.
-    virtual wxAccStatus Navigate(wxNavDir WXUNUSED(navDir), int WXUNUSED(fromId),
-                int* WXUNUSED(toId), wxAccessible** WXUNUSED(toObject))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus Navigate(wxNavDir navDir, int fromId,
+                int* toId, wxAccessible** toObject);
 
         // Gets the number of children.
-    virtual wxAccStatus GetChildCount(int* WXUNUSED(childId))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus GetChildCount(int* childCount);
 
         // Gets the specified child (starting from 1).
         // If *child is NULL and return value is wxACC_OK,
         // this means that the child is a simple element and
         // not an accessible object.
-    virtual wxAccStatus GetChild(int WXUNUSED(childId), wxAccessible** WXUNUSED(child))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus GetChild(int childId, wxAccessible** child);
 
         // Gets the parent, or NULL.
-    virtual wxAccStatus GetParent(wxAccessible** WXUNUSED(parent))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus GetParent(wxAccessible** parent);
 
         // Performs the default action. childId is 0 (the action for this object)
         // or > 0 (the action for a child).
         // Return wxACC_NOT_SUPPORTED if there is no default action for this
         // window (e.g. an edit control).
-    virtual wxAccStatus DoDefaultAction(int WXUNUSED(childId))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus DoDefaultAction(int childId);
 
         // Gets the default action for this object (0) or > 0 (the action for a child).
         // Return wxACC_OK even if there is no action. actionName is the action, or the empty
@@ -263,45 +253,36 @@ public:
         // The retrieved string describes the action that is performed on an object,
         // not what the object does as a result. For example, a toolbar button that prints
         // a document has a default action of "Press" rather than "Prints the current document."
-    virtual wxAccStatus GetDefaultAction(int WXUNUSED(childId), wxString* WXUNUSED(actionName))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus GetDefaultAction(int childId, wxString* actionName);
 
         // Returns the description for this object or a child.
-    virtual wxAccStatus GetDescription(int WXUNUSED(childId), wxString* WXUNUSED(description))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus GetDescription(int childId, wxString* description);
 
         // Returns help text for this object or a child, similar to tooltip text.
-    virtual wxAccStatus GetHelpText(int WXUNUSED(childId), wxString* WXUNUSED(helpText))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus GetHelpText(int childId, wxString* helpText);
 
         // Returns the keyboard shortcut for this object or child.
         // Return e.g. ALT+K
-    virtual wxAccStatus GetKeyboardShortcut(int WXUNUSED(childId), wxString* WXUNUSED(shortcut))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus GetKeyboardShortcut(int childId, wxString* shortcut);
 
         // Returns a role constant.
-    virtual wxAccStatus GetRole(int WXUNUSED(childId), wxAccRole* WXUNUSED(role))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus GetRole(int childId, wxAccRole* role);
 
         // Returns a state constant.
-    virtual wxAccStatus GetState(int WXUNUSED(childId), long* WXUNUSED(state))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus GetState(int childId, long* state);
 
         // Returns a localized string representing the value for the object
         // or child.
-    virtual wxAccStatus GetValue(int WXUNUSED(childId), wxString* WXUNUSED(strValue))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus GetValue(int childId, wxString* strValue);
 
         // Selects the object or child.
-    virtual wxAccStatus Select(int WXUNUSED(childId), wxAccSelectionFlags WXUNUSED(selectFlags))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus Select(int childId, wxAccSelectionFlags selectFlags);
 
         // Gets the window with the keyboard focus.
         // If childId is 0 and child is NULL, no object in
         // this subhierarchy has the focus.
         // If this object has the focus, child should be 'this'.
-    virtual wxAccStatus GetFocus(int* WXUNUSED(childId), wxAccessible** WXUNUSED(child))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus GetFocus(int* childId, wxAccessible** child);
 
         // Gets a variant representing the selected children
         // of this object.
@@ -311,8 +292,7 @@ public:
         // - an integer representing the selected child element,
         //   or 0 if this object is selected (GetType() == wxT("long"))
         // - a "void*" pointer to a wxAccessible child object
-    virtual wxAccStatus GetSelections(wxVariant* WXUNUSED(selections))
-         { return wxACC_NOT_IMPLEMENTED; }
+    virtual wxAccStatus GetSelections(wxVariant* selections);
 
 };
 
@@ -326,7 +306,7 @@ MyFrame::MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size,
 {
     m_textCtrl = NULL;
 
-//    SetAccessible(new FrameAccessible(this));
+    SetAccessible(new FrameAccessible(this));
 
     // set the frame icon
     SetIcon(wxICON(mondrian));
@@ -337,7 +317,7 @@ MyFrame::MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size,
 
     // the "About" item should be in the help menu
     wxMenu *helpMenu = new wxMenu;
-    helpMenu->Append(AccessTest_About, _T("&About...\tF1"), _T("Show about dialog"));
+    helpMenu->Append(AccessTest_About, _T("&About..."), _T("Show about dialog"));
 
     menuFile->Append(AccessTest_Query, _T("Query"), _T("Query the window hierarchy"));
     menuFile->AppendSeparator();
@@ -358,29 +338,29 @@ MyFrame::MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size,
     SetStatusText(_T("Welcome to wxWindows!"));
 #endif // wxUSE_STATUSBAR
 
-#if 1
+
     wxSplitterWindow* splitter = new wxSplitterWindow(this, -1);
-    splitter->CreateAccessible();
+    splitter->SetAccessible(new SplitterWindowAccessible(splitter));
 
     wxListBox* listBox = new wxListBox(splitter, -1);
+    listBox->Append(wxT("Cabbages"));
+    listBox->Append(wxT("Kings"));
+    listBox->Append(wxT("Sealing wax"));
+    listBox->Append(wxT("Strings"));
     listBox->CreateAccessible();
+    listBox->SetHelpText(wxT("This is a sample wxWindows listbox, with a number of items in it."));
 
     m_textCtrl = new wxTextCtrl(splitter, -1, wxT(""), wxDefaultPosition,
         wxDefaultSize, wxTE_MULTILINE);
     m_textCtrl->CreateAccessible();
+    m_textCtrl->SetHelpText(wxT("This is a sample wxWindows multiline text control."));
 
     splitter->SplitHorizontally(listBox, m_textCtrl, 150);
-#endif
 
 #if 0
-#if 1
-    wxListBox* listBox = new wxListBox(this, -1);
-    //listBox->SetAccessible(new wxAccessible(listBox));
-#else
     wxScrolledWindow* scrolledWindow = new wxScrolledWindow(this, -1);
     scrolledWindow->SetAccessible(new ScrolledWindowAccessible(scrolledWindow));
 #endif
-#endif
 }
 
 
@@ -596,3 +576,527 @@ void MyFrame::GetInfo(IAccessible* accessible, int id, wxString& name, wxString&
         role = wxT("NO ROLE");
     }    
 }
+
+/*
+ * SplitterWindowAccessible implementation
+ */
+
+// Gets the name of the specified object.
+wxAccStatus SplitterWindowAccessible::GetName(int childId, wxString* name)
+{
+    if (childId == wxACC_SELF)
+    {
+        * name = wxT("Splitter window");
+        return wxACC_OK;
+    }
+    wxSplitterWindow* splitter = wxDynamicCast(GetWindow(), wxSplitterWindow);
+    if (splitter)
+    {
+        if (splitter->IsSplit())
+        {
+            // Two windows, and the sash.
+            if (childId == 1 || childId == 3)
+                return wxACC_NOT_IMPLEMENTED;
+            else if (childId == 2)
+            {
+                *name = wxT("Sash");
+                return wxACC_OK;
+            }
+        }
+    }
+    // Let the framework handle the other cases.
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Can return either a child object, or an integer
+// representing the child element, starting from 1.
+wxAccStatus SplitterWindowAccessible::HitTest(const wxPoint& pt, int* childId, wxAccessible** childObject)
+{
+    wxSplitterWindow* splitter = wxDynamicCast(GetWindow(), wxSplitterWindow);
+    if (splitter)
+    {
+        if (splitter->IsSplit())
+        {
+            wxPoint clientPt = splitter->ScreenToClient(pt);
+            if (splitter->SashHitTest(clientPt.x, clientPt.y, 1))
+            {
+                // We're over the sash
+                *childId = 2;
+                return wxACC_OK;
+            }
+        }
+    }
+    // Let the framework handle the other cases.
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Returns the rectangle for this object (id = 0) or a child element (id > 0).
+wxAccStatus SplitterWindowAccessible::GetLocation(wxRect& rect, int elementId)
+{
+    wxSplitterWindow* splitter = wxDynamicCast(GetWindow(), wxSplitterWindow);
+    if (splitter && elementId == 2 && splitter->IsSplit())
+    {
+        wxSize clientSize = splitter->GetClientSize();
+        if (splitter->GetSplitMode() == wxSPLIT_VERTICAL)
+        {
+            rect.x = splitter->GetSashPosition();
+            rect.y = 0;
+            rect.SetPosition(splitter->ClientToScreen(rect.GetPosition()));
+            rect.width = splitter->GetSashSize();
+            rect.height = clientSize.y;
+        }
+        else
+        {
+            rect.x = 0;
+            rect.y = splitter->GetSashPosition();
+            rect.SetPosition(splitter->ClientToScreen(rect.GetPosition()));
+            rect.width = clientSize.x;
+            rect.height = splitter->GetSashSize();
+        }
+        return wxACC_OK;
+    }
+    // Let the framework handle the other cases.
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Navigates from fromId to toId/toObject.
+wxAccStatus SplitterWindowAccessible::Navigate(wxNavDir navDir, int fromId,
+                int* toId, wxAccessible** toObject)
+{
+    wxSplitterWindow* splitter = wxDynamicCast(GetWindow(), wxSplitterWindow);
+    if (splitter && splitter->IsSplit())
+    {
+        switch (navDir)
+        {
+        case wxNAVDIR_DOWN:
+            {
+                if (splitter->GetSplitMode() == wxSPLIT_VERTICAL)
+                {
+                    // Can't go down spatially if split vertically.
+                    return wxACC_FALSE;           
+                }
+                else
+                {
+                    if (fromId == 1)
+                    {
+                        *toId = 2;
+                        *toObject = NULL;
+                        return wxACC_OK;
+                    }
+                    else if (fromId == 2)
+                    {
+                        *toId = 3;
+                        *toObject = splitter->GetWindow2()->GetAccessible();
+                        return wxACC_OK;
+                    }
+                    else
+                        return wxACC_FALSE;
+                }
+
+                break;
+            }
+        case wxNAVDIR_FIRSTCHILD:
+            {
+                if (fromId == 2)
+                    return wxACC_FALSE;
+            }
+            break;
+            
+        case wxNAVDIR_LASTCHILD:
+            {
+                if (fromId == 2)
+                    return wxACC_FALSE;
+            }
+            break;
+            
+        case wxNAVDIR_LEFT:
+            {
+                if (splitter->GetSplitMode() == wxSPLIT_HORIZONTAL)
+                {
+                    // Can't go left spatially if split horizontally.
+                    return wxACC_FALSE;           
+                }
+                else
+                {
+                    if (fromId == 3)
+                    {
+                        *toId = 2;
+                        *toObject = NULL;
+                        return wxACC_OK;
+                    }
+                    else if (fromId == 2)
+                    {
+                        *toId = 1;
+                        *toObject = splitter->GetWindow1()->GetAccessible();
+                        return wxACC_OK;
+                    }
+                    else
+                        return wxACC_FALSE;
+                }
+            }
+            break;
+            
+        case wxNAVDIR_NEXT:
+            {
+                if (fromId == 1)
+                {
+                    *toId = 2;
+                    *toObject = NULL;
+                    return wxACC_OK;
+                }
+                else if (fromId == 2)
+                {
+                    *toId = 3;
+                    *toObject = splitter->GetWindow2()->GetAccessible();
+                    return wxACC_OK;
+                }
+                else
+                    return wxACC_FALSE;
+            }
+            break;
+            
+        case wxNAVDIR_PREVIOUS:
+            {
+                if (fromId == 3)
+                {
+                    *toId = 2;
+                    *toObject = NULL;
+                    return wxACC_OK;
+                }
+                else if (fromId == 2)
+                {
+                    *toId = 1;
+                    *toObject = splitter->GetWindow1()->GetAccessible();
+                    return wxACC_OK;
+                }
+                else
+                    return wxACC_FALSE;
+            }
+            break;
+            
+        case wxNAVDIR_RIGHT:
+            {
+                if (splitter->GetSplitMode() == wxSPLIT_HORIZONTAL)
+                {
+                    // Can't go right spatially if split horizontally.
+                    return wxACC_FALSE;           
+                }
+                else
+                {
+                    if (fromId == 1)
+                    {
+                        *toId = 2;
+                        *toObject = NULL;
+                        return wxACC_OK;
+                    }
+                    else if (fromId == 2)
+                    {
+                        *toId = 3;
+                        *toObject = splitter->GetWindow2()->GetAccessible();
+                        return wxACC_OK;
+                    }
+                    else
+                        return wxACC_FALSE;
+                }
+            }
+            break;
+            
+        case wxNAVDIR_UP:
+            {
+                if (splitter->GetSplitMode() == wxSPLIT_VERTICAL)
+                {
+                    // Can't go up spatially if split vertically.
+                    return wxACC_FALSE;           
+                }
+                else
+                {
+                    if (fromId == 3)
+                    {
+                        *toId = 2;
+                        return wxACC_OK;
+                    }
+                    else if (fromId == 2)
+                    {
+                        *toId = 1;
+                        *toObject = splitter->GetWindow1()->GetAccessible();
+                        return wxACC_OK;
+                    }
+                    else
+                        return wxACC_FALSE;
+                }
+
+                break;
+            }
+        }
+        
+    }
+    // Let the framework handle the other cases.
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Gets the number of children.
+wxAccStatus SplitterWindowAccessible::GetChildCount(int* childCount)
+{
+    wxSplitterWindow* splitter = wxDynamicCast(GetWindow(), wxSplitterWindow);
+    if (splitter)
+    {
+        if (splitter->IsSplit())
+        {
+            // Two windows, and the sash.
+            *childCount = 3;
+            return wxACC_OK;
+        }
+        else
+        {
+            // No sash -- 1 or 0 windows.
+            if (splitter->GetWindow1() || splitter->GetWindow2())
+            {
+                *childCount = 1;
+                return wxACC_OK;
+            }
+            else
+            {
+                *childCount = 0;
+                return wxACC_OK;
+            }
+        }
+    }
+    // Let the framework handle the other cases.
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Gets the specified child (starting from 1).
+// If *child is NULL and return value is wxACC_OK,
+// this means that the child is a simple element and
+// not an accessible object.
+wxAccStatus SplitterWindowAccessible::GetChild(int childId, wxAccessible** child)
+{
+    if (childId == wxACC_SELF)
+    {
+        *child = this;
+        return wxACC_OK;
+    }
+
+    wxSplitterWindow* splitter = wxDynamicCast(GetWindow(), wxSplitterWindow);
+    if (splitter)
+    {
+        if (splitter->IsSplit())
+        {
+            // Two windows, and the sash.
+            if (childId == 1)
+            {
+                *child = splitter->GetWindow1()->GetAccessible();
+            }
+            else if (childId == 2)
+            {
+                *child = NULL; // Sash
+            }
+            else if (childId == 3)
+            {
+                *child = splitter->GetWindow2()->GetAccessible();
+            }
+            else
+            {
+                return wxACC_FAIL;
+            }
+            return wxACC_OK;
+        }
+        else
+        {
+            // No sash -- 1 or 0 windows.
+            if (childId == 1)
+            {
+                if (splitter->GetWindow1())
+                {
+                    *child = splitter->GetWindow1()->GetAccessible();
+                    return wxACC_OK;
+                }
+                else if (splitter->GetWindow2())
+                {
+                    *child = splitter->GetWindow2()->GetAccessible();
+                    return wxACC_OK;
+                }
+                else
+                {
+                    return wxACC_FAIL;
+                }
+            }
+            else
+                return wxACC_FAIL;
+        }
+    }
+    // Let the framework handle the other cases.
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Gets the parent, or NULL.
+wxAccStatus SplitterWindowAccessible::GetParent(wxAccessible** parent)
+{
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Performs the default action. childId is 0 (the action for this object)
+// or > 0 (the action for a child).
+// Return wxACC_NOT_SUPPORTED if there is no default action for this
+// window (e.g. an edit control).
+wxAccStatus SplitterWindowAccessible::DoDefaultAction(int childId)
+{
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Gets the default action for this object (0) or > 0 (the action for a child).
+// Return wxACC_OK even if there is no action. actionName is the action, or the empty
+// string if there is no action.
+// The retrieved string describes the action that is performed on an object,
+// not what the object does as a result. For example, a toolbar button that prints
+// a document has a default action of "Press" rather than "Prints the current document."
+wxAccStatus SplitterWindowAccessible::GetDefaultAction(int childId, wxString* actionName)
+{
+    wxSplitterWindow* splitter = wxDynamicCast(GetWindow(), wxSplitterWindow);
+    if (splitter && splitter->IsSplit() && childId == 2)
+    {
+        // No default action for the splitter.
+        return wxACC_FALSE;
+    }
+    // Let the framework handle the other cases.
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Returns the description for this object or a child.
+wxAccStatus SplitterWindowAccessible::GetDescription(int childId, wxString* description)
+{
+    wxSplitterWindow* splitter = wxDynamicCast(GetWindow(), wxSplitterWindow);
+    if (splitter)
+    {
+        if (splitter->IsSplit())
+        {
+            if (childId == 2)
+            {
+                * description = _("The splitter window sash.");
+                return wxACC_OK;
+            }
+        }
+    }
+    // Let the framework handle the other cases.
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Returns help text for this object or a child, similar to tooltip text.
+wxAccStatus SplitterWindowAccessible::GetHelpText(int childId, wxString* helpText)
+{
+    wxSplitterWindow* splitter = wxDynamicCast(GetWindow(), wxSplitterWindow);
+    if (splitter)
+    {
+        if (splitter->IsSplit())
+        {
+            if (childId == 2)
+            {
+                * helpText = _("The splitter window sash.");
+                return wxACC_OK;
+            }
+        }
+    }
+    // Let the framework handle the other cases.
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Returns the keyboard shortcut for this object or child.
+// Return e.g. ALT+K
+wxAccStatus SplitterWindowAccessible::GetKeyboardShortcut(int childId, wxString* shortcut)
+{
+    wxSplitterWindow* splitter = wxDynamicCast(GetWindow(), wxSplitterWindow);
+    if (splitter && splitter->IsSplit() && childId == 2)
+    {
+        // No keyboard shortcut for the splitter.
+        return wxACC_FALSE;
+    }
+    // Let the framework handle the other cases.
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Returns a role constant.
+wxAccStatus SplitterWindowAccessible::GetRole(int childId, wxAccRole* role)
+{
+    wxSplitterWindow* splitter = wxDynamicCast(GetWindow(), wxSplitterWindow);
+    if (splitter)
+    {
+        if (splitter->IsSplit())
+        {
+            if (childId == 2)
+            {
+                * role = wxROLE_SYSTEM_GRIP;
+                return wxACC_OK;
+            }
+        }
+    }
+    // Let the framework handle the other cases.
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Returns a state constant.
+wxAccStatus SplitterWindowAccessible::GetState(int childId, long* state)
+{
+    wxSplitterWindow* splitter = wxDynamicCast(GetWindow(), wxSplitterWindow);
+    if (splitter && splitter->IsSplit() && childId == 2)
+    {
+        // No particular state. Not sure what would be appropriate here.
+        *state = wxACC_STATE_SYSTEM_UNAVAILABLE;
+        return wxACC_OK;
+    }
+    // Let the framework handle the other cases.
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Returns a localized string representing the value for the object
+// or child.
+wxAccStatus SplitterWindowAccessible::GetValue(int childId, wxString* strValue)
+{
+    wxSplitterWindow* splitter = wxDynamicCast(GetWindow(), wxSplitterWindow);
+    if (splitter && splitter->IsSplit() && childId == 2)
+    {
+        // The sash position is the value.
+        wxString pos;
+        pos << splitter->GetSashPosition();
+        *strValue = pos;
+
+        return wxACC_OK;
+    }
+    // Let the framework handle the other cases.
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Selects the object or child.
+wxAccStatus SplitterWindowAccessible::Select(int childId, wxAccSelectionFlags selectFlags)
+{
+    wxSplitterWindow* splitter = wxDynamicCast(GetWindow(), wxSplitterWindow);
+    if (splitter && splitter->IsSplit() && childId == 2)
+    {
+        // Can't select the sash.
+        return wxACC_FALSE;
+    }
+    // Let the framework handle the other cases.
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Gets the window with the keyboard focus.
+// If childId is 0 and child is NULL, no object in
+// this subhierarchy has the focus.
+// If this object has the focus, child should be 'this'.
+wxAccStatus SplitterWindowAccessible::GetFocus(int* childId, wxAccessible** child)
+{
+    return wxACC_NOT_IMPLEMENTED;
+}
+
+// Gets a variant representing the selected children
+// of this object.
+// Acceptable values:
+// - a null variant (IsNull() returns TRUE)
+// - a list variant (GetType() == wxT("list"))
+// - an integer representing the selected child element,
+//   or 0 if this object is selected (GetType() == wxT("long"))
+// - a "void*" pointer to a wxAccessible child object
+wxAccStatus SplitterWindowAccessible::GetSelections(wxVariant* selections)
+{
+    return wxACC_NOT_IMPLEMENTED;
+}
+
index 23e633be8e15d7b64e62fc52d9e939c9af921579..ce0088ba9c52563e1d4f46c2c906d68ef25fa981 100644 (file)
@@ -1081,7 +1081,7 @@ STDMETHODIMP wxIAccessible::get_accKeyboardShortcut ( VARIANT varID, BSTR* pszKe
     }
     
     wxString keyboardShortcut;
-    wxAccStatus status = m_pAccessible->GetHelpText(varID.lVal, & keyboardShortcut);
+    wxAccStatus status = m_pAccessible->GetKeyboardShortcut(varID.lVal, & keyboardShortcut);
     if (status == wxACC_FAIL)
         return E_FAIL;