# PFUIElement.h

PFUIElement.h supports reading and controlling a UI element in a running application.

Version: 3.0.0

##### 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. PFUIElement.h 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.

© 2003-2010 Bill Cheeseman. Used by permission. All rights reserved. Last Updated: Wednesday, May 19, 2010