SftBox/DLL 6.0 ships with built-in Windows UI Automation (UIA) support. Users who rely on Narrator, NVDA, JAWS or any other UIA-compatible assistive technology can read and operate combo box controls without the hosting application doing any work. No opt-in, no code change, no separate build.
What the screen reader sees:
| Control type | Combo box, with the child elements described below. |
| Name | The text of the static control (label) which precedes the combo box in the dialog, as for a standard Windows combo box. An ampersand used to define an accelerator key is removed. |
| Value | The window text of the combo box: the text of the edit control portion or, in a dropdown list combo box, the text of column 0 of the selected item. The value can be set if the combo box has an edit control portion which is not read-only (see SetReadOnly), otherwise it is reported as read-only. |
| Edit | The edit control portion of a simple or dropdown combo box is exposed as an Edit element. |
| List | The dropdown portion is exposed as a List element. It is reported as off-screen while the dropdown portion is hidden. |
| Items | Each item is a List item element of the list. Its name is the cell text of all columns, in display order. An item reports its level in the hierarchy, its position, whether it is selected and, for an item with dependent items, whether it is expanded or collapsed. Items that are not shown because their parent item is collapsed are not exposed. |
| Dropdown button | The dropdown button of a dropdown or dropdown list combo box is exposed as a Button element named "Open" or "Close". Invoking it shows or hides the dropdown portion. |
| Patterns implemented | Combo box: Value, Selection, ExpandCollapse (dropdown and dropdown list combo boxes; shows and hides the dropdown portion). Edit: Value. List: Selection. List item: SelectionItem, ScrollItem, ExpandCollapse (items with dependent items). Dropdown button: Invoke. |
Event notifications raised automatically: keyboard focus changed, value changed (text entered, another item selected), item selected, dropdown portion shown or hidden, items added or removed.
A screen reader can select an item, scroll it into view, expand or collapse it and show or hide the dropdown portion. Selecting an item through UI Automation is equivalent to SetCurSel and sends the SFTBOXN_SELCHANGE notification.
There is nothing to turn on. The provider loads on demand the first time a UIA client queries the control, so there is no overhead for applications whose users never attach an assistive technology.
The main thing the application controls is the label - screen readers read it first. Place a static control with a descriptive text immediately before the combo box in the dialog (in tab order), as is customary for an accelerator key. Without it, the combo box announces itself using its control ID only.
Dark mode (the Windows "Choose your mode" setting) and Windows High Contrast (an accessibility setting) are independent. A combo box follows them once SetDarkMode is called with SFTBOX_DARKMODE_AUTO and SetHighContrastMode is called with SFTBOX_HIGHCONTRAST_AUTO (see Dark Mode and High Contrast).