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.

nvdaHelperRemote IAccessible2 live region support:
*Provide more comments in the code.
*getTextFromIAccessible: if the object does not support IAccessibleText, then recurse in to its children using accessibleChildren.
*getTextFromIAccessible: when looping through characters in the text checking for embedded objects, save off the character for later use. This means less array indexing, but more importantly fixes a bug where if a normal char was found, the char that was placed in the string for speaking was totally incorrect -- startOffset+index, rather than just index.
*For a 'show' event, where both additions and text are allowed, force allowText to false if this object's parent does not support IAccessibleText. If the parent doesn't support IAccessibleText, that means there will be no textInserted event and there fore we must not ignore this show event.

 * Removed reversed creation of controls for voice settings. Instead, define settings in order in which they will be displayed in gui. Implement initialSettingForSynthSettingsRing property on the base SynthDriver class, which returns rate or first of available settings in case of rate isn't supported. Make use of this property in the settings ring.

Don't present row/column objects in the focus ancestry if they are part of a real table, as the cell will report the row/column info. This means that the entire contents of a table row is no longer sometimes reported when moving focus inside a cell  in Mozilla applications. (#482)

NVDA no longer fails to start if UI Automation support appears to be available but fails to initialise for some reason. (#483)

A report landmarks checkbox has been added to the Document formatting settings dialog, and a respective option in the ini file, which allows you to configure whether NVDA should announce landmarks in web documents.

NVDA no longer fails to start on a system with no audio output devices. Obviously, a braille display or the Display synthesiser will need to be used for output in this case. (#425)

Update what's new.

Merge main.

braille: Add Chinese (Hong Kong, Cantonese) table. Re #344.

braille: Add Finnish 8 dot computer braille table. Closes #450.

what's new: Add section for next release.

Merged virtualBufferClassProperty branch. This change allows individual NVDAObjects to choose whether or not they need a virtualBuffer, and which virtualBuffer class to use. Previously this code was hard-coded in virtualBufferHandler. AdobeAcrobat, Mozilla and MSHTML nvdaObjects all appropriatly choose their own respective virtualBuffer classes.

Document Mozilla IAccessible NVDAObject's virtualBufferClass property: also check to make sure this object is actually IAccessible2, so that it doesn't accidentily get used for Gecko 1.8 and below.

Merged main

IAccessible nvdaObject: remove code to handle live regions as its no longer needed (nvdaHelperRemote does this).

IAccessibleHandler: no longer listen for 'hide' winEvents, we do not make any use of them, and they just cause performance loss. Still listen to 'show' events, however route them through a new processShowWinEvent function, which only processes 'show' events for tooltip_class32 windows. This allows NVDA to still detect standard tooltips, but also greatly decreases the amount of 'show' events that need to be handled by NVDA. All this is now possible due to  code for live regions now existing in nvdaHelperRemote, rather than NVDA itself.

nvdaHelperRemote ia2 live region support: make use of ia2AttribsToMap from ia2utils to split out the IAccessible2 object attributes, so that the code can better manage 'relevant' and 'live' ARIA attributes. The code now supports detection and announcement of  live regions  that are polite, assertive and rude, and where relevant is additions or text (all and not set are also supported).

Moved ia2utils and debug out of vbufBase and in to a 'common' directory. This is necessary so that other parts of nvdaHelper can compile this code in to their own code.

nvdaHelperRemote now detects IAccessible2 live regions, and uses the nvdaController interface to speak them in NVDA. This code superseeds the old NVDA live region code.  The code is now in-process which means performance will be much improved for collecting live region text, and it also means that NVDA will no longer have to listen for 'show' winEvents, which was a large performance hit. This new code also fixes a bug where NVDA would only speak the last few live region updates -- now it should read all of them. Plus, there is much better support for other types of live region updates other than just 'additions'. Work still needs to be done for live regions not fully marked up (defaults).

nvdaHelperLocal: add missing rpc server and nvdaController stub code accidentilly not committed previously.

NVDA CD: UPdate for 2009.1.

nvdaHelper.nvdaController_speakText: queue speech.

nvdaHelperLocal:  an rpc server now exists, that publishes the nvdaController interface. The server stub code in c is very basic in that it just calls function pointers, which are set to Python functions, in nvdaHelper.py. nvdaHelper.py has so far implemented a speakText function. nvdaHelper.py also starts and stops nvdaHelperLocal's rpc server. All this means that  nvdaHelperRemote, or any other rpc client who has the nvdaController client stub can now make NVDA speak!

Added new nvdaController (this time with a double l) RPC interface in to the nvdaHelper code. It is not used as of yet, but  the interface for now  describes a getNVDAVersionString function, and a speakText function.

Removed old nvdaControler implementation. This was not well integrated in to NVDA, it will be replaced with code in nvdaHelper.

Brand new reworked czech user guide by Radek Zalud, Petra Laskova and friends.
Updated slovak user guide.

contributors: Remove web address for Wael Zakareya. Only email addresses should be included here unless the contributor is a company who chose to attribute the work to the company itself.

virtual buffers: Handle the case where programmaticScrollMayFireEvent is True and the document is scrolled by other means before NVDA has first scrolled it. Previously, this caused a TypeError exception. Fixes errors when, for example, hitting ctrl+pageDown in an Adobe Reader document before moving the virtual cursor.

Hopefully allow NVDA to function with no audio output device. (#425)

Updated german language strings for the NVDA installer and renamed some files as suggested,
Added what's new in czech,
Added what's new in finnish,
Updated czech language file, quick command keys,
Updated spanish language file, quick command keys and user guide,
Updated finish language file.

source readme: Mention that you need to copy the NSIS UAC.dll into the installer directory.

adobeAcrobat vbuf backend: Fix regression introduced in the nvdaHelper rewrite several months ago which caused dynamic updates to never be reflected in the buffer. Oops!

NVDAObjects can now choose whether they should use a virtualBuffer, and if so, what kind of virtualBuffer. NVDAObject.virtualBufferClass should be the virtualBuffer class the NVDAObject wants.  MSHTML, adobe.AcrobatNode and mozilla.Document all now implement the virtualBufferClass property, and provide  their respective virtualBuffer class if the object is in the right state. the base NVDAObject  raises NotImplementedError for virtualBufferClass. virtualBufferHandler.update now makes use of virtualBufferClass if it is implemented on the object given, and all its existing virtualBuffer choice code has been removed.

source readme: Add note for users on 64 bit Windows systems.

Added copying.txt in Hungarian,
Updated german documentation files converting them all into html,
updated slovak language file.

gecko_ia2 vbuf backend: Fix potential memory leaks when attempting to retrieve an IAccessible2 object. Previously, if QI to IServiceProvider failed (unlikely), the IAccessible wasn't released. Also, if QueryService failed (more likely), the IServiceProvider wasn't released.

In an Internet Explorer 6 combo box, the active item is now reported when it is changed. (#342)

 * Updated Russian language file and what's new document

Updated hungarian user guide, what's new,
Updated italian quick command keys,
Updated slovak what's new and readme.

service: NVDA should not touch the screen reader flag on secure desktops. Otherwise, it will be cleared when the secure desktop copy of NVDA exits, and since it is global, this means it will be cleared on the default desktop as well. Fixes #462.

winUser: Add getSystemScreenReaderFlag().

 * iAccessibleHandler.OrderedWinEventLimiter: remove retundant caching of UIA windows. Closes #469

what's new: Very minor linguistic correction.

Fixed a problem with date and time script (NVDA+F12). Date reporting was truncated on some systems. (Closes #471)

Updated finnish user guide,
Updated czech language file and quick command keys.

Apply the fix from r3362 to the QT4 treeview item as well.

iTunes appModule: fix up the regular expression that collects level, indexInGroup and similarItemsInGroup out of the accDescription of iTunes MSAA objects. Previously the plus symbol was on the soutside of the brackets containing the digit matching, which meant that it only ever collected a single digit in to the named groups. Now when moving around in iTunes (e.g. the sources treeview) NVDA correctly announces double figure levels/indexes etc. Does this also need to be fixed for QT?

logonui app module: Ensure that the top level pane is presented in Windows Vista/7 as well.

Do not use UIA for the CommonPlacesWrapperWndClass window found in Save dialogs and such. Due to some floors in the way NVDA deals with multiple APIs, this particular situation was causing NVDA to go in to  an endless loop in Save dialogs. This should hopefully stop this for now. The freeze was noticable on Systems that had installed the Platform Update for Vista/XP.

 * Updated Russian language file and what's new document; Updated Ukrainian language file, readme and key commands

  Updated the user guide with the mention arabic language is also available (sorry translators, this is really a minor thing worth noting),
      Updated arabic what's new,
      Updated slovak language file, user guide and what's new.

The NVDA error sound is no longer played in release candidates and final releases. Note that errors are still logged.

There was still one more occurence of GetThreadLocale in the NVDA installer. Changing that to GetUserDefaultUILanguage.

Updated galician user guide,
Updated arabic what's new,
Updated slovak user guide.

 * Updated Ukrainian language file

Added arabic language strings for the NVDA installer,
Added licence file in finnish,
Renamed ar locale folder to ar_sa in order to be properly recognized by gettext,
Updated arabic language file, user guide, what's new document, quick command keys and readme,
Corrected some typos in the english user guide,
Updated finnish language file, user guide, quick command keys,
Updated hungarian quick command keys,
Updated italian user guide,
Updated brazilian portuguese quick command keys,
Updated slovak language file, user guide, key commands and what's new.

NVDA can now fully access applications running as administrator in Windows Vista and later. You must install an official release of NVDA for this to work. This does not work for portable versions and snapshots. (#397)

Update what's new.

Merge main.

Update what's new.

Merged main

 * cut off the name for SysLink with ROLE_SYSTEM_LINK to the terminating null character. Fixes #451

Installer: like with the lib directory, also rename, and delete (perhaps on reboot) the lib64 directory if it exists. This stops an error in installers on 64-bit systems where the installer can not overwrite nvdaHelperRemote.dll.

 * Updated russian key commands ans what's new documents by Natalya Lastuhina

key commands document: Add missing review_markStartForCopy and review_copy commands.

what's new: Minor fixes.

service: Oops. Fix bad conflict resolution from last merge.

Use NVDAHelper.RemoteLoader64 for real.

NVDAHelper.RemoteLoader64:
* Don't use SECURITY_ATTRIBUTES to make the pipe inheritable, as this makes both handles (read and write) inheritable. This meant that closing the write handle in NVDA wasn't actually closing the pipe because the loader process still had an open write handle. Instead, use DuplicateHandle() on the read handle only.
* Make the nul handle inheritable using DuplicateHandle().
* Comment the code a bit.

Updated spanish user guide.

Added licence file in german,
Updated german language file, language strings for the NVDA installer, user guide, what's new document, readme file and quick command keys,
Updated spanish language file.