PFUIElement.h

Version:
3.9.0
Includes:
<Cocoa/Cocoa.h>

Introduction

The PFUIElement class supports monitoring and controlling a UI element in a running application.

Discussion

The accessibility API implements the concept of a "UI element," an object based on Core Foundation's CFTypeRef type that represents a user interface element on the screen in a running application. The PFAssistive Framework implements this same concept in its PFUIElement and PFApplicationUIElement classes.

The following preprocessor macros are used in this header:

  • PFA_DEBUG Defining this macro causes the framework to log information about accessibility API errors to stderr.

  • PFA_BLOCK_EXPECTED_ERROR_LOGS Defining this macro when PFA_DEBUG is also defined suppresses logging of accessibility API errors in certain situations where normal usage is expected to generate errors, in order to prevent flooding stderr with uninteresting error messages.

It is recommended that you set both of these macros in the framework Target's Preprocessor Macros build setting for the Debug configuration only.



Classes

PFApplicationUIElement

A concrete class representing the root application UI element of a running application or the system-wide UI element.

PFUIElement

A concrete class representing a UI element in a running application.

Protocols

PFUIElementDelegate

A formal protocol declaring delegate messages sent by PFUIElement.

Categories

PFUIElement(Attributes)

A category on PFUIElement for attribute properties and methods.