Test Plan

Useful commands
Mac
VO+F3 to describe (VO cursor)
VO+F4 to describe (keyboard)
VO+F5 to describe (mouse)
VO+Shift+F5 moves VO cursor to control under the mouse
VO+Space primary action
VO+Shift+N help
VO+Arrows move VO Cursor around siblings
VO+Shift Arrows move VO Cursor parent/child

Win
CL+Space primary action
CL+D describe
CL+F describe advance (help)
CL+Arrows move Narrator cursor around
CL+F2 list of commands (for the given item)
CL+F1 list of all commands

Reads: title + role description.
Ex.: "Click me, button"

Commands:
Primary action fires the button.

Reads: title + state + role description.
Ex. Mac: "Indeterminate CheckBox, mixed, checkbox"
Ex. Win: "Indeterminate CheckBox, indeterminate, checkbox"

Commands:
Primary action changes states.

Notes:
State names on Mac: checked, mixed, unchecked.
State names on Win: checked, indeterminate, unchecked.
Changes to the state are read by the screenreader as they happen.

Reads: current item + role description
Ex. Mac: "Leia Organa, pop up button"
Ex. Win: "Leia Organa, editable combo box, collapsed"

Commands:
Primary action opens the menu
Win: CL+F2->Expand

Notes:
When the menu is open each option is read when it is selected. Spacebar to confirm selection.
HelloChoiceBox starts with control without the selection,
only the role is read in this case, that is standard behavior.
Win: A bit weird it says 'editable' but that is what native combos do.
Win7: Reads the number of item in the list (wrongly at times, RT-37792).

Reads: current item + role description
Ex. Mac: "Prompting you here, pop up button" for readonly
Ex. Mac: "Option 2, combo box" for editable
Ex. Win: "Prompting you here, read only combo box" for readonly
Ex. Mac: "Option 2, editable combo box" for editable

Commands:
Primary action opens the menu.
Win: CL+F2->Expand works.

Notes:
F4 opens the menu.
When the menu is open each option is read when it is selected. Spacebar to confirm selection.
Win7: Reads the number of item in the list (wrongly at times, RT-37792).

Reads (on open): "menu (count items)"
Ex. Mac: "menu (5 items)"
Ex. Win: "menu"
Reads (traversing items): item's title + state. Including:
submenu, checked, dimmed (disabled), accelerators, mnemonic (windows only)

Notes:
Win: does not read the count of items when the menu opens
Mac: using VO+Shift+M on the button opens menu
Mac: if Mouse Keys are enabled (in System Preferences), then Control+Shift+numpad5 opens the context menu
for the control under the mouse.  

Reads: state + title + role description.
Ex.: "visited, I am a hyperlink, link"

Commands:
Primary action fires the link.

Notes:
Visited is only read for visited links.
Win: never says visited.

Read labels + control
Ex. Win: "secret name:, password field"
Ex. Mac: "secret name:, secure text"

Notes:
Label are not focusable and usually read by the screenreader when
set as 'label for' to another control.
Using the screenreader traversal keys label can be read independently.
Win7: not reading (please retest).

Reads:
Mac: item's label + role description + row_index of row_count
Ex.: JavaFX item7 + text + row 8 of 128
Win: item's label + state + column_index row_index
Ex.: JavaFX item7 + selected + column 1 row 8

Notes:
Mac: The exact order the description is read depends if the screenreader is interacting
with the list of the item directly. Extra information such as selected is read at times.
On Windows using the screenreader to change the focused item will not changed the selection
therefore it will read 'unselected' for unselected items. Mac seems to update the selection
along with the focus item.
Win7 rarely reads back (please retest).
TableView commands are likely available to the List, added bonus.

Reads: title + role description.
Ex. Mac: "MenuButton, menu button"
Ex. Win: "MenuButton, button"

Commands:
Primary action (or space) open the menu.

Notes:
When the menu is open each option is read when it is selected. Spacebar to confirm selection.
Mac, menu not always responsive when opened using primary action.

Reads: title + state + role description.
Ex. Mac: "SpliMenuButton1, split button"
Ex. Win: "SpliMenuButton1, collapsed, split button"

Commands:
Primary action (or space) fires the button.
Win: CL+F2->Activate fires the button, CL+F2->Expand opens the menu.
Mac: VO+Shift+M opens menu.

Notes:
Arrow down open the menu.
When the menu is open each option is read when it is selected. Spacebar to confirm selection.
The correct 'arrow key' to open the menu depends on the direction the button graphical
arrows is pointing (test using 'Popup side' on HelloMenuButton.java). See RT-37987.

Reads: title + state + role description + index of count
Ex. Mac: "7, selected, page 7 of 10"
Ex. Win: "7 page selected"

Notes:
Win7: off by one (please retest).
Win: does not read 'index of count'
Mac: the index of count is based on visual content.
Using the screenreader traversal keys is possible to read the next and close button.
This buttons can be fired using the primary action.

Reads:
Ex. Win: "secret name:, password field"
Ex. Mac: "secret name:, secure text"

Notes:
It should not reveal the password.

Reads: percentage + role description
Ex. Mac: "25% percent, progress indicator"
Ex. Mac: "indeterminate, progress indicator" for indeterminate
Ex. Win: "25% percent, progress bar"

Notes:
ProgressBar do not take focus, to test set Narrator Settings to
'Read and interact with the screen using the mouse'.
On the Mac using VO+arrow can be used to selected these controls.
Win: reads 0% for indeterminate progress (same as the native progress bar).
Win7: not working (please retest)

Reads: title + state + role description
Ex.: "Luke, *I* am your father, selected, radio button"

Commands:
Primary action fires the button (selected an unselected radio)

Notes:
Changes to the state are read by the screenreader as they happen. 

Mac Reads: orientation + role description
Ex. Mac: vertical scroll bar
Win Reads: role description 'at' percentage
Ex. Win: scroll bar at 0%

Notes:
Windows allows interacting with the increment and decrement buttons, primary action
will move the thumb (and adjust the value) properly.
See ScrollPane for more details on the overall scrolling capability on JavaFX.

NOT IMPLEMENTED, NO SCROLLING

Proper scrolling is only implemented on Windows for ListView, TableView, TreeView, and
TreeTableView.

Reads: percentage + role description
Ex.: 50% slider

Notes:
Arrows change the value, changes are read by the screenreader

Reads: title + role description
Ex. Mac: 5, stepper
Ex. Win: 5, Spinner

Commands:
Mac: VO+Arrow up and down change the value.
Win: CL+Left Arrow till it reaches the increment or decrement button,
then use primary action for the button.

Notes:
Changes made using the arrow buttons are reported by screenreader.

Reads:
Mac
Reading depends on how the cells are traversed
By Row: title + column index + row index
Ex.: Item 7, column 1, row 8
By Column: column's title + title + column index + row index
Ex.: Email Item10@oracle.com, column 2, row 11 cell
VO+F3:
Item 7, column 1, row 8 cell Name row 8 of 128
Win:
Read tile + state + column + row
Ex.: Item5, selected, column Name, Row 6
(if column header is available its used is used instead of the index)

Commands:
Mac:
Work: VO-C (read column name), VO-Shift-T (read row and column)
Do not work: VO-R (read row), VO-C-C (read column), VO-| (sort column)

Win:
Works: CL+F3, CL+Shift+F3, CL+F4, CL+Shift+F4, CL+F5, CL+F6, CL+F7, CL+F8, CL+F9, CL+F10

Notes:
On a empty table the place holder should be read.
On Windows using the screenreader to change the focused item will not changed the selection
therefore it will read 'unselected' for unselected items. Mac seems to update the selection
along with the focus item.

Reads: title + state + role description + index of count
Ex. Mac: Longer Tab, selected, tab, 2 of 4
Ex. Win: Longer Tab, tab, selected

Notes:
Win: does not read 'index of count'
Mac: the index and count are based on visual content.

Reads:
Mac text + state + label + role description
Ex. Mac: "Hello JavaFX Accessiblity, contents selected, name, edit text"
Ex. Win: "Name, editing explorable text, Hello JavaFX Accessiblity"

Basic reads:
Char next/previous (left/right arrow) it reads the char.
Word next/previous (cmd left/right arrow) it reads the word.
Line next/previous (up/down arrow) it reads the word.
Every time the selection changes it reads.
Typing reads the key typed, reads the whole word after a space. (FIX on YOSEMITE)

Commands:
See 'Text commands' on https://www.apple.com/voiceover/info/guide/_1131.html
Excepted by 'Jump to a hot spot in text' everything is working. All the char/word/sentence/paragraph
navigation works. But note that VO must be interacting with the text, that means using VO+Shift+Arrow down
on the text control after the initial focus.
Win: Caret navigation is broken!

Notes:
"name" is the labeled by.
the role description is "edit text" for editable text and "text" for read only text.

Reads: title + state + role description
Ex. Mac: Label 3, collapsed, title pane
Ex. Win: Label 3, title pane, collapsed

Commands:
Primary action (or space) will collapse or expand the pane

Reads: title + state + role description
Ex. Mac: Luke, *I* am your father, checked, checkbox
Ex. Win: Luke, *I* am your father, button on

Commands:
Primary action changes states.

Notes:
State names on Mac: checked, unchecked.
State names on Win: on, off
Changes to the state are read by the screenreader as they happen.

Screenreader reads the button independently, make sure the overflow button is can be reached
and expanded.

The textual content in the tooltip is used to provide help' on a control.

Commands:
On Mac, to read the help tag use VO+Shift+N
On Win, to read the help tag use CL+F

Reads:
Mac: title + [collapsed|expanded, N items enclosed] + level N
collapsed|expanded only read for non-leaf items
level only read when changing the level
Ex: Child node 0, expanded 5 items enclosed, level 1
VO+F3:
Child node 3, text row 10 of 371
Right arrow, expand: event: "5 row added, row 10 expanded"
Left arrow, collapse: event: "row 10 collapsed"

Win: title + [collapsed|expanded|leaf node] + INDEX of COUNT
INDEX of COUNT is relative to the branch, and only read if the branch is not too large
Ex. sub item 0 0, leaf node, 1 of 5.
Right arrow, expand: event: "expanded"
Left arrow, collapse: event: "collapsed"

Commands:
Mac: VO+\ to expand/collapse
Win: CL+F2 Collapse, Expand.

Notes:
Mac provides different information depending if the screenreader is interacting to the tree
or to the tree item.
On Windows using the screenreader to change the focused item will not changed the selection
therefore it will read 'unselected' for unselected items. Mac seems to update the selection
along with the focus item.

Reads:
Mac:
Reading depends on how the cells are traversed
By Row: same as tree
By Column: same as table
VO+F3: same as table
Right arrow, expand: event: "5 row added, row 10 expanded"
Left arrow, collapse: event: "row 10 collapsed"

Win:
Read tile + selected state + column + row + expand state
Ex.: Child node 0, selected, column Name, Row 2, expanded
(if column header is available its used is used instead of the index)
Right arrow, expand: event: *nothing*
Left arrow, collapse: event: *nothing*

Commands:
Mac:
Work: VO-C (read column name), VO-Shift-T (read row and column)
Do not work: VO-R (read row), VO-C-C (read column), VO-| (sort column)
VO+\ to expand/collapse

Win:
CL+F3, CL+Shift+F3, CL+F4, CL+Shift+F4, CL+F5, CL+F6, CL+F7, CL+F8, CL+F9, CL+F10.
CL+F2 Collapse, Expand.

Notes:
On Windows using the screenreader to change the focused item will not changed the selection
therefore it will read 'unselected' for unselected items. Mac seems to update the selection
along with the focus item.