# hs.uielement

A generalized framework for working with OSX UI elements

---

# Submodules

• hs.uielement.watcher

---

# API Overview

Functions - API calls offered directly by the extension

• focusedElement

Methods - API calls which can only be made on an object returned by a constructor

• isApplication
• isWindow
• newWatcher
• role
• selectedText

---

# API Documentation

# Functions

# focusedElement

---

# Methods

# isApplication

---

# isWindow

---

# newWatcher

| | | | --------------------------------------------|-------------------------------------------------------------------------------------| | Signature | hs.uielement:newWatcher(handler[, userData]) -> hs.uielement.watcher or nil | | Type | Method | | Description | Creates a new watcher | | Parameters |

• A function to be called when a watched event occurs. The function will be passed the following arguments: element: The element the event occurred on. Note this is not always the element being watched. event: The name of the event that occurred. watcher: The watcher object being created. userData: The userData you included, if any.
• an optional userData object which will be included as the final argument to the callback function when it is called.

| | Returns |

• An hs.uielement.watcher object, or nil if an error occurred

| | Notes | None | | Examples | None | | Source | extensions/uielement/libuielement.m line 86 |

---

# role

---

# selectedText

---

---