[jawsscripts] Re: Good intros to JAWS scripting, accessing highlight status of text in PDF

  • From: jason <bealjason2@xxxxxxxxx>
  • To: "jawsscripts@xxxxxxxxxxxxx" <jawsscripts@xxxxxxxxxxxxx>
  • Date: Sun, 25 Oct 2020 12:31:21 +0000

 
HI Chaba

 

I also have been using ja= ws for version 12 and been writing some basic
scripts.

 

I would really would love to = help in this project.

 

On a different note is there any way of moving the jaws script= list from
freelist to groups.io

 

Kind regards

Jason

 

 = 

Sent from Mail[1] for Windows 10

&= nbsp;

From: Csaba =C3=81rp=C3=A1dh=C3=A1zy-Godo[2]
Sent: 2= 4 October 2020 08:34
To: jawsscripts@xxxxxxxxxxxxx[3]
Subject: [jawsscripts] Re: Goo= d intros to JAWS scripting, accessing
highlight status of text in PDF

 

Good mor= ning for everybody!

 

So, some words=C2=A0 about jaws-script.org:

 

I have had to use a screen = reader since 2012. I tried more, including 

the now= discontinued WindowEye, NVDA, and JAWS. In terms of knowledge, 

JAWS was by far the best, so I chose that. I started with the= 2011 

version. I immediately realized that althoug= h the knowledge of the 

screen reader was high, it = was missing a very important thing that both 

Windo= wEye and NVDA had. And this is the "power of the community." = 

Factory-provided scripts are, in most cases, very &quo= t;low-cost" or may
not 

actually be usable for= a particular program.

I have also been on this lis= t since 2012. Like so many of us, I 

"download= ed" the ideas I find useful and store them on a "jaws wiki" = 

directory on my machine, and I browse them when I = need to. It has long 

been stated in me that it wou= ld be good to put these on the net in a 

structured= way, because I have a problem when I leave and not work on my 

home machine. This is because I can't access these files. Then= as I 

became acquaintances on the list here over t= he years and started talking 

to a few people in pr= ivate, I realized that others were wearing similar 

shoes. It became clear to me that not olny did I miss what WindowEye and 

NVDA have: a repository of community knowledge. Whe= re one can look for 

things if one gets stuck worki= ng with JAWS.

 

As a sighted I worked at Microsoft back in the early to mid-90s, where= I 

was involved in building both Access 1.0 / 2.0 = and Visual Basic 1.0-3.0. 

Here I really liked prog= ramming in macro languages. Respectively, the 

deve= lopment of macro languages. When I started working with JAWS, I 

realized the JAWS Script language - although very powerfull -= but not 

properly "developed". For a beg= inner who has no programming basics, the 

beginning= is sure to be bitter. And not only is the language considered 

somehow "thoughtless" for beginners, but it lacks a = lot of the 

simplifications typical of macro langua= ges.

 

Here= in Hungary, where I live, several people have approached me over 

the years to help them learn to write JAWS scripts. Working= with them to 

make programming easier - a huge col= lection of functions has been born. 

Which is to ad= d features that are very much missing from the JAWS 

scripting language. Some of them are just so-called "shorthand"= 

versions=C2=A0 of some built-in ones, while other= s bring completely new 

functionality to the langua= ge. These include e.g. JAWS Script wrappers 

writte= n around COM objects pre-installed in Windows. These are script 

modules that make the functionality of an object callable in = the usual 

way in the JAWS Script language without = knowing the structure of the 

object. Some example:= 

shorthand versions of built-in functions

 

GetCurrentWindowCl= ass () instead of GetWindowClass (GetFocus ()).

Get= GrandParent () instead of GetParent (GetParent (GetFocus ())).

GetWindowRight instead of (GetWindowRight (GetFocus ()).ControlIsEdit ()
instead of [GetObjectSubtypeCode (GetFo= cus ()) =3D=3D WT_EDIT].

InitString (VariableToInit= ialize, InitialValue) instead of writing [If 

Varia= bleToInitialize =3D=3D cscNull Then ....] block.

 

These functions make programming ea= sier for both beginners and advanced 

programmers, = and the code is much more readable. Not to mention that you 

can achieve the same goal with much less typing.

 

=E2=80=A2 New functionali= ty

 

Create= UIAObject () - which simply returns the UIA object.

RegExp Replace (StringReplaceIn, StringToBeReplaced, StringReplaceWith) 

- which replaces strings based on regexp conditions.= 

CopyFileToString (FilePath) - which copies the con= tent of a text file 

into a string variable.

ExcelGetCurrentSheet () - which returns the reference to = the currently 

opened sheet in Excel.

GetFileList (FolderPath, Mask) - which returns the list of fil= e names as 

a vertical bar separated string.

 

Some of these f= unctions complement and simplify the functionality that 

already exists in JAWS, but most bring completely new functionality t= o 

the language. It is about 1000 functions.

 

Also, while wor= king with beginners, there have born several descriptions 

&walktroughs that are similar the one Theodore has published.

I also wrote several add-ons for JAWS that also mak= e it easier to work 

with scripts. For example, JAW= S is missing wizards. I=E2=80=99ve created
several 

wizards in Access, so I know these come in very handy (sometimes not just)
for beginners. Thus, over the years, a script wiz= ard has been 

created that creates the framework fo= r a new script with a few clicks, 

or a wizard crea= ted to create variables, create a script / function 

declaration, insert an event function, or insert a default function to 

overwrite it. But a standardized JAWS script project= manager has also 

been created to make the work of= more experienced script writers easier. 

Or, in ad= dition, a universal JAWS Script Installer that creates an 

installer from the created project file with one click, or one can = click 

to install script packages under the current= ly running version of JAWS. 

And lots of similar li= ttle things, which make the work with JAWS scripts 

easier not for beginners only.

 

So the conversation with others convinced me to not = only distribute them 

in a narrow circle, but to in= ternationalize, standardize, and make them 

availab= le to everyone on the net. That=E2=80=99s when the idea of 

=E2=80=8B=E2=80=8Bjaws-script.org was born. Since I am currently d= oing it
alone, I will 

follow the principle of grad= ation. I dedicate this page to a repository 

of kno= wledge about the JAWS Script language. So you would primarily have 

4 sections:

 1. How to &walktrougn section: where descriptions = focusing on each 

problem would be included.

 

2. Tips &t= ricks section: where there would be descriptions that contain 

general ideas and solutions related to scripting.

 

3. Download section:= where the scripts you write will be published, so 

gathered in one place, categorized will be much easier to find if 

someone is looking

for something.

4. JAWS Script Language reference section: which wo= uld be nothing more 

than an online language refere= nce, as it would be very much needed as 

well. This= section would also include localized versions, as the vast 

majority of JAWS users and scripters do not speak English.

 

So in a nutshel= l, this would be jaws-script.org, which could then spread 

and evolve later, as it would be possible for anyone to write a wik= i and 

publish it. Or to share your own scripts and= modules with others. But 

since I=E2=80=99m doing = it alone right now, I=E2=80=99m asking for
patiencefrom 

everyone. Since most of my materials are written in Hungarian, translating
them into English and standardizing them is= a big job. :-)

 

I welcome ideas and comments from the community, as I make it for th= e 

community after all.

 

Chaba

&= nbsp;

 

 

2020. 10. 24. 3:53 keltez=C3= =A9ssel, Theodore Cooke =C3=ADrta:

Chaba, plea= se tell us more about Jaws-script.org



On 10/23/20, Csaba =C3=81rp=C3=A1dh=C3=A1zy-Godo <=
arpadhazi68.jawsul@xxxxxxxxx> wrote:

Hi= James,



yes it is a very good idea! And it will be realized soon. T= his is

because "jaws-script.org"= will be started early next year. :-)

Bess= t,



Chaba



2020. 10. 22. 21:57 keltez=C3=A9ssel, James Benste= ad =C3=ADrta:

Hi Theodore,

Your scripting tutorials look great, thank you so= much for sharing them!



It makes me wonder whether it might= be a good idea to set up a wiki
where

= the JAWS scripting community could develop and share tutorials and

documentation. I would guess that many of us = have something we could

share,

or a little time we could put in to developin= g short articles on areas

that

we are knowledgeable about. What do you think= ?



Jim



--

&g= t; Too brief? Here's why! http://emailcharter.org

&= gt;>> 

&nbsp= ;

On Sat, 17 Oct 2020 at 12:18, = Theodore Cooke <theodorecooke@xxxxxxxxx>

= >>wrote:

Yes, you can link to it from your site.= 

Now that I have confirmation that= people like it, I'll start on part 2.

= >- Show quoted text -

&nbs= p;



On 10/16/20, Snowman <snowman@snowmanra= dio.com> wrote:

Ted,=C2=A0 = I did not know this tutorial existed.=C2=A0 But, it seems
like people>>>> would

&= gt;>> 

f= ind it very useful.

I'd like t= o link to it from my site.=C2=A0 Can I use the link you
provided?

Or,

&gt= ;> 

will th= is be moving soon.









&= gt;>
+------------------------------------------------------------------=
--------+

Listen to The Snowma= n on MushroomFM.com, Saturday evenings, 8PM
Eastern

time.

60= 's and 70's tunes, and gently conservative talk.

&g= t;>>>> 

&gt= ;> ----- Original Message -----

= >From: "Theodore Cooke" <theodorecooke@xxxxxxxxx>>>>>> To:
<jawsscripts@xxxxxxxxxxxxx&g= t;

Sent: Friday, October 16, 2= 020 9:36 AM

Subject: [jawsscri= pts] Re: Good intros to JAWS scripting, accessing

&= gt;>>>> highlight status of text in PDF



= >> 

Here= 's a walk through I wrote on learning jaws scripting. There is a

part II in the works, but since I haven'= t received any feedback on

par= t 1 yet, I have left part 2 on the back burner for now.



= >>https://gist.github.com/BeastlyTheos/177004102bafda4b20e9b6e72863d=
29a?fbclid=3DIwAR3LNsFC3Ny66yAx8RknBpDEMXnJwa8h9lHj53NMkMMNEwFhd3F4X3WKH1s





= >>>>>On 9/25/20, Csaba =C3=81rp=C3=A1dh=C3=A1zy-Godo <ar=
padhazi68.jawsul@xxxxxxxxx> wrote:

&= gt;>> Hi, James,



here is the = ling:



https://support.freedomscient= ific.com/support/jawsdocumentation/FSDN

&gt= ;>>> 

= > 

2020= 09. 24. 22:53 keltez=C3=A9ssel, James Benstead =C3=ADrta:

Hi Csaba,

= >>>>>>Thank you, I will continue my work in learning JAW= S scripting on
that

ba= sis!



I can't find the speci= fic FSDN help file "The Essential JAWS

&gt= ;>>>>> Scripting

&gt= ;>> Handbook", but I did find the "Basics of Scripting Manu= al" at





https://support.freedomscientifi=
c.com/Content/Documents/Other/ScriptManual/01-0_Introduction.htm



And the FSDN help file at



https://support.freedomscientific.com/=
support/jawsdocumentation/FSDN

= >> 

&= gt; Which includes "General Scripting Concepts", "Reference =
Guide", and

"API

Tools".



Are these the correct documents to start wi= th? Or am I missing

so= mething?



Thanks again!>>>>>>> 

Jim

&gt= ;>>>>>> 

= >>>>>--

&gt= ; Too brief? Here's why! http://emailcharter.org

&g= t;>>>>>> 

&gt= ;>>>>> 

= >>>>On Thu, 24 Sep 2020 at 20:30, Csaba =C3=81rp=C3=A1dh=C3=A1= zy-Godo
<

arpadhazi= 68.jawsul@xxxxxxxxx> wrote:

= >> 

&= gt;> Hi James,



o= f course, JAWS Script language has functions to determine the

colors

on

&= gt;>>>> the screen. Bot hte foreground &the background. I = recommend
you to

d= ownload FSDN (Freedom Scientific Developer Network) help file
what

is

"The EssentialJAWS Scripting Handboo= k".

&nbsp= ;

HTH



Csaba





2020. 09. 24. 14:56 keltez=C3=A9ssel, J= ames Benstead =C3=ADrta:

&g= t;>> I'm looking to get into JAWS scripting. Are there good online

resources

to

get me started? I have some experie= nce of coding.

= One specific thing I'd like to be able to access with a script is

the

"highlighting status" = of any give character in a PDF. Not

&gt= ; highlighting

= as

in "s= electing text so that you can then make it bold or italic",

but

the

&g= t;>>>>>>> sort of highlighting you can add to a PDF th= at looks like
you've

drawn

on

the document with a highlighter = pen. Is this information
available

= >>>>>to

&gt= ;> JAWS

scr= ipts?

&nbs= p;

--

Too brief? Here'= s why! http://emailcharter.org

= >>>> 

&= gt;>>>> 

&g= t;>>>>> __________=EF=BF=BD

= >>>>>>> 

&= gt;>>>>>>> View the list's information and change your= settings at

h= ttp://www.freelists.org/list/jawsscripts

&g= t;>>>>>> 

&gt= ;>>>>>> __________=EF=BF=BD

&= gt;>>>>>> 

&g= t;>>>>>> View the list's information and change your sett= ings at

http://www= =2Efreelists.org/list/jawsscripts

&= gt;>>> 

&g= t;>>> 

&gt= ;>> 

= >__________=EF=BF=BD

&g= t; 

Vi= ew the list's information and change your settings at

//www.freelists.org/list/jawsscripts



__________=EF=BF=BD



View the list's information and change your se= ttings at

http://www.freel= ists.org/list/jawsscripts



&nbsp= ;

__________=EF=BF=BD



View the list's information and change your s= ettings at

http://www.freelist= s.org/list/jawsscripts

&nb= sp;

__________=EF=BF=BD



View the list's information and change yo= ur settings at

http://www.free= lists.org/list/jawsscripts





__________=EF=BF=BD



= >>>View the list's information and change your settings at

//www.freelists.org/list/jawsscript= s





= > 

__________=EF=BF= =BD



View the list's information and change your settings at= 

//www.freelists.org/list/jawsscr= ipts



__________=EF=BF=BD

&= nbsp;

View the list's information an= d change your settings at

http://www.freel= ists.org/list/jawsscripts





= >__________=EF=BF=BD



View the list's information and change your settings at

//www.freelists.org/list/jawsscripts



__________=EF=BF=BD

 

View the list's informat= ion and change your settings at 

http://www.freelis= ts.org/list/jawsscripts

 

 
[IMG][4]Virus-= free. www.avast.com[5] [6]

--- Links ---
   1 3D"https://go.microsoft.com/fwli=
   2 3D"mailto:arpadhazi68.=
   3 3D"mailto:jawsscripts@freelists.=
   4 3D"https://ww=
   5 3D"https://www.avast.com/sig-email?utm_medium=3Demail&utm_sou=
   6 3D"#DAB4FAD8-2DD7-40BB-A1B8-4E2AA1F9FDF2"
__________�

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

Other related posts: