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

number (property)

the number of button

the number of field

the number of card

the number of bkgnd

the number of window

The number property returns the number of a button, field, card, background, or window. (You cannot set a number.) The number of a button or field determines whether it’s on top of other buttons and fields within the same layer (background or card) that contains it. Card objects are always on top of background objects.

To change the number of a button or field, select it and choose Send Farther and Bring Closer from the Objects menu, or change its partNumber property.

The number of a window reflects its front to back order (similar to the number of a button or field). You can change a window's number by bringing it to the front (for example, by clicking it or by using the show command), or by covering it with other windows.

The number of a card is its position within a stack. The number of a background is the order in which the background was created. To change the number of a card or background, you must use the sort command or cut cards and paste them into different positions within the stack.

Examples

the number of bkgnd button "Prev"

the number of card field id 90

the number of this card

the number of this background

if the number of this card = 1 then ...

Demo Script

on nameDemo

 answer "The number of bkgnd field “Demo Script” is:" && ¬

 the number of bkgnd field "Demo Script" & return & return & ¬

 "The number of this card is:" && ¬

 the number of this card & return & return & ¬

 "The total number of cards in the stack is:" && ¬

 the number of cards & return & return & ¬

 "The number of this background is:" && ¬

 the number of this bkgnd

end nameDemo

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”.

field

An expression that identifies a field by name, number, or id using one of the following forms (in AppleScript, use “background” in place of “bkgnd”):

card field id posInteger [[of] card]

card field text [of card] -- name

card field posInteger [of card]

ordinal card field [of card]

[bkgnd] field id posInteger [of card]

[bkgnd] field text [of card] -- name

[bkgnd] field posInteger [of card]

ordinal [bkgnd] field [of card]

For example:

card field id 3894

card field "My Notes"

card field 1

first card field

background field 3 of card 1

When used inside a field script in HyperTalk: `me`

When a field receives a message: `[the] target`

A field 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.

`card`

An expression that identifies a card by name, number, or id using one of the following forms (in AppleScript, use “background” in place of “bkgnd”):

recent card

back

forth

card id posInteger [of bkgnd

card text [of bkgnd] -- name

card posInteger [of bkgnd] -- number

ordinal card [of bkgnd]

position card [of bkgnd]

ordinal marked card

position marked card

marked card posInteger

For example:

card id 3894

card "Index"

card 1 of background 1

prev card

previous card of this background

next card

this card

first card

last card

middle card

any card

first marked card

last marked card

next marked card

previous marked card

marked card 1

marked card (the number of marked cards)

When used inside a card script in HyperTalk: me

When a card receives a message: [the] target

See also: button and field

`bkgnd`

A HyperTalk expression that identifies a background by name, number, or id, using one of the following forms:

bkgnd id posInteger

bkgnd text -- name

bkgnd posInteger -- number

ordinal bkgnd

position bkgnd

For example:

bkgnd id 3894

bkgnd "Index"

bkgnd 1

prev bkgnd

previous bkgnd

next bkgnd

this bkgnd

first bkgnd

last bkgnd

middle bkgnd

any bkgnd

From within a background script, the term me refers to that background.

When a background receives a the message [the] target, that message is referring to the background.

See also: card

`window`

One of HyperCard’s built-in windows, the window containing the current stack (called the card window), or any other window containing a stack, as follows:

card window

tool window

window "tools"

pattern window

window "Patterns"

scroll window

window "scroll"

[the] message [window]

[the] message [box]

[the] msg [window]

[the] msg [box]

window "message"

message watcher

window "message watcher"

variable watcher

window "variable watcher"

window "Home"

window "Readymade Buttons"

-- if longWindowTitles is true:

window "My HD:Home"

window 6

window ID 21403082

Note: If a window containing a stack is inactive, you can set only its location and visible properties.

Important: External windows can’t be substituted for the window placeholder (see the externalWindow placeHolder).


    
      
                HyperTalk Reference


    
      
        
        
                        address
                            autoHilite
                            autoSelect
                            autoTab
                            blindTyping
                            bottom
                            bottomRight
                            brush
                            cantAbort
                            cantDelete
                            cantModify
                            cantPeek
                            centered
                            checkMark
                            commandChar
                            cursor
                            debugger
                            dialingTime
                            dialingVolume
                            dontSearch
                            dontWrap
                            dragSpeed
                            editBkgnd
                            enabled
                            environment
                            family
                            filled
                            fixedLineHeight
                            freeSize
                            grid
                            height
                            hilite
                            icon
                            ID 
                            itemDelimiter
                            language
                            left
                            lineSize
                            location
                            lockErrorDialogs
                            lockMessages
                            lockRecent
                            lockScreen
                            lockText
                            longWindowTitles
                            markChar
                            marked
                            menuMessage
                            messageWatcher
                            multiple
                            multipleLines
                            multiSpace
                            name
              number (property)
              numberFormat
                            owner
                            partNumber
                            pattern
                            polySides
                            powerKeys
                            printMargins
                            printTextAlign
                            printTextFont
                            printTextHeight
                            printTextSize
                            printTextStyle
                            rectangle
                            reportTemplates
                            right
                            script
                            scriptEditor
                            scriptingLanguage
                            scriptTextFont
                            scriptTextSize
                            scroll
                            sharedHilite
                            sharedText
                            showLines
                            showName
                            showPict
                            size
                            stacksInUse
                            style
                            suspended
                            textAlign
                            textArrows
                            textFont
                            textHeight
                            textSize
                            textStyle
                            titleWidth
                            top
                            topLeft
                            traceDelay
                            userLevel
                            userModify
                            variableWatcher
                            version
                            visible
                            wideMargins
                            width
                            zoomed

number (property)

Examples

Demo Script

Related Topics

Placeholders

button

field

card

bkgnd

window

`card`

`bkgnd`

`window`