Error getting tags :
error 404Error getting tags :
error 404 family | revDocs | RunRev
Welcome Guest (Log in)
Product Edition
Version
family
Basics
Expander triangle
Type
Property
Syntax
set the family of button to number
Introduced
1.0
Environment
Desktop, Web and Server
Platform Support
MacOS,Mac OS X,Windows,Linux
Security
None required
Summary
Coordinates a set of radio buttons so that only one button of a family can be highlighted.
Examples

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

Additional Comments
Expander triangle

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

Value:

The family of a button is an integer.

By default, the family property of newly created buttons is set to zero (no family).

Comments:

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 cluster: only one button in the family can be highlighted at a time, and highlighting 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 cluster by putting the buttons in a group and setting the group'sradioBehaviorproperty to true.

User Comments
Expander triangle
User thumbnail
Craig Newman (dunbarx)
StarStarStarStarStar
Sep 29, 2009
The family property is overridden by the sharedHilite property. Say you have a group of two buttons on two different cards. Background behavior is "true", Family is the same. The sharedHilite of btn 1 is "false" and the sharedHilite of btn 2 is "true":
1) On cd 1, set the hilite of btn 1 to "true". 2) On cd 2, set the hilite of btn 2 to "true". 3) Back on cd 1, the hilite of both will be "true".
Thus the family property does limit the hilite to one and only one button of a group, but only if the sharedHilite of both those buttons is also "true".