---
title: "preferredSymbolConfigurationForImage(in:)"
framework: uikit
role: symbol
role_heading: Instance Method
path: "uikit/uibutton/preferredsymbolconfigurationforimage(in:)"
---

# preferredSymbolConfigurationForImage(in:)

Returns the preferred symbol configuration for a button state.

## Declaration

```swift
func preferredSymbolConfigurationForImage(in state: UIControl.State) -> UIImage.SymbolConfiguration?
```

## Parameters

- `state`: The state that uses the symbol configuration. Possible values are described in doc://com.apple.uikit/documentation/UIKit/UIControl/State-swift.struct.

## See Also

### Managing images and tint color

- [backgroundImage(for:)](uikit/uibutton/backgroundimage(for:).md)
- [image(for:)](uikit/uibutton/image(for:).md)
- [setBackgroundImage(_:for:)](uikit/uibutton/setbackgroundimage(_:for:).md)
- [setImage(_:for:)](uikit/uibutton/setimage(_:for:).md)
- [setPreferredSymbolConfiguration(_:forImageIn:)](uikit/uibutton/setpreferredsymbolconfiguration(_:forimagein:).md)
- [tintColor](uikit/uibutton/tintcolor.md)