---

Introduction to Buttons

Contents:

Organization of This Document

A button is a user interface object that sends an action message to a target when clicked

You should read this document to learn what are the different types of button provided by Cocoa and how you can use them.

Organization of This Document

This document describes how to use a button. These articles give you basic information on the different types of button, and how you can customize buttons:

• “How Buttons Work”

• “Types of Button” describes the types of button, how they act, how it highlights when pressed and whether it shows its state.

• “Using Push Buttons”

• “Using Checkboxes”

• “Using Radio Buttons”

• “Setting the Appearance of a Button’s Border” describes how to change the border’s shape and grading.

• “Setting a Button’s Title” describes how to change the content and appearance of the button’s title.

• “Setting a Button’s Image” describes how to change the content and appearance of the button’s image.

• “Hiding a Button” describes how to make a button invisible or have it show its border only when the mouse is over it.

• “Setting a Button’s Key Equivalent” describes how to attach a key equivalent to a button.

• “Subclassing NSButton” describes how to subclass NSButton.

The following articles in other documents also contain relevant information:

• Using a Continuous Control describes how to set up a button so it sends its action message repeatedly while being pressed.

• Cell States describes the three states a button can have: on, off, or mixed.

---