@nut-tree/element-inspector/win

Element Types

Element types are platform dependent. @nut-tree/element-inspector provides a set of factory functions to create WindowElementQuery objects. These factory functions are grouped by platform.

On Windows, the following element types are available:

button

A button is an object that a user interacts with to perform an action such as the OK and Cancel buttons on a dialog box. The button control is a simple control to expose because it maps to a single command that the user wishes to complete.

calendar

A calendar control allows the user to easily determine the date and select other dates.

checkBox

A check box is an object used to indicate a state that users can interact with to cycle through that state. Check boxes either present a binary (Yes/No), (On/Off), or tertiary (On, Off, Indeterminate) option to the user.

comboBox

A combo box is a list box combined with a static control or an edit control that displays the currently selected item in the list box portion of the combo box. The list box portion of the control is displayed at all times or only appears when the user selects the drop-down arrow (which is a push button) next to the control. If the selection field is an edit control, the user can enter information that is not in the list; otherwise, the user can only select items in the list.

customControl

An application might make use of custom controls which are not part of the standard control types. In this case, the customControl control type is used.

dataGrid

The dataGrid control type lets a user easily work with items that contain data or automation elements presented in columns or rows. dataGrid controls have rows of items and columns of information about those items. A list-view control in Windows Explorer is an example that supports the dataGrid control type.

dataItem

The dataItem control is an item in a dataGrid control. An entry in a contacts list is an example of a data item control. A dataItem control contains information that is of interest to an end user. It is more complicated than the simple list item because it contains richer information.

document

document controls let a user view and manipulate multiple pages of text. Unlike edit controls which only support a simple line of unformatted text, document controls can host text that is richly styled and formatted. A typical example of a document control is the document area in e.g. MS Word.

editField

editField controls enable a user to view and edit a simple line of text without rich formatting support.

group

A group control represents a node within a hierarchy, similar to a div in HTML. The Group control type creates a separation in the UI Automation tree so items that are grouped together have a logical division within the UI Automation tree.

The header control provides a visual container for the labels for rows or columns of information.

headerItem

The headerItem control type provides a visual label for a row or column of information.

link

link controls create links that enable users to navigate within the same page, or from one page to another.

image

image controls used as icons, informational graphics, and charts will support the Image control type. Controls used as background or watermark images will not support the Image control type.

list

The list control type provides a way to organize a flat group or groups of items and allows a user to select one or more of those items.

listItem

A listItem control is an item in a list control. It is a child of a list control and contains data or automation elements.

A menu control allows hierarchical organization of elements associated with commands and event handlers. In a typical Microsoft Windows application, a menu bar contains several menu buttons (such as File, Edit, and Window), and each menu button displays a menu. A menu contains a collection of menu items (such as New, Open, and Close), which can be expanded to display additional menu items or to perform a specific action when clicked. So to put it simple, the window that pops up when you click on the "File" menu in an application is a menu control.

menuBar controls are an example of controls that implement the MenuBar control type. Menu bars provide a means for users to activate commands and options contained in an application. A typical example of a menu bar is the bar at the top of the window in an application that contains the File, Edit, and Help menus.

A menuItem control is an item representing a menu action item like "New", "Open..." etc. This means that both the "File" menu and the "New" menu item are menu controls.

pane

The pane control type is for potentially scrollable regions that have disparate content. It is used to represent an object within a frame or document window.

progressBar

progressBar controls indicate the progress of a lengthy operation. The control consists of a rectangle that is gradually filled with the system highlight color as an operation progresses.

radioButton

A radioButton consists of a round button and application-defined text (a label), an icon, or a bitmap that indicates a choice the user can make by selecting the button.

scrollBar

scrollBar controls enable a user to scroll content within a window or item container. The control consists of a set of buttons and a thumb control.

semanticZoom

semanticZoom is a technique introduced in Windows 8 for presenting and navigating large sets of related data or content within a single view, such as a photo album, app list, or address book. Semantic Zoom uses two distinct modes of classification, or zoom levels, for organizing and presenting the content. The low-level (or zoomed in) mode displays items in a flat, "all-up" structure; and the high-level (or zoomed out) mode displays items in groups, enabling the user to quickly navigate and browse through the content. For example, zooming a list of cities might change to a list of states containing those cities. Zooming a list of programs might change to a list of logical program groups.

separator

separator controls are used to visually divide a space into two regions. For example, a separator control can be a bar that defines two panes in a window.

slider

A slider control is a composite control with buttons that enable a user to set a numerical range or select from a set of items.

spinner

spinner controls are used to select from a domain of items or a range of numbers.

splitButton

The splitButton control enables an action to be performed on a control, and to expand the control to see a list of other possible actions that can be performed.

statusBar

A statusBar control displays information about an object being viewed in a window of an application, the object's component, or contextual information that relates to that object's operation within your application.

tab

A tab control is analogous to the dividers in a notebook or the labels in a file cabinet. By using a tab control, an application can define multiple pages for the same area of a window or dialog box.

tabItem

A tabItem control is used as the control within a tab control that selects a specific page to be shown in a window.

table

table controls contain rows and columns of text and, optionally, row headers and column headers.

textBox

A textBox control is a basic user interface item that represents a piece of text on the screen.

thumb

thumb controls provide the functionality that enables a control to be moved (or dragged), such as a scroll bar button, or resized, such as a window resizing widget.

titleBar

A titleBar control represents a title or caption bar in a window.

toolBar

toolBar controls enable end users to activate commands and tools contained within a application.

toolTip

toolTip controls are pop-up windows that contain text.

tree

The tree control type is used for containers whose contents have relevance as a hierarchy of nodes, as with the way files and folders are displayed in the left pane of Windows Explorer.

treeItem

The treeItem control type represents a node within a tree container. Each node might contain other nodes, called child nodes. Parent nodes, or nodes that contain child nodes, can be displayed as expanded or collapsed.

window

The window control consists of the window frame, which contains child objects such as title bar, client, and other objects.