FUIBarButtonItem

@MainActor
open class FUIBarButtonItem : UIBarButtonItem

FUIBarButtonItem is an enhanced UIBarButtonItem to provide a way to specify the image to be displayed based on the state when title is nil or empty.

For now, only normal and disabled states are used.

FUIBarButtonItem also provides a few convenience init()s to return a newly initialized SAPFiori Style UIBarButtonItem. It has the SAPFiori styles, font & color for title and icon, .quaternaryFill background color for .highlighted state, and a minimum 44x44 touch area.

setImage(_:for:)
Sets the image for the specified control state.

Setting the image property is the same as setting the image for the .normal state.
Declaration
Swift

@MainActor public func setImage(_ image: UIImage?, for state: FUIControlState)


                      
                      
                      init(image:target:action:)

Initializes a new SAPFiori Style UIBarButtonItem using the specified image and other properties.

Declaration

Swift

@MainActor
public convenience init(image: UIImage?, target: AnyObject?, action: Selector?)

Parameters

`image`	The item’s image. If nil, an image is not displayed. The images displayed on the bar are derived from this image. If this image is too large to fit on the bar, it is scaled to fit. Typically, the size of a toolbar and navigation bar image is 20 x 20 points. The alpha values in the source image are used to create the images—opaque values are ignored.
`target`	The object that receives the action message.
`action`	The action to send to the target when this item is selected.

Return Value

A newly initialized SAPFiori Style UIBarButtonItem with the specified properties.


                      
                      
                      init(image:landscapeImagePhone:target:action:)

Initializes a new SAPFiori Style UIBarButtonItem using the specified images and other properties.

Declaration

Swift

@MainActor
public convenience init(image: UIImage?, landscapeImagePhone: UIImage?, target: AnyObject?, action: Selector?)

Parameters

`image`	The item’s image. If nil, an image is not displayed.
`landscapeImagePhone`	The image to be used for the item in landscape bars in the `UIUserInterfaceIdiomPhone` idiom.
`target`	The object that receives the action message.
`action`	The action to send to the target when this item is selected.

Return Value

A new SAPFiori Style UIBarButtonItem initialized to use using the specified images and other properties


                      
                      
                      init(title:target:action:)

Initializes a new SAPFiori Style UIBarButtonItem using the specified title and other properties.

Declaration

Swift

@MainActor
public convenience init(title: String?, target: AnyObject?, action: Selector?)

Parameters

`title`	The item’s title. If nil, a title is not displayed.
`target`	The object that receives the action message.
`action`	The action to send to the target when this item is selected.

Return Value

A newly initialized SAPFiori Style UIBarButtonItem with the specified properties.


                      
                      
                      init(customView:)

Initializes a new SAPFiori Style UIBarButtonItem using the specified custom view.

The bar button item created by this method does not call the action method of its target in response to user interactions. Instead, the bar button item expects the specified custom view to handle any user interactions and provide an appropriate response.

Declaration

Swift

@MainActor
public convenience init(customView: UIView)

Parameters


                                  customView

A custom view representing the item.

Return Value

A newly initialized SAPFiori Style UIBarButtonItem with the specified custom view.