Instance Method

backgroundImageForBarPosition:barMetrics:

Returns the image used for the background in a given position and with given metrics.

Declaration

- (UIImage *)backgroundImageForBarPosition:(UIBarPosition)barPosition barMetrics:(UIBarMetrics)barMetrics;

Parameters

barPosition

A bar position constant.

barMetrics

A bar metrics constant.

Return Value

The image used for the search bar background in the position specified by barPosition and with the metrics specified by barMetrics.

Discussion

The default value is nil.

See Also

Customizing the Search Appearance

backgroundImage

The background image for the search bar.

- setBackgroundImage:forBarPosition:barMetrics:

Sets the image to use for the background in a given position and with given metrics.

- imageForSearchBarIcon:state:

Returns the image for a given search bar icon type and control state.

- setImage:forSearchBarIcon:state:

Sets the image for a given search bar icon type and control state.

- positionAdjustmentForSearchBarIcon:

Returns the position adjustment for a given icon.

- setPositionAdjustment:forSearchBarIcon:

Returns the position adjustment for a given icon.

inputAccessoryView

A custom input accessory view for the keyboard of the search bar.

scopeBarBackgroundImage

The background image for the scope bar.

- scopeBarButtonBackgroundImageForState:

Returns the background image for the scope bar button in a given state.

- setScopeBarButtonBackgroundImage:forState:

Sets the background image for the scope bar button in a given state.

- scopeBarButtonDividerImageForLeftSegmentState:rightSegmentState:

Returns the divider image to use for a given combination of left and right segment states.

- setScopeBarButtonDividerImage:forLeftSegmentState:rightSegmentState:

Sets the divider image to use for a given combination of left and right segment states.

- scopeBarButtonTitleTextAttributesForState:

Returns the text attributes for the search bar’s button’s title string for a given state.

- setScopeBarButtonTitleTextAttributes:forState:

Sets the text attributes for the search bar’ button’s title string for a given state.

- searchFieldBackgroundImageForState:

Returns the search text field image for a given state.

- setSearchFieldBackgroundImage:forState:

Sets the search text field image for a given state.

searchFieldBackgroundPositionAdjustment

The offset of the search text field background in the search bar.

searchTextPositionAdjustment

The offset of the text within the search text field background.