.\" Automatically generated by Pandoc 3.6.4
'\"
'\" Copyright (c) 2025 Kevin Walzer
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
.TH tk accessible n "" Tk "Tk Built-In Commands"
.\" The -*- nroff -*- definitions below are for supplemental macros used
.\" in Tcl/Tk manual entries.
.\"
.\" .AP type name in/out ?indent?
.\"	Start paragraph describing an argument to a library procedure.
.\"	type is type of argument (int, etc.), in/out is either "in", "out",
.\"	or "in/out" to describe whether procedure reads or modifies arg,
.\"	and indent is equivalent to second arg of .IP (shouldn't ever be
.\"	needed;  use .AS below instead)
.\"
.\" .AS ?type? ?name?
.\"	Give maximum sizes of arguments for setting tab stops.  Type and
.\"	name are examples of largest possible arguments that will be passed
.\"	to .AP later.  If args are omitted, default tab stops are used.
.\"
.\" .BS
.\"	Start box enclosure.  From here until next .BE, everything will be
.\"	enclosed in one large box.
.\"
.\" .BE
.\"	End of box enclosure.
.\"
.\" .CS
.\"	Begin code excerpt.
.\"
.\" .CE
.\"	End code excerpt.
.\"
.\" .VS ?version? ?br?
.\"	Begin vertical sidebar, for use in marking newly-changed parts
.\"	of man pages.  The first argument is ignored and used for recording
.\"	the version when the .VS was added, so that the sidebars can be
.\"	found and removed when they reach a certain age.  If another argument
.\"	is present, then a line break is forced before starting the sidebar.
.\"
.\" .VE
.\"	End of vertical sidebar.
.\"
.\" .DS
.\"	Begin an indented unfilled display.
.\"
.\" .DE
.\"	End of indented unfilled display.
.\"
.\" .SO ?manpage?
.\"	Start of list of standard options for a Tk widget. The manpage
.\"	argument defines where to look up the standard options; if
.\"	omitted, defaults to "options". The options follow on successive
.\"	lines, in three columns separated by tabs.
.\"
.\" .SE
.\"	End of list of standard options for a Tk widget.
.\"
.\" .OP cmdName dbName dbClass
.\"	Start of description of a specific option.  cmdName gives the
.\"	option's name as specified in the class command, dbName gives
.\"	the option's name in the option database, and dbClass gives
.\"	the option's class in the option database.
.\"
.\" .UL arg1 arg2
.\"	Print arg1 underlined, then print arg2 normally.
.\"
.\" .QW arg1 ?arg2?
.\"	Print arg1 in quotes, then arg2 normally (for trailing punctuation).
.\"
.\" .PQ arg1 ?arg2?
.\"	Print an open parenthesis, arg1 in quotes, then arg2 normally
.\"	(for trailing punctuation) and then a closing parenthesis.
.\"
.\"	# Set up traps and other miscellaneous stuff for Tcl/Tk man pages.
.if t .wh -1.3i ^B
.nr ^l \n(.l
.ad b
.\"	# Start an argument description
.de AP
.ie !"\\$4"" .TP \\$4
.el \{\
.   ie !"\\$2"" .TP \\n()Cu
.   el          .TP 15
.\}
.ta \\n()Au \\n()Bu
.ie !"\\$3"" \{\
\&\\$1 \\fI\\$2\\fP (\\$3)
.\".b
.\}
.el \{\
.br
.ie !"\\$2"" \{\
\&\\$1	\\fI\\$2\\fP
.\}
.el \{\
\&\\fI\\$1\\fP
.\}
.\}
..
.\"	# define tabbing values for .AP
.de AS
.nr )A 10n
.if !"\\$1"" .nr )A \\w'\\$1'u+3n
.nr )B \\n()Au+15n
.\"
.if !"\\$2"" .nr )B \\w'\\$2'u+\\n()Au+3n
.nr )C \\n()Bu+\\w'(in/out)'u+2n
..
.AS Tcl_Interp Tcl_CreateInterp in/out
.\"	# BS - start boxed text
.\"	# ^y = starting y location
.\"	# ^b = 1
.de BS
.br
.mk ^y
.nr ^b 1u
.if n .nf
.if n .ti 0
.if n \l'\\n(.lu\(ul'
.if n .fi
..
.\"	# BE - end boxed text (draw box now)
.de BE
.nf
.ti 0
.mk ^t
.ie n \l'\\n(^lu\(ul'
.el \{\
.\"	Draw four-sided box normally, but don't draw top of
.\"	box if the box started on an earlier page.
.ie !\\n(^b-1 \{\
\h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
.\}
.el \}\
\h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\l'|0u-1.5n\(ul'
.\}
.\}
.fi
.br
.nr ^b 0
..
.\"	# VS - start vertical sidebar
.\"	# ^Y = starting y location
.\"	# ^v = 1 (for troff;  for nroff this doesn't matter)
.de VS
.if !"\\$2"" .br
.mk ^Y
.ie n 'mc \s12\(br\s0
.el .nr ^v 1u
..
.\"	# VE - end of vertical sidebar
.de VE
.ie n 'mc
.el \{\
.ev 2
.nf
.ti 0
.mk ^t
\h'|\\n(^lu+3n'\L'|\\n(^Yu-1v\(bv'\v'\\n(^tu+1v-\\n(^Yu'\h'-|\\n(^lu+3n'
.sp -1
.fi
.ev
.\}
.nr ^v 0
..
.\"	# Special macro to handle page bottom:  finish off current
.\"	# box/sidebar if in box/sidebar mode, then invoked standard
.\"	# page bottom macro.
.de ^B
.ev 2
'ti 0
'nf
.mk ^t
.if \\n(^b \{\
.\"	Draw three-sided box if this is the box's first page,
.\"	draw two sides but no top otherwise.
.ie !\\n(^b-1 \h'-1.5n'\L'|\\n(^yu-1v'\l'\\n(^lu+3n\(ul'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
.el \h'-1.5n'\L'|\\n(^yu-1v'\h'\\n(^lu+3n'\L'\\n(^tu+1v-\\n(^yu'\h'|0u'\c
.\}
.if \\n(^v \{\
.nr ^x \\n(^tu+1v-\\n(^Yu
\kx\h'-\\nxu'\h'|\\n(^lu+3n'\ky\L'-\\n(^xu'\v'\\n(^xu'\h'|0u'\c
.\}
.bp
'fi
.ev
.if \\n(^b \{\
.mk ^y
.nr ^b 2
.\}
.if \\n(^v \{\
.mk ^Y
.\}
..
.\"	# DS - begin display
.de DS
.RS
.nf
.sp
..
.\"	# DE - end display
.de DE
.fi
.RE
.sp
..
.\"	# SO - start of list of standard options
.de SO
'ie '\\$1'' .ds So \\fBoptions\\fR
'el .ds So \\fB\\$1\\fR
.SH "STANDARD OPTIONS"
.LP
.nf
.ta 5.5c 11c
.ft B
..
.\"	# SE - end of list of standard options
.de SE
.fi
.ft R
.LP
See the \\*(So manual entry for details on the standard options.
..
.\"	# OP - start of full description for a single option
.de OP
.LP
.nf
.ta 4c
Command-Line Name:	\\fB\\$1\\fR
Database Name:	\\fB\\$2\\fR
Database Class:	\\fB\\$3\\fR
.fi
.IP
..
.\"	# CS - begin code excerpt
.de CS
.RS
.nf
.ta .25i .5i .75i 1i
..
.\"	# CE - end code excerpt
.de CE
.fi
.RE
..
.\"	# UL - underline word
.de UL
\\$1\l'|0\(ul'\\$2
..
.\"	# QW - apply quotation marks to word
.de QW
.ie '\\*(lq'"' ``\\$1''\\$2
.\"" fix emacs highlighting
.el \\*(lq\\$1\\*(rq\\$2
..
.\"	# PQ - apply parens and quotation marks to word
.de PQ
.ie '\\*(lq'"' (``\\$1''\\$2)\\$3
.\"" fix emacs highlighting
.el (\\*(lq\\$1\\*(rq\\$2)\\$3
..
.\"	# QR - quoted range
.de QR
.ie '\\*(lq'"' ``\\$1''\\-``\\$2''\\$3
.\"" fix emacs highlighting
.el \\*(lq\\$1\\*(rq\\-\\*(lq\\$2\\*(rq\\$3
..
.\"	# MT - "empty" string
.de MT
.QW ""
..
.BS
.SH NAME
accessible \- Adds screenreader support for core Tk and ttk  widgets.
.SH SYNOPSIS
.nf
\fBtk accessible set_acc_role \fIwindow value\fR
\fBtk accessible set_acc_name \fIwindow value\fR
\fBtk accessible set_acc_description \fIwindow value\fR
\fBtk accessible set_acc_value \fIwindow value\fR
\fBtk accessible set_acc_state \fIwindow value\fR
\fBtk accessible set_acc_action \fIwindow value\fR
\fBtk accessible set_acc_help \fIwindow value\fR
\fBtk accessible get_acc_role \fIwindow \fR
\fBtk accessible get_acc_name \fIwindow\fR
\fBtk accessible get_acc_description \fIwindow\fR
\fBtk accessible get_acc_value \fIwindow \fR
\fBtk accessible get_acc_state \fIwindow\fR
\fBtk accessible get_acc_action \fIwindow \fR
\fBtk accessible get_acc_help \fIwindow\fR
\fBtk accessible add_acc_object \fIwindow\fR
\fBtk accessible emit_selection_change \fIwindow\fR
\fBtk accessible emit_focus_change \fIwindow\fR
\fBtk accessible check_screenreader\fR
.fi
.BE
.SH DESCRIPTION
.PP
The \fBtk accessible\fR command makes core Tk and ttk widgets
accessible to a screen reader.
.BE
.SH INTRODUCTION
.PP
All major computing platforms provide one or more API's to make GUI
applications accessible to visually-impaired users who work using screen
reader tools.
Screen readers provide auditory feedback to users of a GUI application,
and may provide additional or alternative methods to navigating
GUI's apart from standard keyboard navigation.
The \fBtk accessible \fRcommand layers a platform neutral API on top
of platform-specific API's to support accessibility on Linux/Unix,
macOS, and Windows.
.PP
The \fBtk accessible\fR command is intended to provide a basic
accessible-out-of-the-box experience for end users and
requires little additional work by developers.
If a screen reader is in operation, Tcl/Tk applications will be
accessible.
The \fBtk accessible \fRcommand set does allow for additional
customization on the part of developers.
And widgets that are not part of the core Tk widget set can enable
accessibility by using the tk accessible command set to specific the
accessible role, name, description, value, state (if applicable), and
action (if applicable).
.SH OPERATIONS
.PP
The following operations are available for the \fBtk accessible\fR
command:
.TP
\fBtk accessible set_acc_role \fIwindow value\fR
.
Assigns one of the following accessibility roles to a Tk widget: Button,
Canvas, Checkbutton, Combobox, Entry, Label, Listbox, Menu, Notebook,
Progressbar, Scale, Scrollbar, Spinbox, Table, Text, and Tree.
Tk and ttk widgets having similar roles, such as a button and a
ttk::button, will both be assigned the same accessibility role as these
widgets are the same from an accessibility standpoint.
.TP
\fBtk accessible set_acc_name \fIwindow value\fR
.
Short label identifying the widget.
Defaults to the accessibility role.
.TP
\fBtk accessible set_acc_description\fI window value\fR
.
Longer string providing additional detail about the widget.
Depending on the widget, may default to returning the widget's -text
option or some similar detail.
.TP
\fBtk accessible set_acc_value \fIwindow value\fR
.
Sets the widget's accessibility value.
For instance, with a scale widget, will return the current numeric value
of the scale.
.TP
\fBtk accessible set_acc_state \fIwindow value\fR
.
\fI \fRSets the widget's accessibility state, from one of the
standard Tk widget states.
.TP
\fBtk accessible set_acc_action \fIwindow value\fR
.
\fI \fRSets the command associated with the widget, if any.\fI
\fR
.TP
\fBtk accessible set_acc_help \fIwindow value\fR
.
String providing additional information on the widget and its purpose.
For instance, can provide details on specific keyboard navigation for
the widget.
.TP
\fBtk accessible get_acc_role \fIwindow \fR
.
Returns the widget's accessibility role.
.TP
\fBtk accessible get_acc_name \fIwindow\fR
.
Returns the widget's accessibility name.
.TP
\fBtk accessible get_acc_description \fIwindow\fR
.
Returns the widget's accessibility description.
.TP
\fBtk accessible get_acc_value \fIwindow \fR
.
Returns the widget's accessibility value.
.TP
\fBtk accessible get_acc_state \fIwindow\fR
.
Returns the widget's accessibility state.
.TP
\fBtk accessible get_acc_action \fIwindow \fR
.
Returns the widget's accessibility action.
.TP
\fBtk accessible get_acc_help \fIwindow\fR
.
Returns the widget's accessibility help.\fI \fR
.TP
\fBtk accessible add_acc_object \fIwindow\fR
.
Registers the widget with the platform's accessibility API and
enables accessibility for the widget.
.TP
\fBtk accessible emit_selection_change \fIwindow\fR
.
Notifies the system when selection, value or other data associated with
the widget changes.
.TP
\fBtk accessible emit_focus_change \fIwindow\fR
.
Notifies the accessibility system when focus changes.
.TP
\fBtk accessible check_screenreader\fR
.
Checks to see if the system is running a screen reader or other
accessibility process.
.PP
.SH ADDITIONAL NOTES
.PP
Some Tk GUI components, such as frames and panedwindows, are not
included in the accessibility API because they are just containers and
do not handle actions or data.
Also, the canvas is not included in the accessibility API because it is
a purely visual widget; the HTML5 canvas widget is not accessible to web
API's for the same reason.
Developers may choose to provide alternative data to provide information
on the canvas widget, such as labels or help text. Finally,
accessibility only runs in the main Tk interpreter, because of
potential conflicts in child interpreters; also, accessibility is not
supported under XQuartz (the X11 environment on macOS) because of too
many conflicts between the X11 and macOS versions of accessibility.
.SH KEYWORDS
widget, tk
'\" Local Variables:
'\" mode: nroff
'\" End: