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
