family

Coordinates a set of radio buttons so that only one button of a family can be highlight.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

set the family of button to number

# Examples

set the family of button "Choice #1" to 3

# Description

Use the family property to set up a cluster of related buttons.

Setting the family of a button to a number makes the button a member of that family. All the buttons in a card or group whose family property is the same behave as a radio button: only one button in the family can be highlight at a time, and highlight another member of the family unhighlights all the others.

If a button's family property is zero, it is not a member of any family.

If the buttons are part of a group, the group's backgroundBehavior property must be set to true.

This property exists to aid compatibility with imported HyperCard stacks. Unlike the property in HyperTalk, it has no effect on buttons whose style property is not "radioButton".

>*Tip:* You can also create a radio button by > putting the buttons in a group and setting > the group radioBehavior property to true.

# Tags

ui,

# See

- **keyword:** card, integer, button - **property:** hilitedButtonName, radioBehavior - **command:** group - **function:** selectedButton - **glossary:** property, highlight, radio button, group - **object:** button