HeaderPane
Main
Hide
Share Link
Print

Accessibility (Screen Readers)

SftTabs/NET 3.0 includes built-in Windows UI Automation (UIA) support. Users who rely on Narrator, NVDA, JAWS or any other UIA-compatible assistive technology can read and navigate the control without the hosting application doing any work. There is no opt-in and no code change required.

What the screen reader sees:

ElementExposed as
Control typeTab. The control reports its selected tab, so screen readers announce the current tab when the control receives the input focus.
TabsEach visible tab is a tab item with its text as the name, its position among the tabs ("2 of 5"), its selection state and its enabled state. A mnemonic defined in the tab's text is reported as the tab's access key, and the tab's tooltip text (TabClass.ToolTip property) as its help text. Hidden tabs are not exposed.
Tab close buttonsEach tab close button is a button named after its tab, for example "Close Settings".
Scroll buttons / Close, Minimize and Restore buttonsExposed as buttons. A button is named by its tooltip text; a button without a tooltip text has a default name, such as "Scroll Left" or "Close".
Tab pagesThe tab pages and the controls they host are regular Windows Forms controls, which are exposed to screen readers by Windows Forms.

Screen readers can also select tabs, scroll a tab into view and click the buttons. These actions work like the equivalent mouse and keyboard actions, so the control's events, such as Switching, Switched and TabCloseButtonClicked, occur as usual.

Changes are reported to screen readers automatically: focus and selection changes, tabs added and removed, and changes to the text of tabs. The provider is created the first time a UI Automation client asks for it, so there is no overhead for applications whose users never run assistive technology.

What the application controls:

  • Set the control's AccessibleName property to a name describing the tab control's content, for example "Settings". The AccessibleDescription property becomes the control's help text.
  • Define tooltip texts for the buttons the control shows, in the language of the application. They become the names of the buttons. The tooltip text of the tab close buttons (SftTabs.TabCloseButtonToolTip property) replaces the word "Close" in their names.
  • Call the Announce method to push short status messages ("Changes saved", "3 tabs closed") to screen readers. Announce is the right tool for momentary status updates that are not otherwise visible in the tab control.

Dark mode and Windows High Contrast are independent accessibility settings. See Dark Mode and High Contrast.