Note: This is a work in progress and many formatting issues have been fixed. Read more about the project on the home page.

sharedHilite

set [the] sharedHilite of button to trueOrFalse

where button is a background button only.

The sharedHilite property returns or sets whether a background button shares its hilite property with every card in the background. The default value for new buttons is true.

Set sharedHilite to false if you want the hilite property for the background button maintained independently for each card.

For example, you might have one check box button in the background for marking and unmarking cards. You would set its sharedHilite to false so that its highlighting can be different on each card.

Examples

set the sharedHilite of bkgnd button 1 to true

get the sharedHilite of bkgnd button id 37

set the sharedHilite of bkgnd button id 37 to not it

Placeholders

button

HyperTalk Definition

An expression that identifies a button by name, number, or id, using one of the following forms:

[card] button id posInteger [of card]

[card] button text [of card] -- name

[card] button posInteger [of card]

ordinal [card] button [of card]

bkgnd button id posInteger [of card]

bkgnd button text [of card] -- name

bkgnd button posInteger [of card]

ordinal bkgnd button [of card]

For example:

card button id 3894

card button "Return"

card button 1

first card button

bkgnd button 2 of card 2

last bkgnd button

When used inside a button script: me

When a button receives a message: [the] target

A button can also be referred to as a part when you’re talking about its position among all buttons and fields within the same card or background.

AppleScript Definition

An expression that identifies a button by name, number, or id, using the same forms as HyperTalk except that “background” must be used in place of “bkgnd”.