UIAScrollView Class Reference

Inherits from	UIAElement
Availability	Available in iOS 4.0 and later.

Overview

The UIAScrollView class allows access to, and control of, the elements of a scroll view.

For an explanation of how to use this class and related classes, see “Automating UI Testing” in Instruments User Guide.

Inherited Methods

Table 1 provides a list of methods inherited from UIAElement.

**Table 1** Methods inherited from `UIAElement`
Method	Description
`activityIndicators`	Returns an array of the activity indicators contained by the specified object.
`activityView`	Returns an object representing an activity view.
`ancestry`	Returns an array containing the parents of the specified object.
`buttons`	Returns an array of buttons contained by the specified object.
`checkIsValid`	Returns the specified element’s current validity status.
`collectionViews`	Returns an array of collection views contained by the specified object.
`doubleTap`	Double-taps the specified element.
`dragInsideWithOptions`	Drags within the bounds of an element.
`elements`	Returns an array of elements contained by the specified object.
`flickInsideWithOptions`	Flicks within the bounds of an element.
`hasKeyboardFocus`	Determines whether specified element receives keyboard input.
`hitpoint`	Returns the screen position to tap for the specified element.
`images`	Returns an array of images contained by the specified object.
`isEnabled`	Determines whether the specified element is enabled.
`isValid`	Returns the specified element’s validity status as of the most recent access.
`isVisible`	Determines whether the specified element is visible on the screen.
`label`	Returns a string containing the label attribute of the element.
`links`	Returns an array of links contained by the specified object.
`logElement`	Logs information about the specified element.
`logElementTree`	Logs information about the specified element and all of its subelements.
`name`	Returns a string containing the name attribute of the element.
`navigationBar`	Returns the app’s navigation bar.
`navigationBars`	Returns an array of navigation bar objects contained by this object.
`pageIndicators`	Returns an array of page indicators contained by the specified object.
`parent`	Returns the parent of the specified element.
`pickers`	Returns an array of picker objects contained by the specified object.
`popover`	Returns the popover object associated with the specified object.
`progressIndicators`	Returns an array of progress indicators contained by the specified object.
`rect`	Returns the position of the object on the main screen.
`rotateWithOptions`	Perform a rotation gesture centered on the specified element.
`scrollToVisible`	Scrolls until the specified element is visible in a container view.
`scrollViews`	Returns an array of scroll views contained by the specified object.
`searchBars`	Returns an array of search bars contained by the specified object.
`secureTextFields`	Returns an array of secure text fields contained by the specified object.
`segmentedControls`	Returns an array of segmented controls contained by the specified object.
`sliders`	Returns an array of sliders contained by the specified object.
`staticTexts`	Returns an array of static texts contained by the specified object.
`switches`	Returns an array of switches contained by the specified object.
`tabBar`	Returns the specified tab bar.
`tabBars`	Returns an array of tab bars contained by this object.
`tableViews`	Returns an array of table views contained by the specified object.
`tap`	Taps the specified element.
`tapWithOptions`	Performs the specified gesture on the specified element using a dictionary to specify gesture attributes.
`textFields`	Returns an array of text fields contained by the specified object.
`textViews`	Returns an array of text views contained by the specified object.
`toolbar`	Returns the specified toolbar.
`toolbars`	Returns an array of toolbars contained by this object.
`touchAndHold`	Touches the specified element and holds for the specified duration.
`twoFingerTap`	Performs a two-finger (two-touch) tap on this element.
`value`	Returns a string containing a value attribute specific to the type of element.
`waitForInvalid`	Waits for the specified element to become invalid.
`webViews`	Returns an array of web views contained by the specified object.
`withName`	Returns an element whose name attribute matches a specified string.
`withPredicate`	Returns the element matching the specified criteria.
`withValueForKey`	Returns the element containing the specified property with the specified value.

Tasks

Scrolling

Methods

scrollDown

Scrolls down within the specified scroll view.

(undefined) scrollDown()

Availability

Available in iOS 4.0 and later.

scrollLeft

Scrolls left within the specified scroll view.

(undefined) scrollLeft()

Availability

Available in iOS 4.0 and later.

scrollRight

Scrolls right within the specified scroll view.

(undefined) scrollRight()

Availability

Available in iOS 4.0 and later.

scrollToElementWithName

Scrolls within the specified scroll view until the named element is displayed on the screen.

(UIAElement) scrollToElementWithName(String name)

Parameters

name: The name of the element to scroll to.

Availability

Available in iOS 4.0 and later.

scrollToElementWithPredicate

Scrolls within the specified scroll view until the matching element is displayed on the screen.

(UIAElement) scrollToElementWithPredicate(PredicateString predicateString)

Parameters

predicateString: The predicate to define the match criteria.

Availability

Available in iOS 4.0 and later.

scrollToElementWithValueForKey

Scrolls within the specified scroll view until the element with the specified value for the specified key is displayed on the screen.

(UIAElement) scrollToElementWithValueForKey(NotTyped value, String key)

Parameters

value: The value for the specified key.
key: The key for the specified value.

Availability

Available in iOS 4.0 and later.

scrollUp

Scrolls up within the specified scroll view.

(undefined) scrollUp()

Availability

Available in iOS 4.0 and later.

Did this document help you?

Shop the Apple Online Store (1-800-MY-APPLE), visit an Apple Retail Store, or find a reseller.