I have started on the task. Will get back to the list, when my first draft is ready. For ease of editing, I am putting it up in an Excel(2003) spreadsheet. The final format, will have to be determined later. But the spreadsheet format is easy to build, edit, update, and maintain; why I did choose it from the start. It should be no problem to convert to other formats later.

Be back in a week - or so - when first draft is good to go for a proof read... :)

----- Original Message ----- From: "Chip Orange" <lists3...@comcast.net>
To: <gw-scripting@gwmicro.com>
Sent: Sunday, January 17, 2010 10:33 PM
Subject: idea for more help documentation


David,

I think something like this could be helpful, so I'm changing the subject
when I reply, to get your post read.

I think the wiki is the right place for this; there's a link to the wiki
right from script central.

I hope you will take it on; or someone will; I'd like to see the wiki start
growing with more participation than just me.

you'll find a list of root level objects in the "so you want to write a
script" article, the first part. you could start with them, and simply list
them and all their properties, as your first version.

Chip


-----Original Message-----
From: David [mailto:eleph...@tele2.no]
Sent: Sunday, January 17, 2010 2:24 AM
To: Scripting List WE
Subject: Re: Braille Table question

Look at that! Here we go!
That sure did the trick. And I see a couple of things, why I never got it to work. First of all, I didn't do the ActiveSettings thing, and second I kept
clinging to the BrailleTables thing. Getting things sorted out, and
concentrating on the things that do need their considerationm, surely made
the difference. And, we are back to the manual stuff again. One thing that I
do miss, and wish could be made available, is a FEATURE CHART. It could
easily be done in Excel, or even in a Word document.

The way, I think it could be done, is to have all 'top-level' commands (name them objects or whatever), in the first column. The second column would hold
each of the properties/methods that the object has available, one on each
line, and the third column would hold all the things that was available on
the 'third level'. Well, not sure if this makes sense, the way I am able to
describe it right now, but I will see if I can get something started, and
let you guys complete it. First it is ready, we could have it posted on the
WIKI, or even better on Script Central, so that everyone could get hold of
it. And, hopefully, GW could include it with future shipments of WE.

If you had a chart like this, it would have been quick to do a search for
the function you want, and you would quickly (by reading the left side
columns on the same row), see which 'chain' you have to follow, so as to get
the command right. You would for instance have seen, some of the commands
you need for getting info about the current Braille line, presented like
this:

ActiveSettings    Braille    Line
ActiveSettings    Braille    PhysicalCellCount
activeSettings    braille    TranslationTables    active    name
...and so forth...

Charts like this, is known, for instance, from your cell phone manual (in
print). And I personally like them, as you rather quickly get the idea of
the whole layout. Maybe even this would help people grasp the idea of
objects and methods etc, far more easily, as they now will see the direct
connection between the different elements. And, you don't get into an
everlasting circle of links that keeps taking you back and forth in a ton of
terms, you don't really understand fully.

Anyone else think this to be an idea? Someone wants to grasp it - and get
the chart out the door? Well, should I have made the suggestion in a
seperate posting, in case people skip this message, due to the header of
this very posting?

Thanks again,

----- Original Message -----
From: "Chip Orange" <lists3...@comcast.net>
To: <gw-scripting@gwmicro.com>
Sent: Saturday, January 16, 2010 11:53 PM
Subject: RE: Braille Table question


David,

looks like I missed a property of the collection; there is a property
named
"active" which indicates the single braille table which is active, so
going
through the collection isn't necessary after all.

instead, I think you want:

speak activeSettings.braille.TranslationTables.active.name

hth,

Chip

-----Original Message-----
From: Chip Orange [mailto:lists3...@comcast.net]
Sent: Saturday, January 16, 2010 2:28 PM
To: 'gw-scripting@gwmicro.com'
Subject: RE: Braille Table question

David,

in the help file, yes it seems you understood exactly where I meant, when
it
tells you which kind of object something may be retrieved from, you can
click on that object there in the text, and you'll be reading the main
help
topic for it.

if you had gone back just one level further from setfile you would have
seen
that the active setfile is a property named activeSettings of the
application object.  Any time you need to know what's active for pretty
much
anything, try looking first under the application object.  sometimes, if
you
guess right there as to which general type of item the property you're
seeking might be in, you can go down from the top and find it, rather than
from the bottom going up.  however, the bottom going up as I said will
always work, without guessing.

In this case, it looks to me like you should use:

activeSettings.braille.TranslationTables

which will give you a collection of all the braille tables in the
currently
active setfile.  If you have never dealt with a collection before, it's a
kind of list, like an array, and you'll have to run through it, processing
each item in the list like this:

dim objCurTable
for each objCurTable in activeSettings.braille.TranslationTables
' do something with objCurTable
next

I realize that the help file can be confusing when it's telling you the
object type, can be had from a property name (that's different than the
object type name) of another object type name, which when you look it up
comes from a property which is named differently than the object type name
... and so on.

I hope you will read the two wiki articles, and tell me where you're still
confused; I'm trying to do something about it for beginners.

hth,

Chip

________________________________

From: David [mailto:eleph...@tele2.no]
Sent: Saturday, January 16, 2010 2:24 AM
To: gw-scripting@gwmicro.com
Subject: Re: Braille Table question


Yes, Chip! I know of the help on each item, if I get your description
right;
and we are talking the same language.

Still, I think I get lost somewhere in here. As far as I can make it, to
get
the name of the active Braille table, I have to get to the
ACTIVE
Which can be retrieved from
BrailleTables
Which is to be retrieved from
TRANSLATIONTABLES
Which is retrieved from
BRAILLESETTINGS
Which is retrieved from
BRAILLE
Which is retrieved from
SETFILE object.
PWEEW! Allright, where is it I got lost? Could someone, please, have
provided me a short sample code, that would return the name or number of
the
currently active Braille Table? I thought it would be possible, but find
the
manual of very little help, as it only reads a load of 'can be retrieved
from', and provides absolutely NO example, whatsoever. Feels like one or
two
lines of sample code every now and then, would have been really helpful.
This is actually one of the BIG drawback I find about the Scripting
manual.
Cases like this, I feel like you are linked in an ever ongoing circle, and
you keep swirling around therein, all till someone provides a bit of
sample
code, and Woopsy, you start to grasp some meaning in all of it. Don't
know,
if it is only me, who feels that way. And, for right now, it doesn't
matter
too much whether or not. What keeps my project stuck, at the moment, is
that
I can't get the info as to which Braille table is active, or how to change
it.

Hope someone can provide me a bit of help, since I have been running in
circles in the manual for a few hours now.

Thanks alot!




----- Original Message ----- From: Chip Orange <mailto:lists3...@comcast.net>
To: gw-scripting@gwmicro.com
Sent: Saturday, January 16, 2010 4:21 AM
Subject: RE: Braille Table question

Hi David,

if you will go into the help file, and find the brailletables
object, and press enter on it, this will open it up in the tree structure, but it will also make a help topic for the object available, which you can
see as usual with the f6 key.  it took me a while to catch on to this, I
thought the top level objects were just there as containers for the
properties and methods in the tree structure, but they do have their own
help, and each one tells you how to get that particular kind of object.
here is what it says for brailleTables:

"Usage
Use the
BrailleTables
object to retrieve a collection of Braille tables. A
BrailleTables
object can be obtained from a
BrailleSettings
object's
TranslationTables
property."

hth,

Chip

________________________________

From: David [mailto:eleph...@tele2.no]
Sent: Friday, January 15, 2010 9:37 PM
To: Scripting List WE
Subject: Braille Table question


I am pretty sure, I don't understand the manual. So every bit of
direction is greatly appriciated. Here is my script, please let me know
what
I am missing, and how to do it correctly.

Dim BrlTab
Set BrlTab = BrailleTables.Active
Speak "Current Braille Table is: " & BrlTab

I get the following error message:
Variable is undefined: 'BrailleTables'
Ok, what do I do to define the BrailleTables object, described in
the manual?

Thanks again,


________________________________

I am using the Free version of SPAMfighter
<http://www.spamfighter.com/len> .
We are a community of 6 million users fighting spam.
SPAMfighter has removed 320 of my spam emails to date.
The Professional version does not have this message.





--
I am using the free version of SPAMfighter.
We are a community of 6 million users fighting spam.
SPAMfighter has removed 327 of my spam emails to date.
Get the free SPAMfighter here: http://www.spamfighter.com/len

The Professional version does not have this message




--
I am using the free version of SPAMfighter.
We are a community of 6 million users fighting spam.
SPAMfighter has removed 374 of my spam emails to date.
Get the free SPAMfighter here: http://www.spamfighter.com/len

The Professional version does not have this message


Reply via email to