Skip to content

If command for report the note on the current Excel cell pressed twice, presents the information in browse mode#15986

Closed
tseykovets wants to merge 4 commits into
nvaccess:masterfrom
tseykovets:excel_note_in_browse_mode
Closed

If command for report the note on the current Excel cell pressed twice, presents the information in browse mode#15986
tseykovets wants to merge 4 commits into
nvaccess:masterfrom
tseykovets:excel_note_in_browse_mode

Conversation

@tseykovets

@tseykovets tseykovets commented Dec 30, 2023

Copy link
Copy Markdown
Contributor

Link to issue number:

This is a minor change that improves one command for Microsoft Excel.

Summary of the issue:

The text of cell notes often contains important voluminous information that is difficult to perceive in the mode of pronouncing a full phrase.

This pull request adds the ability to present the text of a note in browse mode by pressing command twice (NVDA+Alt+C).

Description of user facing changes

The previously existing command for Microsoft Excel (NVDA+Alt+C) gained additional functionality when it is pressed twice.

Description of development approach

  • A handler for the number of presses has been added to the script (if repeats).
  • If pressed twice, presents the information in browse mode (ui.browseableMessage).

Testing strategy:

To test, just press the NVDA+Alkt+C command twice on the cell with the note.

The changes do not contain new code to interact with the operating system and Excel application.

Known issues with pull request:

No issues known.
Since the change does not contain new code to interact with the operating system and Excel application, it is not expected to affect any other functionality of NVDA.

Code Review Checklist:

  • Documentation:
    • Change log entry
    • User Documentation
    • Developer / Technical Documentation
    • Context sensitive help for GUI changes
  • Testing:
    • Unit tests
    • System (end to end) tests
    • Manual testing
  • UX of all users considered:
    • Speech
    • Braille
    • Low Vision
    • Different web browsers
    • Localization in other languages / culture than English
  • API is compatible with existing add-ons.
  • Security precautions taken.

@AppVeyorBot

Copy link
Copy Markdown

See test results for failed build of commit 66df28d83b

@Adriani90

Copy link
Copy Markdown
Collaborator

I think this is not needed. Nvda has already its own handler for these notes and the nvda specific dialog with the coresponding note can be invoked with shift+f2 when focusing the relevant cell. See the MS Excel app module for more details. In this proposed change is a downgrade to the current behavior and most people will use shift+f2 because there you can even edit the note.

@cary-rowen

Copy link
Copy Markdown
Contributor

Thank you very much, this is a feature I'm thinking of implementing, good job, please continue.
Please note, that there is a feature request #14628.
You can update the description of this PR.

@cary-rowen

Copy link
Copy Markdown
Contributor

@Adriani90

I think this is not needed. Nvda has already its own handler for these notes and the nvda specific dialog with the coresponding note can be invoked with shift+f2 when focusing the relevant cell. See the MS Excel app module for more details. In this proposed change is a downgrade to the current behavior and most people will use shift+f2 because there you can even edit the note.

For consistency, if #15987 is acceptable, then this PR should also be accepted.

@seanbudd seanbudd added the conceptApproved Similar 'triaged' for issues, PR accepted in theory, implementation needs review. label Jan 1, 2024
Comment thread source/NVDAObjects/window/excel.py Outdated
Comment thread user_docs/en/changes.t2t Outdated
Comment thread user_docs/en/userGuide.t2t Outdated
@seanbudd

seanbudd commented Jan 2, 2024

Copy link
Copy Markdown
Member

Please note the linting error, repeat is not definied

@seanbudd

seanbudd commented Jan 2, 2024

Copy link
Copy Markdown
Member

did you test this? i'm not sure how this code would succeed

@seanbudd seanbudd marked this pull request as draft January 2, 2024 02:05
@AppVeyorBot

Copy link
Copy Markdown

See test results for failed build of commit a266137b50

@seanbudd

seanbudd commented Jan 2, 2024

Copy link
Copy Markdown
Member

Have you tested this? Is it ready for re-review? If so, mark the PR as "ready for review" so it is no longer in draft state.

@tseykovets tseykovets marked this pull request as ready for review January 8, 2024 19:15
@seanbudd

seanbudd commented Jan 8, 2024

Copy link
Copy Markdown
Member

have you tested this? please do not mark as ready for review if you have not tested this.

@seanbudd seanbudd marked this pull request as draft January 8, 2024 23:41

@Qchristensen Qchristensen left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

User guide reads well. The changes.txt text seems cumbersome to me - I would perhaps say:

  • Excel: When "report any notes for the currently focused cell" (NVDA+alt+c) is pressed twice, the information is shown in a window. (#15986, @tseykovets)

@Adriani90

Copy link
Copy Markdown
Collaborator

@tseykovets are you still working on this?

@tseykovets

Copy link
Copy Markdown
Contributor Author

@Adriani90, it seems to me that I have implemented everything that is needed.
I would appreciate testing and information if something is wrong.

@hwf1324

hwf1324 commented Mar 30, 2024

Copy link
Copy Markdown
Contributor

@tseykovets If everything is ready, switch the status of the PR from Draft to "ready for review". so that NV Access personnel can review your PR.

When you think a contribution is ready, or you would like feedback, open a draft pull request. When you would like a review, mark the PR as "ready for review".

@seanbudd

seanbudd commented Mar 30, 2024

Copy link
Copy Markdown
Member

As requested three times previously, have you tested this? please do not mark as ready for review if you have not tested this.
You are expected to test your work when making a code contribution.

@Adriani90

Copy link
Copy Markdown
Collaborator

@tseykovets you need to solve the conflicts also in this PR, otherwise we cannot download a build with this PR to test.
Is it too difficult for you to test it yourself? Or what is the reason you didn't test it when raising this pull request?

@Adriani90

Copy link
Copy Markdown
Collaborator

@tseykovets are you still working on this? Or should we close this as abandoned?

@tseykovets

Copy link
Copy Markdown
Contributor Author

At the end of 2023, I considered the implementation from this pull request to be complete and debugged.
However, I don't know how true this is for the current state of the master branch.
At the moment, I do not have the opportunity to quickly test the implementation, since I do not have a computer at hand with a configured environment for the local build of NVDA.
If someone undertakes to check the relevance of the implementation from this pull request, then I will be grateful for such help.

@XLTechie

XLTechie commented May 17, 2024 via email

Copy link
Copy Markdown
Collaborator

@gerald-hartig

Copy link
Copy Markdown
Contributor

As @seanbudd mentioned, PRs can only move from draft to ready status once testing has been successfully completed. Thorough testing is crucial to maintain the integrity and functionality of NVDA and is part of our Contribution Process (https://github.com/nvaccess/nvda/blob/master/projectDocs/dev/contributing.md#overview-of-contribution-process). We strongly advise authors to test their own code but if the author is unable to do the testing, collaboration with someone in the community to carry out that testing is then essential.

If for some reason before you start you know that you cannot carry out the testing, we advise you find someone who can do the testing before you write your first line of code. You can use the issue ticket for this purpose, or reach out to the development community in one of the user/developer groups.

For this PR, if no one is available to assist with the testing, we may need to consider closing this PR until testing can be completed.

@seanbudd

Copy link
Copy Markdown
Member

Closing as abandoned

@seanbudd seanbudd closed this Jun 17, 2024
@seanbudd seanbudd added the Abandoned requested reports or updates are missing since more than 1 year, author or users are not available. label Jun 17, 2024
seanbudd pushed a commit that referenced this pull request Jul 18, 2024
…ontent in browsable message. (#16878)

Fixed #14628
Replaces abandoned #15986
Thanks to @tseykovets for most of the work.

Summary of the issue:
Sometimes the text of comment is too long, in order to understand, we may need to navigate by sentence or by word.

Description of user facing changes
This pull request adds the ability to present the text of a comment in browse mode by pressing command twice (NVDA+Alt+C).

Description of development approach
A handler for the number of presses has been added to the script (if repeats).
If pressed twice, presents the information in browse mode (ui.browseableMessage).
Additionally, I added a type hint for the gestures.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Abandoned requested reports or updates are missing since more than 1 year, author or users are not available. conceptApproved Similar 'triaged' for issues, PR accepted in theory, implementation needs review.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants