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

# setImage(_:for:state:)

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

## Declaration

```swift
func setImage(_ iconImage: UIImage?, for icon: UISearchBar.Icon, state: UIControl.State)
```

## Parameters

- `iconImage`: The image to use for the search bar icon identified by icon in the state identified by state.
- `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.

## 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)
- [image(for:state:)](uikit/uisearchbar/image(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)