GWKB1009 : Set File Associations

Product: Window-Eyes
Author: Aaron Smith
Date Added: 09/20/2005
Last Modified: 09/20/2005

Associated means you or someone saved a set file and when Window-Eyes said "confirm association" you said yes. This means whenever the current Microsoft Window ever gets activation, Window-Eyes will automatically load that set file. It's that simple. A set file that is associated just tells Window-Eyes to automatically load it when the designated Microsoft Window gains activation.

Okay, so what is active then?

Active is just the name of the set file that Window-Eyes is currently using. When I launch Wordpad the Wordpad window gets activation so Window-Eyes automatically loads "WORDPAD.000" because it is the associated set file (We did this association for you). So naturally, the associated file is "WORDPAD.000" on the Window-Eyes title bar. But because no other set file has been loaded since WORDPAD.000 was loaded, it is also the active set file because it is the set file that is currently loaded and being used by Window-Eyes.

Suppose you pop up Window-Eyes at this point and load another set file called "test.000". Well, by loading test.000 you didn't change the association for Wordpad so of course it still says WORDPAD.000 is the associated set file. But you did change the currently loaded or active set file so it now shows TEST.000 for the active set file.

Beginning to see the difference?

Normally they will be the same but if you manually load a new set file or if you have a hyperactive window load a new file they will be different. In WordPerfect I have a hyperactive window detect when you are in the spell checker. So WP8.000 is the associated set file but wp8spl.000 is the active set when you are in the spell checker. This is actually unique to Wordperfect because with most spell checkers you get a new window that received activation. For example when you go into the spell checker with Word, a new window pops up and gets activation...well, you know what happens when a window gets activation!!! Window-Eyes automatically loads the set file associated with it. But again, WordPerfect doesn't give the spell checker window activation, it just displays it at the bottom.

Also, if you go into a new application that doesn't have an associated set file, the active file will probably be "WINEYES.00" because that is what is currently loaded and being used but associated will be "NONE" because there is no association.

In summary! Associated is what Window-Eyes will load when that Microsoft Window gets activation. Active is what Window-Eyes is currently using.

Still confused? Okay, here we go...

When a Microsoft window gets activation, Window-Eyes sees this. At this point, Window-Eyes will get the module name of the application who owns the window. This is just the executable name. It needs the module name because the association information is stored in a file whose first part of the file name is the module name and the extension is .WE. So if I were in Wordpad, the module is WORDPAD so Window-Eyes looks in the file WORDPAD.WE. In this file Window-Eyes looks for an entry that has the title of the active window in it. If there is such an entry the set file specified is used. If there isn't an entry for the title of the active window, Window-Eyes looks for an entry of the class of the active window. If that exists, Window-Eyes loads the specified file for that. If there is neither a title or class entry for the active window, Window-Eyes doesn't load anything and just uses what it was using before. So in that case, the title bar would says "associated none."

When you just save a file from the Window-Eyes file menu (and confirm the association), Window-Eyes will automatically create the .WE file (based on the module name) and create an entry in this file based on the title of the currently active window. So in other words, this will associate the set file to the currently a active window based on the title and module of the window.

If you wish to associate by the class of the window instead of the title, you need to go to the Window-Eyes file menu and choose the Window Information option. If Window-Eyes allows it, the associate with class button will be available. If you select this button, Window-Eyes will again make a .WE file based on the module of the active window. It will then make an entry based on the class of the active window instead of the title.

So you can associate based on the title of the window or the class of the window. The title has precedence over the class if they both happen to be there.

For example, when I create set files in most applications I don't want the entire dialog to be read when it pops up. Just too much verbiage. But there are some I like to hear the entire dialog. Most of the dialogs have the same class but have different titles. So I create two set files for dialogs. One that will read the entire dialog and one that won't. Then I go to the dialogs that I want to read and associate the set file to it based on the title...I'll do this for all that I want to read everything. Then I will go to one of the dialogs I don't want to read everything and I'll associate the correct set file to it based on the class.