A rapid automatic translation with few corrections...

I think it gaves a good idea how it works...

I have already construct the add-on package...

The translation is below my name...

Rui Fontes

# Object Enhancer
* Author: Babbage B.V. <info@...>

Object Enhancer allows you to change how NVDA announces objects on the screen using an intuitive interface. It can be used to change the label of an object, but depending on how you're using it, has functionality to change basically any property of an object.

Changes to an object are saved in a definition.
A definition contains:

* Criteria that have to apply in order for the definition to match
* Attribute changes that will be applied to every object that matches the definition
* Optional relationships with other definitions. A definition can inherrit criteria from other definitions

## Creating your own definitions
Object Enhancer has a graphical interface to make new definitions and edit existing definitions.

To create a new definition for the current navigator object, press NVDA + CONTROL + TAB. This opens the new Definition dialog if no definition is found for the current object, and the existing definition is processed if there is a definition is to edit.

NVDA + Control + Shift + tab opens the main dialog box of the add-on with which you can find out existing definitions and edit existing definitions.

Please note that when you want to make a definition quickly, you can do it best with NVDA + Control + Tab, because you can automatically have certain properties of the object to take over.
For example, when you press this shortcut when the current navigator object is a list item, you can automatically add the current name, role or location to the definition.

### NVDA + Control + Shift + tab opens the main dialog box of the add-on with which you can find out existing definitions and edit existing definitions.

Please note that when you want to make a definition quickly, you can do it best with NVDA + Control + Tab, because you can automatically have certain properties of the object to take over.
For example, when you press this shortcut when the current navigator object is a list item, you can automatically add the current name, role or location to the definition.
NVDA + Control + Shift + tab opens the main dialog box of the add-on with which you can find out existing definitions and edit existing definitions.

Please note that when you want to make a definition quickly, you can do it best with NVDA + Control + Tab, because you can automatically have certain properties of the object to take over.
For example, when you press this shortcut when the current navigator object is a list item, you can automatically add the current name, role or location to the definition.

NVDA + Control + Shift + tab opens the main dialog box of the add-on with which you can find out existing definitions and edit existing definitions.

Please note that when you want to make a definition quickly, you can do it best with NVDA + Control + Tab, because you can automatically have certain properties of the object to take over.
For example, when you press this shortcut when the current navigator object is a list item, you can automatically add the current name, role or location to the definition.

### The Edit New Definition / Definition dialog box consists of the following items:
#### Definition name
A unique name for your definition that you use to recognize it later, and to link it to a different definition if necessary.

#### Filter criteria:
These are the criteria to be used to apply the definition. You can filter on attributes / properties of an object.

Press Add to add a new criteria.
You can choose from the list of relevant object attributes or give up an attribute yourself.
For example, you can choose the WindowsControlID option from the list of attributes, after which the input fields for attribute and value are entered automatically.
For example, if you want to match an object with IAccessibleRole = 10 (ROLE_SYSTEM_CLIENT), you can also do this manually.

You can also edit the current filter criteria or add an extra value to filter, when you want to match an object that, for example, the value 15 or 16 has for WindowControllID.

#### Attribute changes
In the list of attribute changes you can specify which characteristics of the object should be changed. In most cases you probably want to change the name (name) or description (description).

#### Inherit settings from definition / definition is abstractSettings Overflows of definition / definition is abstract
With this drop-down list and this check box you can set a relationship between different definitions.

Imagine that you have to label multiple buttons in one application.
All buttons have a magicbutton window class name.
You can make a definition with WindowClass = MagicButton and the Definition check box is abstract, do not use it directly.
In the following definitions your settings can overflow from the definition of MagicButton, so that the new definition will behave as if windowClassName = MagicButton is specified as a filter criterion.

#### Treat criteria for object location as absolute screen coordinates
When this option is enabled, location criteria from the criteria section are treated as all other attributes. This means that if you define Locaton = (1, 2, 3, 4), any object without this absolute location does not match.

However, if this option is disabled, this has a large effect on object definitions with more than one location.
For more details we refer you to the English documentation.

#### Definition error handling
With this drop-down list you can decide what should happen if an error occurs when evaluating this definition:

* If set to continuue, the error is ignored and the evaluation continues
* If set to Break, the evaluation is demolished
* If set to Raise, a failing evaluation causes a traceback.

Do not apply this option unless you know what you do, eg because you are a NVDA or Python developer.