:right-sidebar: True AccessibleRole =================================================================== .. currentmodule:: gi.repository.Gtk .. class:: AccessibleRole :no-contents-entry: The accessible role for a :obj:`~gi.repository.Gtk.Accessible` implementation. Abstract roles are only used as part of the ontology; application developers must not use abstract roles in their code. Fields ------ .. rst-class:: interim-class .. class:: AccessibleRole :no-index: .. attribute:: ALERT An element with important, and usually time-sensitive, information .. attribute:: ALERT_DIALOG A type of dialog that contains an alert message .. attribute:: APPLICATION A toplevel element of a graphical user interface. This is the role that GTK uses by default for windows. .. versionadded:: 4.12 .. attribute:: ARTICLE A section of a page that consists of a composition that forms an independent part of a document, page, or site. .. versionadded:: 4.14 .. attribute:: BANNER Unused .. attribute:: BLOCK_QUOTE A section of content that is quoted from another source. .. versionadded:: 4.14 .. attribute:: BUTTON An input element that allows for user-triggered actions when clicked or pressed .. attribute:: CAPTION Unused .. attribute:: CELL Unused .. attribute:: CHECKBOX A checkable input element that has three possible values: ``true``, ``false``, or ``mixed`` .. attribute:: COLUMN_HEADER A header in a columned list. .. attribute:: COMBO_BOX An input that controls another element, such as a list or a grid, that can dynamically pop up to help the user set the value of the input .. attribute:: COMMAND Abstract role. .. attribute:: COMMENT A comment contains content expressing reaction to other content. .. versionadded:: 4.14 .. attribute:: COMPOSITE Abstract role. .. attribute:: DIALOG A dialog is a window that is designed to interrupt the current processing of an application in order to prompt the user to enter information or require a response. .. attribute:: DOCUMENT Content that assistive technology users may want to browse in a reading mode. .. attribute:: FEED Unused .. attribute:: FORM Unused .. attribute:: GENERIC A nameless container that has no semantic meaning of its own. This is the role that GTK uses by default for widgets. .. attribute:: GRID A grid of items. .. attribute:: GRID_CELL An item in a grid or tree grid. .. attribute:: GROUP An element that groups multiple related widgets. GTK uses this role for various containers, like :obj:`~gi.repository.Gtk.HeaderBar` or :obj:`~gi.repository.Gtk.Notebook`. .. attribute:: HEADING Unused .. attribute:: IMG An image. .. attribute:: INPUT Abstract role. .. attribute:: LABEL A visible name or caption for a user interface component. .. attribute:: LANDMARK Abstract role. .. attribute:: LEGEND Unused .. attribute:: LINK A clickable link. .. attribute:: LIST A list of items. .. attribute:: LIST_BOX Unused. .. attribute:: LIST_ITEM An item in a list. .. attribute:: LOG Unused .. attribute:: MAIN Unused .. attribute:: MARQUEE Unused .. attribute:: MATH Unused .. attribute:: MENU A menu. .. attribute:: MENU_BAR A menubar. .. attribute:: MENU_ITEM An item in a menu. .. attribute:: MENU_ITEM_CHECKBOX A check item in a menu. .. attribute:: MENU_ITEM_RADIO A radio item in a menu. .. attribute:: METER An element that represents a value within a known range. .. attribute:: NAVIGATION Unused .. attribute:: NONE An element that is not represented to accessibility technologies. This role is synonymous to ``GTK_ACCESSIBLE_ROLE_PRESENTATION``. .. attribute:: NOTE Unused .. attribute:: OPTION Unused .. attribute:: PARAGRAPH A paragraph of content. .. versionadded:: 4.14 .. attribute:: PRESENTATION An element that is not represented to accessibility technologies. This role is synonymous to ``GTK_ACCESSIBLE_ROLE_NONE``. .. attribute:: PROGRESS_BAR An element that displays the progress status for tasks that take a long time. .. attribute:: RADIO A checkable input in a group of radio roles, only one of which can be checked at a time. .. attribute:: RADIO_GROUP Unused .. attribute:: RANGE Abstract role. .. attribute:: REGION Unused .. attribute:: ROW A row in a columned list. .. attribute:: ROW_GROUP Unused .. attribute:: ROW_HEADER Unused .. attribute:: SCROLLBAR A graphical object that controls the scrolling of content within a viewing area, regardless of whether the content is fully displayed within the viewing area. .. attribute:: SEARCH Unused .. attribute:: SEARCH_BOX A type of textbox intended for specifying search criteria. .. attribute:: SECTION Abstract role. .. attribute:: SECTION_HEAD Abstract role. .. attribute:: SELECT Abstract role. .. attribute:: SEPARATOR A divider that separates and distinguishes sections of content or groups of menuitems. .. attribute:: SLIDER A user input where the user selects a value from within a given range. .. attribute:: SPIN_BUTTON A form of range that expects the user to select from among discrete choices. .. attribute:: STATUS Unused .. attribute:: STRUCTURE Abstract role. .. attribute:: SWITCH A type of checkbox that represents on/off values, as opposed to checked/unchecked values. .. attribute:: TAB An item in a list of tab used for switching pages. .. attribute:: TABLE Unused .. attribute:: TAB_LIST A list of tabs for switching pages. .. attribute:: TAB_PANEL A page in a notebook or stack. .. attribute:: TERMINAL A virtual terminal. .. versionadded:: 4.14 .. attribute:: TEXT_BOX A type of input that allows free-form text as its value. .. attribute:: TIME Unused .. attribute:: TIMER Unused .. attribute:: TOGGLE_BUTTON A type of push button which stays pressed until depressed by a second activation. .. versionadded:: 4.10 .. attribute:: TOOLBAR Unused .. attribute:: TOOLTIP Unused .. attribute:: TREE Unused .. attribute:: TREE_GRID A treeview-like, columned list. .. attribute:: TREE_ITEM Unused .. attribute:: WIDGET Abstract role for interactive components of a graphical user interface .. attribute:: WINDOW Abstract role for windows.