[jawsscripts] Re: Putting application windows in the virtual buffer

  • From: chad.foster@xxxxxxxxxx
  • To: jawsscripts@xxxxxxxxxxxxx
  • Date: Sat, 27 Dec 2008 13:12:37 -0500

Geoff, you can do that, and in fact, I used this same technique for a
banking application recently. I had to use this technique since the
User Buffer clouded the processing logic that ran in the background,
and obscured certain key windows.

Therefore, I had to activate the User Buffer after I ran all of the
code to populate it in its entirety. If you call the
SayFormattedMessage function however, it brings the User Buffer to the
forefront and potentially disrupts the processing in the background.

Thanks,

Chad


On 12/27/08, Geoff Chapman <gch@xxxxxxxxxxxxxxxx> wrote:
> Hi chad.
> ok, right, Thanks for this.
> I never knew about that file either, so that's given me furhter clues!
> excellent!
>
> \But, re userBuffer Functions,
> well, the tricky thing is, that this appears not to be the case in all
> situations!
> i.e. I've got examples here of code of
> userBufferAddText lines, which definitely do have fundtions associated with
> them, and they do execute when user presses enter,
> but they do, not, automatically say, "link," when the user arrows to them in
> the VirtualViewer.
>
> This is what at present is unresolved for me as to why.
> there's gotta be something that triggers it to do that.
> in my situation, it's quite handy that it doesn't do it all the time, for in
> the way I might utilize it, every line will have a function associated with
> it, and to hear the word, "link," at every point, will just slow down the
> user experience of gleaning the text of each line. but I'm still trying to
> suss out the reason behind this.
>
> ----- Original Message -----
> From: <chad.foster@xxxxxxxxxx>
> To: <jawsscripts@xxxxxxxxxxxxx>
> Sent: Sunday, December 28, 2008 2:47 AM
> Subject: [jawsscripts] Re: Putting application windows in the virtual buffer
>
>
>> Geoff, the CTRL+I keystroke is the one you are thinking of, I believe.
>>
>> I usually rely on the BuiltIn.jsd file for documentation, but it too
>> is not comprehensive.
>>
>> When you provide functions to the UserBufferXX functions, JAWS will
>> then render these User Buffer text lines as links in the User Buffer.
>> When clicked on, they fire the functions associated with them.
>>
>>
>> Thanks,
>>
>> Chad
>>
>>
>> On 12/27/08, E.J. Zufelt <everett@xxxxxxxxx> wrote:
>> > Good morning Geoff,
>> >
>> > I don't even think that the FSDN is written in a way to be particularly
>> > useful to developers.  It is certainly better than no documentation at
> all,
>> > but there is not as much information as one might like.
>> >
>> > I suppose the trade off is that FS could pay someone to improve the
>> > documentation, or to improve JAWS.
>> >
>> > I am hoping to do some work on JAWSWiki this week.  But, the success of
> the
>> > resource lies in multiple contributors.  I do not have the time, or the
>> > comprehensive knowledge, to create a thorough resource myself.
>> >
>> > Since the site is a Wiki anyone can contribute.  And, even if an
> individuals
>> > contribution isn't 100% perfect others can come in and make improvements
>> > upon it.
>> >
>> > Thanks,
>> > Everett
>> >
>> >
>> > ----- Original Message -----
>> > From: "Geoff Chapman" <gch@xxxxxxxxxxxxxxxx>
>> > To: <jawsscripts@xxxxxxxxxxxxx>
>> > Sent: Saturday, December 27, 2008 10:42 AM
>> > Subject: [jawsscripts] Putting application windows in the virtual buffer
>> >
>> >
>> >> Hi chad.
>> >> When you indicate below, reading through the documentation for the
>> >> functions, is the fsdn still the best and only real formatted
>> >> documentation
>> >> available for scripting function examination?
>> >> Because, well from the perspective of a greeny scripty newby, I find
>> >> myself
>> >> often not feeling examination of that source, particularly helpful, as
> it
>> >> doesn't seem to be real
>> >> big on comprehensiveness, when it comes to trying to learn the ins and
>> >> outs
>> >> of scripting functions. Does anyone else feel similarly?
>> >> or am I the only one.
>> >> And trying to then supplement/fill in the gaps by seeking to
>> >> reverse-engineer real Live examples, in my view
>> >> can certainly be a hard slog way to learn, when your a newby?
>> >> or am I whining unwarrantedly here. <grin.>
>> >>
>> >> e.g. there's nothing in there, about how to make jaws say, "link," or
> not,
>> >> to indicate to the user that hitting enter will do something, on lines
> of
>> >> userBuffer text when adding those secondary functions of which you
> speak,
>> >> which get activated when enter is pressed.
>> >> Can anyone possibly guide me as to this?
>> >>
>> >> I Guess the new scripting "wiki?" is it called? when it's up, will help
> to
>> >> fill in these gaps, but, well, if I may express a rather "null" point
> of
>> >> view, (to keep my whine all cody sounding, <smile.)
>> >> I personally feel It would've been rather welcome, had the FSDN been
>> >> written
>> >> somewhat more comprehensively I reckon.  It's certainly written more
> from
>> >> the perspective of people who already know quite a huge amount of what
>> >> they're about, (i.e. developers, as it's name certainly suggests,)
>> >> not for those lower down the hierarchy.
>> >>
>> >> lastly, I have investigated all f1 combinations I can think of, and
> simply
>> >> cannot remember that magic keystroke, which my vague memory indicated,
>> >> you could hit from the insert functions dialog, which might've either
>> >> brought up the whole FSDN text right there in script manager to look
> at,
>> >> or
>> >> some other more comprehensive description of a given function, than the
>> >> straight ahead description text in the insert functions dialog? is this
>> >> true? or did I imagine it.
>> >>
>> >> thanks.
>> >>
>> >> Geoff c.
>> >>
>> >> ----- Original Message -----
>> >> From: <chad.foster@xxxxxxxxxx>
>> >> To: <jawsscripts@xxxxxxxxxxxxx>
>> >> Sent: Thursday, December 25, 2008 3:45 AM
>> >> Subject: [jawsscripts] Re: Putting application windows in the virtual
>> >> buffer
>> >>
>> >>
>> >>> You are creating links. Just like hyperlinks on the Internet point
>> >>> somewhere, links in your User Buffer have to point somewhere. In the
>> >>> case of the User Buffer however, they must point to an action for a
>> >>> given program, not to an Internet address.
>> >>>
>> >>> If you are just populating the User Buffer with text and no links,
>> >>> then you do not need to use the function parameters for the functions
>> >>> I outlined.
>> >>>
>> >>> I recommend reading the documentation for these functions and
>> >>> searching through Default.jss for examples.
>> >>>
>> >>> On 12/24/08, Andy Borka <andy@xxxxxxxxxxxxxxxxxxx> wrote:
>> >>> > The program I am looking at is MS Money 2005. Any other
> recommendations
>> >> on
>> >>> > getting the main window into the virtual buffer? I guess I don't
> quite
>> >> get
>> >>> > how you get the contents into the buffer exactly and what do you
> mean
>> >>> > by
>> >> I
>> >>> > have to write the actions for link clicks manually?
>> >>> >
>> >>> > Twitter: www.twitter.com/sonfire
>> >>> >
>> >>> >
>> >>> > -----Original Message-----
>> >>> > From: jawsscripts-bounce@xxxxxxxxxxxxx
>> >>> > [mailto:jawsscripts-bounce@xxxxxxxxxxxxx] On Behalf Of
>> >>> > chad.foster@xxxxxxxxxx
>> >>> > Sent: Wednesday, December 24, 2008 9:55 AM
>> >>> > To: jawsscripts@xxxxxxxxxxxxx
>> >>> > Subject: [jawsscripts] Re: Putting application windows in the
> virtual
>> >> buffer
>> >>> >
>> >>> > See the UserBuffer functions. UserBufferAddText is the one that
> allows
>> >>> > you to specify functions for links in the User Buffer.
>> >>> >
>> >>> > I usually call SayFormattedMessage with the output type of
>> >>> > OT_USER_BUFFER to start the User Buffer, then add text using the
>> >>> > function above. This gives you the desired effect for the say all.
>> >>> >
>> >>> > Optionally, you can add all of the text, then use the
>> >>> > UserBufferActivate function to bring the User Buffer to the
> forefront.
>> >>> > The avenue you choose depends on if the User Buffer clouds the
>> >>> > processing logic (obscures windows etc.) required to build its
>> >>> > contents.
>> >>> >
>> >>> > You need to write the functions to execute when the user clicks
> ENTER
>> >>> > on one of those User Buffer links, which executes the desired
>> >>> > activity.
>> >>> >
>> >>> >
>> >>> > Good luck,
>> >>> >
>> >>> > On 12/24/08, Andy Borka <andy@xxxxxxxxxxxxxxxxxxx> wrote:
>> >>> >> I have an application that uses its main window as an html_server
>> >> class.
>> >>> >> I know for sure that it is html content since it has links and
> stuff
>> >>> >> in
>> >>> >> it. Was just wondering how you put it in the virtual buffer and
> show
>> >>> >> it
>> >>> >> like a web page?
>> >>> >>
>> >>> >>
>> >>> >> __________
>> >>> >> Visit and contribute to The JAWS Script Repository
>> >> http://jawsscripts.com
>> >>> >>
>> >>> >> View the list's information and change your settings at
>> >>> >> //www.freelists.org/list/jawsscripts
>> >>> >>
>> >>> >>
>> >>> >
>> >>> >
>> >>> > --
>> >>> > Chad Foster
>> >>> > Access Technology Solutions
>> >>> > Leveling The Playing Field Through Technology
>> >>> > http://www.GO-ATS.net
>> >>> > __________
>> >>> > Visit and contribute to The JAWS Script Repository
>> >> http://jawsscripts.com
>> >>> >
>> >>> > View the list's information and change your settings at
>> >>> > //www.freelists.org/list/jawsscripts
>> >>> >
>> >>> >
>> >>> > __________
>> >>> > Visit and contribute to The JAWS Script Repository
>> >> http://jawsscripts.com
>> >>> >
>> >>> > View the list's information and change your settings at
>> >>> > //www.freelists.org/list/jawsscripts
>> >>> >
>> >>> >
>> >>>
>> >>>
>> >>> --
>> >>> Chad Foster
>> >>> Access Technology Solutions
>> >>> Leveling The Playing Field Through Technology
>> >>> http://www.GO-ATS.net
>> >>> __________
>> >>> Visit and contribute to The JAWS Script Repository
> http://jawsscripts.com
>> >>>
>> >>> View the list's information and change your settings at
>> >>> //www.freelists.org/list/jawsscripts
>> >>>
>> >>
>> >> __________
>> >> Visit and contribute to The JAWS Script Repository
> http://jawsscripts.com
>> >>
>> >> View the list's information and change your settings at
>> >> //www.freelists.org/list/jawsscripts
>> >
>> > __________
>> > Visit and contribute to The JAWS Script Repository
> http://jawsscripts.com
>> >
>> > View the list's information and change your settings at
>> > //www.freelists.org/list/jawsscripts
>> >
>> >
>>
>>
>> --
>> Chad Foster
>> Access Technology Solutions
>> Leveling The Playing Field Through Technology
>> http://www.GO-ATS.net
>> __________
>> Visit and contribute to The JAWS Script Repository http://jawsscripts.com
>>
>> View the list's information and change your settings at
>> //www.freelists.org/list/jawsscripts
>>
>
> __________
> Visit and contribute to The JAWS Script Repository http://jawsscripts.com
>
> View the list's information and change your settings at
> //www.freelists.org/list/jawsscripts
>
>


-- 
Chad Foster
Access Technology Solutions
Leveling The Playing Field Through Technology
http://www.GO-ATS.net
__________ 
Visit and contribute to The JAWS Script Repository http://jawsscripts.com

View the list's information and change your settings at 
//www.freelists.org/list/jawsscripts

Other related posts: