Skip to content


Buttons initiate app-specific actions, have customizable backgrounds, and can include a title or an icon. The system provides a number of predefined button styles for most use cases. You can also design fully custom buttons. The button derives from the UIButton class.


System Buttons

System buttons often appear in navigation bars and toolbars, but may be used anywhere.

  • System: A general-purpose button
  • DetailDisclosure: Indicates the availability of detailed information, usually about a specific item in a table
  • InfoDark: Indicates the availability of configuration information; dark-colored
  • InfoLight: Indicates the availability of configuration information; light-colored
  • AddContact: Indicates that a contact can be added
  • Custom: Customizable button

Configuring the button

Button properties

Button events

To handle the button click event, use the Touch Up Inside event. The event can be added from the Properties window or in code.

Add event in code

  1. Select the button from interface builder
  2. From the Properties window, under the Identity section, assign a Name to the button Button assign name
  3. From the backing ViewController file wire up the event as follows
public override void ViewDidLoad()
    btnLogin.TouchUpInside += (sender, e) => { 
        // Handle the button click here

Add event from interface builder

You can also add the event from within interface builder.

  1. Select the button from interface builder
  2. Open the Properties window
  3. Choose the Events section
  4. Add the name of the method to handle the event
  5. Visual Studio code editor will open and let you choose where to place the event handler method

Custom button types

You can create custom button types by using images. Set the Image property from interface builder. You can also use code ot change the button image as below:

btnSignUp.SetImage(UIImage.FromBundle("logo"), UIControlState.Normal);

Using the UIImage.FromBundle finds the iamge already defined in the asset catalog.

Asset catalog image