[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-accessibility
Subject:    Re: [Kde-accessibility] Re: [Issue N25746] Qt Accessibility
From:       Gunnar Schmi Dt <gunnar () schmi-dt ! de>
Date:       2003-07-09 18:36:33
[Download RAW message or body]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hello,

On Tuesday 08 July 2003 18:16, Volker Hilsheimer wrote:
> Ok, this was a very useful read and will definitely help us extending the
> QAccessibility interfaces.
>
That is good to hear. Maybe I will do an additional comparison of the events,
states and roles of ATK/AT-SPI and the Qt Accessibility Architecture.
However, that will have to wait as I will be busy with other things for the
next two weeks.

> It seems however that you missed the purpose of
> QAccessibleInterface::text() - it can return a string representing Name,
> Description, Value, Help, Accelerator and DefaultAction for the object.
> This should turn a couple of "No"s into "Yes"s :)
>
>     http://doc.trolltech.com/3.1/qaccessibleinterface.html#text
>
Thank you for the hint. It actually turned one "No" and one "Emulatabe" into
"Yes"s (name and description of widgets), two "No"s into "Partially"s (name
and shortcut for the default action) and one "No" into "Emulatable" (the
value of a QWidget).

Gunnar Schmi Dt

P.S.
Olaf, I have attached a diff for the web page. Can you please commit it?

- -- 
Co-maintainer of the KDE Accessibility Project
Maintainer of the kdeaccessibility package
http://accessibility.kde.org/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.7 (GNU/Linux)

iD8DBQE/DGC2sxZ93p+gHn4RAnjHAKDn50iaYHOSIAnGwYAGJ17BJ+wYVQCePwsV
mOwCbXfO9MKNo4pCJHxZsVE=
=inJa
-----END PGP SIGNATURE-----

["diff" (text/x-diff)]

Index: comparision.php
===================================================================
RCS file: /home/kde/www/areas/accessibility/developer/comparision.php,v
retrieving revision 1.5
diff -u -p -r1.5 comparision.php
--- comparision.php	3 Jul 2003 15:46:06 -0000	1.5
+++ comparision.php	9 Jul 2003 18:24:04 -0000
@@ -24,11 +24,10 @@
  but are not available in the current QAccessibleInterface class. These
  features include:
 </p><ul>
- <li>Methods for enquiring the name and a description for each element.</li>
  <li>Methods for enquiring the relationship between several elements.</li>
  <li>Support for several actions, each connected with a name, a
      description, and a key binding. QAccessibleInterface does only
-     allow one default action without name, description or key binding.</li>
+     allow one default action.</li>
  <li>Methods for enquiring the layer or the z-order of a GUI element.</li>
  <li>A method for selecting all children of an element.</li>
  <li>Methods for enquiring the position the size and a description for images.</li>
@@ -83,8 +82,8 @@
 <h3>The Class Accessible/AtkObject</h3>
 <table border="1" summary="This table lists for every function of Accessible and \
AtkObject whether there is a Qt counterpart.">  <tr><th>Method</th><th>Defined \
                in</th><th>Available</th></tr>
-<tr><td>get_name();</td>                                 <td>AT-SPI and \
                ATK</td><td>emulatable</td></tr>
-<tr><td>get_description();</td>                          <td>AT-SPI and \
ATK</td><td>no</td></tr> +<tr><td>get_name();</td>                                 \
<td>AT-SPI and ATK</td><td>yes</td></tr> +<tr><td>get_description();</td>             \
<td>AT-SPI and ATK</td><td>yes</td></tr>  <tr><td>get_parent();</td>                  \
<td>AT-SPI and ATK</td><td>yes</td></tr>  <tr><td>get_n_accessible_children();</td>   \
<td>AT-SPI and ATK</td><td>yes</td></tr>  <tr><td>ref_accessible_child (index);</td>  \
<td>AT-SPI and ATK</td><td>yes</td></tr> @@ -106,8 +105,7 @@
 <tr><td>remove_relationship (relationship, *target);</td><td>ATK</td><td></td></tr>
 </table>
 <p>
- The name can be emulated for QAccessibleObject instances by asking for the name
- of the corresponding QWidget. The method <code>get_index_in_parent()</code> can be \
emulated + The method <code>get_index_in_parent()</code> can be emulated
  by a loop over the children of the parent widget.
 </p>
 
@@ -117,8 +115,8 @@
 <tr><td>boolean do_action (index);</td>           <td>AT-SPI and \
ATK</td><td>partially</td></tr>  <tr><td>get_n_actions()</td>                      \
<td>AT-SPI and ATK</td><td>no</td></tr>  <tr><td>get_description (index);</td>        \
                <td>AT-SPI and ATK</td><td>no</td></tr>
-<tr><td>get_name (index);</td>                    <td>AT-SPI and \
                ATK</td><td>no</td></tr>
-<tr><td>get_key_binding (index);</td>             <td>AT-SPI and \
ATK</td><td>no</td></tr> +<tr><td>get_name (index);</td>                    \
<td>AT-SPI and ATK</td><td>partially</td></tr> +<tr><td>get_key_binding (index);</td> \
<td>AT-SPI and ATK</td><td>partially</td></tr>  <tr><td>get_localized_name \
(index);</td>          <td>ATK</td><td></td></tr>  <tr><td>set_description (index, \
description);</td><td>ATK</td><td></td></tr>  </table>
@@ -315,12 +313,19 @@
 <h3>The Interface Value / AtkValue</h3>
 <table border="1" summary="This table lists for every function of Value and AtkValue \
whether there is a Qt counterpart.">  <tr><th>Method</th><th>Defined \
                in</th><th>Available</th></tr>
-<tr><td>get_current_value (*value);</td><td>AT-SPI and ATK</td><td>no</td></tr>
+<tr><td>get_current_value (*value);</td><td>AT-SPI and \
ATK</td><td>emulatable</td></tr>  <tr><td>get_maximum_value (*value);</td><td>AT-SPI \
and ATK</td><td>no</td></tr>  <tr><td>get_minimum_value (*value);</td><td>AT-SPI and \
ATK</td><td>no</td></tr>  <tr><td>set_current_value (value);</td> <td>AT-SPI and \
ATK</td><td>no</td></tr>  <tr><td>get_minimum_increment \
(*value);</td><td>AT-SPI</td><td>no</td></tr>  </table>
+<p>
+ Please note that QAccessibleInterface has a method that can be used for
+ enquiring the value of any element. However, that method always returns
+ a QString, i.e., numers for example are converted to text. As the Value
+ interface needs to return numbers we would need to convert the QString
+ back to its original type.
+</p>
 
 <?php
   include_once ("footer.inc");



_______________________________________________
kde-accessibility mailing list
kde-accessibility@mail.kde.org
http://mail.kde.org/mailman/listinfo/kde-accessibility


[prev in list] [next in list] [prev in thread] [next in thread] 

Configure | About | News | Add a list | Sponsored by KoreLogic