Re: Guidance on using ATK

Joanmarie Diggs <[email protected]> Thu, 08 Apr 2021 12:21:05 +0200
Newsgroups	gmane.comp.gnome.accessibility.general
Message-ID	<[email protected]>
--===============3682299794631510435==
Content-Type: multipart/alternative; boundary="=-tjTXF8YHzyetIE4oM9qS"


--=-tjTXF8YHzyetIE4oM9qS
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: 8bit

Hi Lawrence.

Please
read https://mail.gnome.org/archives/orca-list/2021-April/msg00041.html
 for my thoughts on how to solve the "make Orca speak whatever I want"
problem properly (new notification API in ATK/AT-SPI2), and also a
possible workaround (role notification + state showing).

That said, if you have an on-screen table -- and the user knows that
table is there -- Orca has "flat review" keystrokes to examine objects
spatially: https://help.gnome.org/users/orca/stable/commands_flat_review.html

And that said: is keyboard navigation for this table such a bad thing?
:) How will it hurt the sighted user's experience? If it would hurt the
sighted user's experience, could full keyboard navigation be an
optional setting?

--joanie

On Tue, 2021-04-06 at 21:13 +0100, Lawrence Warren via gnome-
accessibility-list wrote:
> Hello all,
> 
> I have been developing a program over the past couple of months which
> I intend to be used with a screenreader, if the user requires it.
> However I have become a little stuck in implementing the ATK API in
> my program and require some guidance, and this seems the correct
> place to seek some (but please correct me if I'm wrong!)
> 
> My program is an emulated ARM computer system. Specifically, it
> allows for the loading of ARM assembly source files, the running of
> these files, and the control and viewing of the internal state of the
> system (it's register values, it's memory values, whether to commence
> or pause execution, etc.) via a GUI.
> 
> I have managed to implement ATK very easily with many of the GUI
> components as they are focusable.
> 
> However the internal register values of the emulated system are
> displayed in a table that is not focusable - as a sighted user, you
> can simply look at the table to find out the information you need,
> with no requirement to be able to move program focus to the table
> elements.
> 
> My intention for ATK compatibility was for the information from the
> table to be read by the screenreader upon a key press - Alt+0 for
> register 0, Alt+1 for register 1, and so on.
> 
> However, I cannot find a way to implement this. I have the keyboard
> recognition and the information to be read implemented within my
> program, but I cannot find an easy way to just "send" some string of
> text to the screen reader upon a key press without causing some
> change in GUI focus.
> 
> Do you have a solution or advice on how this can be implemented? I am
> specifically using GTKMM and ATKMM for the GUI and screenreader
> support.
> 
> Thankyou for any help (and sorry if this is the wrong place to seek
> it, I couldn't find any other solutions)
> 
> Regards,
> Lawrence Warren
> _______________________________________________
> gnome-accessibility-list mailing list
> [email protected]
> https://mail.gnome.org/mailman/listinfo/gnome-accessibility-list


--=-tjTXF8YHzyetIE4oM9qS
Content-Type: text/html; charset="utf-8"
Content-Transfer-Encoding: quoted-printable

<html><head></head><body><div>Hi Lawrence.</div><div><br></div><div>Please =
read&nbsp;<a href=3D"https://mail.gnome.org/archives/orca-list/2021-April/m=
sg00041.html">https://mail.gnome.org/archives/orca-list/2021-April/msg00041=
.html</a>&nbsp;for my thoughts on how to solve the "make Orca speak whateve=
r I want" problem properly (new notification API in ATK/AT-SPI2), and also =
a possible workaround (role notification + state showing).</div><div><br></=
div><div>That said, if you have an on-screen table -- and the user knows th=
at table is there -- Orca has "flat review" keystrokes to examine objects s=
patially:&nbsp;<a href=3D"https://help.gnome.org/users/orca/stable/commands=
_flat_review.html">https://help.gnome.org/users/orca/stable/commands_flat_r=
eview.html</a></div><div><br></div><div>And that said: is keyboard navigati=
on for this table such a bad thing? :) How will it hurt the sighted user's =
experience? If it would hurt the sighted user's experience, could full keyb=
oard navigation be an optional setting?</div><div><br></div><div>--joanie</=
div><div><br></div><div>On Tue, 2021-04-06 at 21:13 +0100, Lawrence Warren =
via gnome-accessibility-list wrote:</div><blockquote type=3D"cite" style=3D=
"margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex"><div di=
r=3D"ltr"><div class=3D"gmail_default" style=3D"font-family:arial,helvetica=
,sans-serif">Hello all,</div><div class=3D"gmail_default" style=3D"font-fam=
ily:arial,helvetica,sans-serif"><br></div><div class=3D"gmail_default" styl=
e=3D"font-family:arial,helvetica,sans-serif">I have been developing a progr=
am over the past couple of months which I intend to be used with a screenre=
ader, if the user requires it. However I have become a little stuck in impl=
ementing the ATK API in my program and require some guidance, and this seem=
s the correct place to seek some (but please correct me if I'm wrong!)</div=
><div class=3D"gmail_default" style=3D"font-family:arial,helvetica,sans-ser=
if"><br></div><div class=3D"gmail_default" style=3D"font-family:arial,helve=
tica,sans-serif">My program is an emulated ARM computer system. Specificall=
y, it allows for the loading of ARM assembly source files, the running of t=
hese files, and the control and viewing of the internal state of the system=
 (it's register values, it's memory values, whether to commence or pause ex=
ecution, etc.) via a GUI.</div><div class=3D"gmail_default" style=3D"font-f=
amily:arial,helvetica,sans-serif"><br></div><div class=3D"gmail_default" st=
yle=3D"font-family:arial,helvetica,sans-serif">I have managed to implement =
ATK very easily with many of the GUI components as they are focusable.</div=
><div class=3D"gmail_default" style=3D"font-family:arial,helvetica,sans-ser=
if"><br></div><div class=3D"gmail_default" style=3D"font-family:arial,helve=
tica,sans-serif">However the internal register values of the emulated syste=
m are displayed in a table that is not focusable - as a sighted user, you c=
an simply look at the table to find out the information you need, with no r=
equirement to be able to move program focus to the table elements.</div><di=
v class=3D"gmail_default" style=3D"font-family:arial,helvetica,sans-serif">=
<br></div><div class=3D"gmail_default" style=3D"font-family:arial,helvetica=
,sans-serif">My intention for ATK compatibility was for the information fro=
m the table to be read by the screenreader upon a key press - Alt+0 for reg=
ister 0, Alt+1 for register 1, and so on.</div><div class=3D"gmail_default"=
 style=3D"font-family:arial,helvetica,sans-serif"><br></div><div class=3D"g=
mail_default" style=3D"font-family:arial,helvetica,sans-serif">However, I c=
annot find a way to implement this. I have the keyboard recognition and the=
 information to be read implemented within my program, but I cannot find an=
 easy way to just "send" some string of text to the screen reader upon a ke=
y press without causing some change in GUI focus.</div><div class=3D"gmail_=
default" style=3D"font-family:arial,helvetica,sans-serif"><br></div><div cl=
ass=3D"gmail_default" style=3D"font-family:arial,helvetica,sans-serif">Do y=
ou have a solution or advice on how this can be implemented? I am specifica=
lly using GTKMM and ATKMM for the GUI and screenreader support.</div><div c=
lass=3D"gmail_default" style=3D"font-family:arial,helvetica,sans-serif"><br=
></div><div class=3D"gmail_default" style=3D"font-family:arial,helvetica,sa=
ns-serif">Thankyou for any help (and sorry if this is the wrong place to se=
ek it, I couldn't find any other solutions)</div><div class=3D"gmail_defaul=
t" style=3D"font-family:arial,helvetica,sans-serif"><br></div><div class=3D=
"gmail_default" style=3D"font-family:arial,helvetica,sans-serif">Regards,</=
div><div class=3D"gmail_default" style=3D"font-family:arial,helvetica,sans-=
serif">Lawrence Warren</div></div><div>____________________________________=
___________<br></div><div>gnome-accessibility-list mailing list<br></div><d=
iv><a href=3D"mailto:[email protected]">gnome-accessibilit=
[email protected]</a><br></div><div><a href=3D"https://mail.gnome.org/mailma=
n/listinfo/gnome-accessibility-list">https://mail.gnome.org/mailman/listinf=
o/gnome-accessibility-list</a><br></div></blockquote><div><br></div><div><s=
pan></span></div></body></html>

--=-tjTXF8YHzyetIE4oM9qS--


--===============3682299794631510435==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

_______________________________________________
gnome-accessibility-list mailing list
[email protected]
https://mail.gnome.org/mailman/listinfo/gnome-accessibility-list

--===============3682299794631510435==--