Hi,
honestly speaking, I did not understand your question.
2020. 09. 25. 2:55 keltezéssel, dingram269@xxxxxxxxxxxxx írta:
Hi, how are you? have you considered making corrections in terms of the jaws__________�
scripting documentation?
-----Original Message-----
From: Csaba Árpádházy-Godo <arpadhazi68.jawsul@xxxxxxxxx>__________�
Sent: Sep 24, 2020 2:23 PM
To: jawsscripts@xxxxxxxxxxxxx
Subject: [jawsscripts] Re: Question about the FSDN possible improvements!!!
Hi Udo,
of course you can ask. That is why this list is. :-)
I can understand that you hate to create functions / scripts with the
"Insert new script" dialog. Whoever created the JAWS script editor's
dialogs had no faint idea of what the terms “user-friendly” and
“ergonomic” mean.
I think, most of scripters create their functions smoothly, simply by
typing them into the editor. In this case, the script editor -
unfortunately - is not "informed that a new script / function has been
created. So it is not included in the documentation file.
In this case, if we press Alt+F than D (File menu > Synchronize
documentation command) than the script editor usually updates the JSD
file. However, in the vast majority of cases, does it incorrectly.
Usually forgets to add the parameters of the functions.
For this reason, I always edit the JSD file manually. And most of the
time in the script editor. There are a few tricks to look out for:
1. Opening JSS Script Manager loads a copy of JSD into the memory.JSD
When you open a script file (JSS), the script editor loads the contents
of the JSD file into the memory. If you edit a JSD file with the
corresponding JSS file being opened, make sure that the script editor
does not update the information loaded into memory when saving the JSD
file. Therefore, if you save the JSS file, some of your changes to the
JSD file will be lost. Therefore, while I am editing the JSD file, I
will never modify the JSS, or if I finish modifying the JSD, I will
close both files and only then start modifying the JSS again if I reopen it.
2. Use Control+D (Edit script dialog) to spare work.
As I mentioned I write my scripts/functions per hand, too. When I wrote
the framework for the new function (the declaration and closing lines -
"xxx function xx (params) / EndFunction") than I always save my work by
pressing Control + W (Save without compiling). It ensures, that the
Script manager uptates the in memory copy of JSD file when saves my new
function framework.
3. When I finis a script file, I always take time to document my scripts
& functions. It means I fill the ":Synopsis, :Description & :Category"
fields in the JSD file. To do it I use the Control+D (Edit script
dialog). Only in the case if my function has optional parameter do it by
hand.
This is because you cannot enter optional parameters via this dialog.
Thus, if you edit a function that has such a parameter, the optionality
is lost.
4. Descriptions of parameters
I do it always by hand in the JSD file.
By the way, the Control + e (Add new script) / Control + D (Edit script)
dialogs has some errors in their functioonality. For example: you can't
make a parameter optional, if you edit a function that has already a
short description, the dialog does not shows it. The same with the
category, and the return walue. You can't edit existing parameters, etc.)
HTH
Chaba
2020. 09. 24. 16:37 keltezéssel, Udo Egner-Walter írta:
Hi Csaba and list members,__________�
I would like to ask another question off topic if I may.
To make entries in the JSD file yourself, you can press Ctrl+D in a
script/function and fill in the necessary fields. However, I find it quite
complicated to change or create functions using this.
Personally, I prefer to create the functions "by hand" and would therefore
have the question: is it possible to open the JSD file with an editor and
make the entries myself? Is there anything special to consider here? How
do you do that, e.g. to store a description for a parameter?
Up to now I have always edited the JSD file with an editor for scripts, but
I haven't dared to use the functions yet. Does anyone have any suggestions,
instructions or general ideas?
Thanks for suggestions
Udo
Am 24.09.2020 um 11:35 schrieb Csaba Árpádházy-Godo
<arpadhazi68.jawsul@xxxxxxxxx>:
Theodore,
Bob is right. But instead of JSS you have to add the JSD file to your
script whre you would like to use UIA functions. So the correct line you
have to insert is:
Import “uia.jsd”
Studying the code in the UIA.jss file you can get many examples how to
use UIA.
HTH
Chaba
2020. 09. 23. 12:16 keltezéssel, Bob írta:
Add the line:__________�
Import “uia.jss” to your jss file.
Save, close and reopen script manager.
Then take a look at the functions that appear in the insert function
dialog that start fsuia.
You can also look in uia.jss at what they are doing.
Bob
On 23 Sep 2020, at 10:28, Theodore Cooke <theodorecooke@xxxxxxxxx> wrote:
Csaba, are there any shared scripts you think are a great starting
point? I have learned how to write scripts that interact with
Microsoft UI Automation, but I still haven't learned how to use the
vast majority of the functions in the insert functions dialog. They
mostly seem to use MSAA, but I just can't get the feel for MSAA.
On 9/12/20, Csaba Árpádházy-Godo <arpadhazi68.jawsul@xxxxxxxxx> wrote:__________�
Reed,
These script are in the shared scripts folder of the JAWS. You can find
them in version 2020:
C:\ProgramData\Freedom Scientific\JAWS\2020\Scripts
HTH
Chaba
2020. 09. 11. 17:48 keltezéssel, Reed írta:
Hi Chaba,__________�
Where might one find these "JAWS shared scripts"?
Thanks!
Reed
-----Original Message-----
From: jawsscripts-bounce@xxxxxxxxxxxxx
<jawsscripts-bounce@xxxxxxxxxxxxx>
On Behalf Of Csaba Árpádházy-Godo
Sent: September 11, 2020 5:28 AM
To: jawsscripts@xxxxxxxxxxxxx
Subject: [jawsscripts] Re: Question about the FSDN possible
improvements!!!
Hi Shan,
If you need code samples, than you have to study JAWS shared scripts.
They are inexhaustible collections of examples!
By the way, you can contact Vispero and could buy some overpriced
script
writing training materials. But they contain "common script writing
guidelines" only.
On the other hand, the new FSDN much better than the previous ones! You
have to download it and look!
Chaba
2020. 09. 10. 19:58 keltezéssel, Shan Noyes írta:
Hi folks__________�
A few years back I purchased an excellent Jaws course from Jackie
Mcbride. Anyways, in the course she mentions and as I have discovered
that the FSDN is a pretty good resource, however, it does have some
short
comings. I agree with that statement coming from IBM Screen Reader
days
and writing profiles because the programming supporting manuals
actually
provided examples of code for each IBM screen reading function etc.
Note
the FSDN does not due that at all.
So I'm writing and asking if anyone is familiar with any such
improvements to the FSDN like manual from Freedom.
Thanks all and have a good day.
Shan Noyes
Technical Analyst - Systems Security
GIAC
W: 306 777-4830
C: 306 533-1440
NOTICE: This confidential e-mail message is only for the intended
recipients. If you are not the intended recipient, be advised that
disclosing, copying, distributing, or any other use of this message,
is
strictly prohibited. In such case, please destroy this message and
notify
the sender.
__________�
View the list's information and change your settings at
//www.freelists.org/list/jawsscripts
View the list's information and change your settings at
//www.freelists.org/list/jawsscripts
__________�
View the list's information and change your settings at
//www.freelists.org/list/jawsscripts
View the list's information and change your settings at
//www.freelists.org/list/jawsscripts
View the list's information and change your settings at
//www.freelists.org/list/jawsscripts
__________�
View the list's information and change your settings at
//www.freelists.org/list/jawsscripts
View the list's information and change your settings at
//www.freelists.org/list/jawsscripts
__________�
View the list's information and change your settings at
//www.freelists.org/list/jawsscripts
View the list's information and change your settings at
//www.freelists.org/list/jawsscripts
View the list's information and change your settings at
//www.freelists.org/list/jawsscripts
