---
title: "image(for:state:)"
framework: uikit
role: symbol
role_heading: Instance Method
path: "uikit/uisearchbar/image(for:state:)"
---

# image(for:state:)

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

## Declaration

```swift
func image(for icon: UISearchBar.Icon, state: UIControl.State) -> UIImage?
```

## Parameters

- `icon`: An icon identifier constant.
- `state`: A control state. Valid states are doc://com.apple.uikit/documentation/UIKit/UIControl/State-swift.struct/normal and doc://com.apple.uikit/documentation/UIKit/UIControl/State-swift.struct/disabled.

## Return Value

Return Value The image used for the search bar icon identified by icon in the state identified by state.

## See Also

### Customizing the search bar appearance

- [backgroundImage](uikit/uisearchbar/backgroundimage.md)
- [backgroundImage(for:barMetrics:)](uikit/uisearchbar/backgroundimage(for:barmetrics:).md)
- [setBackgroundImage(_:for:barMetrics:)](uikit/uisearchbar/setbackgroundimage(_:for:barmetrics:).md)
- [setImage(_:for:state:)](uikit/uisearchbar/setimage(_:for:state:).md)
- [positionAdjustment(for:)](uikit/uisearchbar/positionadjustment(for:).md)
- [setPositionAdjustment(_:for:)](uikit/uisearchbar/setpositionadjustment(_:for:).md)
- [inputAccessoryView](uikit/uisearchbar/inputaccessoryview.md)
- [searchFieldBackgroundImage(for:)](uikit/uisearchbar/searchfieldbackgroundimage(for:).md)
- [setSearchFieldBackgroundImage(_:for:)](uikit/uisearchbar/setsearchfieldbackgroundimage(_:for:).md)
- [searchFieldBackgroundPositionAdjustment](uikit/uisearchbar/searchfieldbackgroundpositionadjustment.md)
- [searchTextPositionAdjustment](uikit/uisearchbar/searchtextpositionadjustment.md)