nvdaController interface and client: make all functions use the stdcall calling convention (they used to use the cdecl calling convention). This should allow them to be called from Visual Basic. The nvdaHelperLocal nvdaController function pointers and Python callbacks in nvdaHelper.py have also been changed to stdcall more for completeness than necessity.

speech: Don't speak the "check menu item" role. However, do speak "not checked" for check menu items to inform the user they are checkable.

 * NVDA Controller python example: update library name regarding the latest changes.

nvdaHelper: restructured the main sconstruct file quite a bit to handle multiple install locations. Hopefully its now a bit more readable also. The client library (dll,lib etc) are now installed in to extras/controllerClient. nvdaController.h (generated from the nvdaController interface) is also installed in to extras/controllerClient, completing the needed bits of the client API.

Added some short documentation and examples for using NVDA controller client API. There is an example c source file (which could be compiled and linked against the client import library), and an example Python script. that uses ctypes to call functions in the client dll. The documentation mentions roughly how the library should be used, and the license that its under.

nvdaControllerClient: append '32' or '64' to the end of the library name so that it reflects the architecture. E.g. nvdaControllerClient32.dll.  Rename nvdaControllerClient.dll.def to nvdaControllerClient.def and integrate it in to the sconscript much better so that changes to this file force the library to be rebuilt.

Updated brazilian portuguese language strings for the NVDA installer,
Updated slovak what's new.

WinConsole NVDAObject: if braille is tethered to review and you focus on a console window, you can now correctly read its text with the review cursor.  You can also now read the text in any console window you move to with object navigation. However, if you move to a console window with object navigation, but you are currently focused on a console window, the focused console window will no longer be spoken by NVDA when it updates, unless you either navigate back to that console, or you switch focus away and back again. In short, if the navigator object moves to a console window, NVDA gets connected to that console (for text reading).

nvdaController interface: add a method 'testIfRunning' which technically does nothing, but can be used to test if NVDA is currently running. It will return 0 if it successed, non-zero otherwize.

NVDAController sconscript file:  make sure to use  the preexisting value of MIDLFLAGS in the new value given to MSRPCStubs when creating the NVDAController stubs. This allows nvdaController to again be build for 64 bit systems.

Updated finnish language file, language strings for the NVDA installer, what's new,
Updated italian language file, language strings for the NVDA installer,
Updated slovak language file, language strings for the NVDA installer, what's new,
Updated czech language strings for the NVDA installer,
Updated hungarian language strings for the NVDA installer, what's new,
Corrected the liblouis version number in the english what's new.

Installer: add english lang string for the desktop shortcut component (forgot to commit this along with the addition of the component). Now at least in English installers  you can see the desktop shortcut component.

Installer: do not show the checkbox on the start menu page that allows you to disable creation of shortcuts, it is confusing to some users, plus  Its probably quite a standard thing to place a program in the start menu when installing.

Update what's new.

source readme: Push minimum requirement for IAccessible2 to 1.1. Update for the addition of the 64 bit proxy dll.

mshtml vbuf backend: Don't render images with alt attribs in links if the link has text content, as the text is sufficient and the image is almost certainly irrelevant.

what's new: Add a missing ticket number.

Introducing  nvdaControllerClient.dll, which can be used from external applications, to communicate with NVDA.
This client dll exposes the nvdaController RPC interface, which currently has the following functions: getNVDAVersionString, speakText, cancelSpeech, and brailleMessage.
Due to recent changes to nvdaController, these client functions can be used with out worrying about RPC exceptions, and or binding handles. Any errors will be given back as the return code.
nvdaControllerClient.dll now gets built along with nvdaHelper (its code lives in nvdaHelper/client/), and the dll is placed in NVDA's lib and lib64 directories.

*nvdaController interface: make the bindingh handle implicit so that it does not have to be passed in for every call. As there can only be one NVDA running on the system, there's no need to allow for specifying different binding handles. nvdaController.acf has been added partyly for this purpose.
*nvdaController interface: all methods now return a type of error_status_t. Any faults or communication errors are now communicated via this return code, rather than causing an RPC exception. Again, nvdaController.acf was needed for this.
*ia2 live region support in nvdaHelperRemote: no longer a need for  the speakText wrapper function as we no longer get RPC exceptions or need to pass a binding handle. We create/free the  implicit global binding handle (nvdaControllerBindingHandle) in the initialization/termination functions, rather than a specific one.
*nvdaHelper.py: Make sure to register all function pointer callbacks, with a nice list and For loop.
*nvdaController interface: add two new methods: cancelSpeech, and brailleMessage. Implement these in nvdaHelper.py / nvdaHelperLocal.

All these changes should make it quite a bit easier to now implement a client dll for communicating with NVDA from external programs.

Update what's new.

vbuf backends: Images inside links and clickables with alt= are no longer incorrectly rendered. One exception is where a link only includes an image with alt= and nothing else, in which case it will be included, as this is obviously an authoring error.

Updated brazilian portuguese language strings for the NVDA installer, readme and quick command keys,
Updated spanish language file,
Updated czech language file, user guide and what's new,
Updated french language file,
Updated hungarian language file and what's new.

Move the creation of the desktop icon and shortcut key in to its own section, which can be disabled from the components page.

laptop keyboard layout: Add braille_toggleTether. Update header comments. Closes #517.

logonui app module: cosmetic: Rename PasswordField to XPPasswordField, as it is only used for the XP logon screen.

braille: Add German 8 dot computer braille, German grade 2 and Chinese (Taiwan, Manderin) to tables list. Closes #344, #369 and #415.

Updated croatian language file,
Updated brazilian portuguese language file.

Added what's new in dutch and updated dutch language file,
Updated german language file and the strings for the NVDA installer,
Updated finnish language file, what's new and quick command keys,
Updated italian language file,
Updated brazilian portuguese language file,
Updated polish language strings for the NVDA installer,
Updated spanish language file and what's new document,
Updated galician language file and what's new document,
Updated slovak language file and what's new.

braille.TextInfoRegion._isMultiline: always treet virtualBuffers as multiline. Necessary as a virtualBuffer object has no 'role' or 'states' properties to query.

Braille.ReviewTextInfoRegion: stop forcing isMultiline to true. This was always making it impossible to see the labels of edit fields when tethered to review. Perhaps there was a reason for this, though I'd prefer we find another way around it if possible.

Update what's new

Make Braille's tether setting configurable from the Braille settings dialog, and also store it in the config file so that it can be saved across runs of NVDA. The combo box allows you to choose between focus and review.

Update what's new

Braille: if a key is pressed after a braille message appears, the message will automatically be dismissed due to a change in braille such as the focus/caret/review moving. In short, messages will still stay around for their whole time, even if something changes, but, if the change was due to a key press (for example moving focus with the arrow keys) then the message will be dismissed straight away.

Added two new scripts to the default appModule for locking/unlocking the left and right mouse buttons. shift+numpadDivide locks/unlocks the left mouse button. shift+numpadMultiply locks/unlocks the right mouse button. Useful for drag/drop.

Winword TextInfo's updateCaret method: scroll the TextInfo's range into view before setting the caret. This makes sure that the caret never goes off the screen. This fixes a bug where reading for a long time in MS Word NVDA would seem to not move the cursor. Please report if there is any strange side affects like the document jumping all over the place when in sayAll.

Fix error in German l langstrings file for the installer. It was stopping the installer from compiling. Which also indirectly meant no snapshots..

Outlook appModule: finally completely fix the freezes when opening plain text / HTML emails in Outlook 2003. Specifically hack the parent of each control to be its grandparent window. Fixes #134

braille.ReviewTextInfoRegion._get_selection: copy the review position before returning it. This fixes a bug where it was impossible to move with review while braille was tethered to review. This was due to the change in braille.TextInfoRegion.update where the caret is no longer copied before expanding.

Add navigatorObject_moveFocus script to the default appModule (NVDA+shift+subtract) which tries to move the focus to the navigator object.

UIA NVDAObject: implement setFocus method.

Updated german language file, language strings for the NVDA installer,
Updated spanish language file, language strings for the NVDA installer, what's new document,
Updated brazilian portuguese language file,
Updated finnish what's new,
Updated galician user guide.

Update what's new

If running in secure mode (--secure) (Windows logon, secure desktops): no longer show  the log viewer in the tools menu, nore any of the documentation in the Help Menu (Welcome dialog and About... still appear). This stops either sensitive information being viewed, and or system files from being replaced. Fixes #515

Updated spanish language file and what's new,
Updated galician language file and what's new,
Updated finnish language file and what's new,
Updated japanese language file,
Updated hungarian language file, language strings for the NVDA installer and what's new.

Added a ShellDocObjectView IAccessible NVDAObject, which bounces the focus to its inner MSHTML document if focus lands on it and there are no pending focus events. This specifically allows you to read the Adobe Reader 9 Licence agreement, and it possibly could help in other places.

Updated italian language file and the language strings for the NVDA installer,
French language file,
Polish language file, user guide and quick command keys,
Czech language file,
Slovak language file and what's new document.

The Display Synth has now been replaced with a new Speech Viewer.
This Speech Viewer (activated from the Tools menu) can be used independently of what ever speech synthesizer you are currently using. This has the advantage that blind people are now able to use NVDA while sighted people may be viewing the speech (useful in presentations).

Outlook appModule: add specific support for the entry list in the Address book. Now when the arrow keys or home/end keys are pressed, NVDA will  speak the new entry selected.

MSN messenger appModule: the spanish word for History is 'Historial'. Adding this should allow NVDA to speak incoming messages for Spanish MSN Messenger.

Update What's new

Hopefully finally solved all the expand to line issues in Microsoft Word.
This new implementation seems to work in Word and Outlook 2007, and Word and Outlook 2003!
Specifically:
*Core: monkey patch comtypes's VARIANT class so that if value is given a ctypes pointer instance, it will set the variant to be a byref (VT_BYREF)
This allows us to provide arguments by reference if needed in IDispatch method calls.
*WordDocumentTextInfo._expandToLineAtCaret: use the GetPoint method on the Microsoft Word window object to find out the coordinates of the TextInfo's range object.
Then use rangeFromPoint with the start and end coordinates of the line to get ranges for the line and then adjust the TextInfo's range object accordinly.
Note that rangeFromPoint does work in both Outlook 2003 and 2007, but only if you call it on the Microsoft Word Window object retreaved directly from the window, rather than using application.activeWindow. This suits us better anyway.
Also note that the getPoint call depends on the comtypes monkey patch in core, as IDispatch doesn't really convey in and outparameters as such, but instead expects that out parameters will be VARIANTs with VT_BYREF.
The reason we have to use getPoint at all, rather than just rcCaret in GUIThreadInfo is that the caret in Word 2003 documents (seen at least in Windows 7) keeps flickering between its real place and the top of the document.

MSHTML virtualBuffer:  detect the editable state by looking for the IHTMLElement::isContentEditable field attribute.

Changes to the MSHTML vbufBackend to allow access to empty editable documents in MSHTML virtualBuffers.
Specifically:
*Detect if nodes are editable and if they are, expose an IHTMLElement::isContentEditable attribute on the controlFieldNode.
*If a node is editable, but it has the MSAA readonly state, then remove the readonly state -- it does not make sence to be both readOnly and editable.
*If a node is editable, class it also as interactive.
*If a node is interactive but has no content what so ever, then at least provide a space.

MSHTML NVDAObject's states property: if the editable state is present, do not allow the readonly state. IE sometimes provides the readonly state when the node is editable, this does not make sence. This solves an issue wwhere pressing enter inside an editable document in an MSHTML virtualBuffer would not switch to focus mode.

Remove colons from synthSettings i18n labels as they seem to be now already in the GUI code (which was meaning double colons).

source readme: Bump minimum eSpeak version to 1.42.04.

Yet another try at supporting expan to line in Microsoft Word. It seems that rangeFromPoint is not supported in Outlook 2007's message viewer.
*Rename _expandToLineFromCaret to _expandToLineAtCaret (technically now doesn't go from the caret specifically).
*_expandToLineAtCaret: by default now use Microsoft Word's document.GoTo method to get ranges for the start and end of the current line, and update the range object accordinly.
There is still code for using rangeFromPoint, but to enable this, the winwordSupportsRangeFromPoint property on the WordDocument NVDAObject must be set to true. GoTo seems to be supported a little more than rangeFromPoint, though the disavantages are that its a bit slower, and it doesn't quite work in Outlook 2003's MS Word message editor. Something we'll need to solve in the future.
*Rename WinwordDocumentObject property to WinwordWindowObject as technically it is a window object, not a document object.
*Re-implement WinwordDocumentObject and WinwordSelectionObject properties to make use of WinwordWindowObject property. These changes may provide slight speed improvements as we don't have to fetch the window object as much.

explorer app module: Nuke the extremely verbose keyboard help message in the Windows 7 Start menu.

contributors: Change info for Mick and Jamie to say lead developer instead of core development, as this is somewhat clearer.

source readme: Note that Python 2.6.2 or later in the 2.6 series can be used. Bump minimum liblouis version to 1.8.0 and note that a later version can be used.

When collecting the ancestors of the focus: bail out if there are more than 100 of them as this most likely means there is a loop or some other bad implementation of parent in the underlying accessibility hierarchy. This fix is most useful in Microsoft Outlook 2003 where due to a bad implementation of accParent on the message viewer control, NVDA would freeze due to an infinit number of focus ancestors. This is not a perfect fix for Outlook as there still is a short delay until it breaks out of the loop, and NVDA in non-release builds will also play the error sound due to logging this error. But, at least now the freeze is finally gone. Fix for #134

Outlook appModule: again allow NVDA to announce focus changes in regards to treeviews (folder list etc) by  updating code to the new shouldAllowIAccessibleFocusEvent property.

Updated spanish language file, language strings for the NVDA installer and what's new document,
Updated galician language file, language strings for the NVDA installer and what's new document,
Updated finnish language file,
Updated french language file,
Updated slovak language file.

Added colons to the voice settings dialog label captions. (Sorry translators)

Fixed sapi5 loading

 * Updated Russian language file
 * Added keyboard mnemonic to the 'pitch' setting

 * Updated newfon synth driver. Especially:
  * Use new synth settings API to allow the controlling of language, pitch, inflection and accelleration simultaneously;
  * Better xhandling of zeros for Ukrainian

 * SynthSettingsRing: fix broken setting restoring functionality
 * queue the message about name of the current setting for user to hear the message about the value changed first.

 * Don't forget to update synth settings ring if the synthesizer doesn't support voice setting (fixes a bug when synth settings ring stayed not updated for those synthesizers which do not support any settings at all)
 * Update synth settings order in base SynthDriver._get_supportedSettings method to match a general line
 * initialSettingsRingSetting: use indexes instead of setting object as a type. Fixes a bug when settings ring break on synthesizers which still use old API: _get_supportedSettings generates a new list of settings each time, and thus it is impossible to get index of the initial setting in that list
 * Fixes to SynthSettingRing.updateSupportedSettings for proper handling of synths, which does not have any setting.

Merged ticket311 branch from Aleksey Sadovoy.
This significantly changes how NVDA internally manages speech synth settings. Rather than NVDA only having hard-coded support for volume, variant, rate, pitch, inflection and volume, now synths can expose any string or numerical settings they like. The synth settings ring, and the Voice settings dialog are now dynamically managed to allow access to these custom settings.
These changes also fix a bug in the synth settings ring where moving to a voice that added or removed other settings (e.g. a sapi4 voice didn't support pitch)  things would start to break.

Merged main

Removed the example vbufBackend as this code was extremely old and completely incompatible with the new virtualBuffer implementation and nvdaHelper etc.

Reformatted many scons files for nvdaHelper, so that it will be much easier to read diffs if they are changed in the future. Specifically: Break up all source, lib and input lists so that each item is on its own line, with a final comma at the end of the list items. Export each target from the main sconstruct file where its defined, rather than using exports keywords on each sconscript call.

These changes try to fix the issue where NVDA will not show a new blank line on a braille display when pressing enter in a Microsoft Word document or MSHTML edit control.
      Specific changes:
* braille.TextInfoRegion.update: TextInfo implementations such as for MS Word and MSHTML can only expand to line if dealing with the caret. So rather then making a copy of the caret TextInfo and then expanding to line, use the copy as the caret reference and expand the original TextInfo to line.
        * Microsoft Word document TextInfo: remove _expandToLine method and replace it with a better implementation (calling it _expandToLineFromCaret, for better readability). This method uses caret and window coordinates and sets it to the line containing the caret. I.e. from the left edge of the window at the height of the caret to the right side of the window at the height of the caret.
      The advantage of this new way is that we no longer fiddle with MS Word's actual selection, which means no flickering, and it also will stop possible typing errors if typing fast when using braille, due to the above braille change.
      The one disadvantage is that now when arrowing by line in a table, NVDA will report the line relative to the document, rather than relative to the current
 table cell (i.e. it will read the entire row).
      We may be able to fix this in the future by not allowing the use of this way when in a table, though finding this out is quite costly.

      Please test Microsoft Word cursoring a lot, and report any bugs created by this change.

AcrobatTextNode NVDAObject: Update for rename of backspace script to backspaceCharacter. Fixes broken Adobe Reader support.

Updated finnish language file, what's new document and the language strings for the NVDA installer.

 * base SynthDriver: remove odd caching in _get_initialSettingsRingSetting property getter.

Updated czech language strings for the NVDA installer,
Updated galician language file and what's new document,
Updated slovak language file, what's new document and the language strings for the NVDA installer.

IAccessible NVDAObjects name property: Use IAccessibleText When accname is not provided and IAccessibleText which doesn't support caret tracking is implemented. This enables reading of focusable labels inside Thunderbird / Seamonkey.
Default appmodule: Fixed a problem with reportCurrentLine script which was failing on the controls described above.

Arrow keys can now be used in the Web formator window to navigate and read the text. (closes #452)

  The word being deleted is now announced when pressing control+backspace in controls that support it. Specifically: the logic from script_backspace is now in a method called _backspaceScriptHelper, which takes both a keyPress, and a unit.  Script_backspace no longer exists, however script_backspaceCharacter and script_backspaceWord are now used. Fixes #491

EditTextInfo._setSelectionOffsets: Make sure to scroll the window to the caret after updating its position. It seems that Edit controls do not do this automatically. This fixes a bug where  doing a sayAll that reads more than one screen of text and then pressing an arrow key shoots the caret back to the first screen. Fixes #418.

Installer: place readme, key commands and user guide in a documentation folder in the NVDA start menu folder.  Code based on patch from Michel Such.

Update what's new.

what's new and contributors: Tiny cosmetic fixes.

Fix for #378 (Table row and column cache not dropped when leaving table). Seems I broke this already existing feature very early on when table announcment was implemented. Simply make sure that the row and column cache is dropped if we're ever speaking row and column count (we're entering a new table). Fixes #378

Multimedia keys (home page, play, stop etc) now are announced if speak command keys is enabled, while pressing them. Code based on patch from Kendell Clark. Closes #472.

speech.getControlFieldSpeech(): If report tables is disabled, don't report field info for row/column headers. Previously, this code stopped reporting of row/column roles, which doesn't make much sense; I think this was a typo.

nvdaHelper.py:  catch AttributeError exception when setting speakText function pointer, in case its an old nvdaHelperLocal dll.

Merged ia2LiveRegions branch. These changes improve NVDA's support for ARIA live regions in NVDA (For Mozilla Gecko) by moving the live region code in to nvdaHelper (in-process). The code also now handles aria-relevant for addtions, text, all, and not specified. The code handles text changes.  These changes also introduce a new implementation of nvdaController, implemented in nvdaHelper. Though a stand-alone client library has not been completed yet.

updated spanish language file, what's new document,
Updated finnish language file, user guide and what's new document,
Updated czech language file,
Updated slovak language file and what's new document.

Virtual buffers now honour the report object shortcut keys setting found in the Object Presentation dialog. (#486)

what's new: Minor linguistic/cosmetic fixes.

nvdaHelperRemote ia2 live region support: fix typo.

When listing Sapi5 voices try to detects buggy voices and don't include them in the voice settings dialog nor synth settings ring. Prewiously when there was just one problematic voice NVDA's Sapi5 driver would not start in some cases.

Updated What's New

SysTreeview32 TreeviewItem NVDAObject: dramatically improve performance when expanding a treeview item, by re-implementing childCount property by counting the child items directly by window messages, rather than just getting the length of the NVDAObject's children. For a treeview item with 10000 children, this change takes the time down from about 10 seconds, to 0.5 seconds or lower. We may be able to move some of this code in-process in the future which would also increase performance more, plus increase performance when arrowing up and down the children in larege treeview items. However, this improvement for now is certainly useful.

CursorManager.doFindText:  rather than expanding to the current line when speaking the found text, just move the end of the textInfo to the end of the current line. This means that NVDA will speak right from the found text to the end of the line, rather than just speak the entire line. Apart from hearing the found text quicker, its also possibly less confusing as the caret actually was placed on the found text even though NVDA was reading from further back.

speech.getSpeechTextForProperties:  silence particular roles  if row or column numbers are going to be announced. Previously only name and value were checked. This specifically silences 'cell' in tables when its rather redundant for it to be spoken.