THE HYPERCARD CENTER

HyperTalk Reference

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

name

the [adjective] name of object

the [long] name of HyperCard

set [the] name of object to text

set [the] name of [menuItem of] menu to text

get [the] [English] name of [menuItem of] menu

The name property returns or sets the name of an object, menu item, or menu. If the element doesn't have a name, the name returns the ID of the object instead.

the long name of HyperCard returns the full path to HyperCard:

myDisk:Desktop Folder:HyperCard Folder:HyperCard

You can use the adjective English to determine the names of menus and menu items if you're using a localized version of HyperCard:

if the English name of menuItem 5  ¬

   of menu "Edit" is "Paste"...

The adjectives abbreviated, long, and short return various forms of an object’s name (click Demo Script to see examples).

Note: the abbreviated name is the same as the name.

Examples

the short name of button 1

the abbreviated name of bkgnd button 4

the abbrev name of bkgnd button 4

the abbr name of bkgnd button 4

the name of card field 1 of last card

the long name of me

the name of menuItem 1 of menu 2

the name of first menuItem of menu "File"

set the name of button 1 to "Hide field"

set the name of this card to line 1 of field "Title"

set the name of menuItem 1 of menu "File" to "Trouble"

if the English name of menuItem 5 of menu "Edit" is not "Paste"...

Demo Script

on nameDemo

   answer "The short name of card id 86868 is:" & return & ¬

   (the short name of card id 86868) & return & return &¬

   "The abbreviated name is:" & return &¬

   (the abbr name of card id 86868) & return & return &¬

   "The name is:" & return &¬

   (the name of card id 86868) & return & return &¬

   "The long name is:" & return &¬

   (the long name of card id 86868)

end nameDemo

Placeholders

adjective

One of the following:

abbr

abbrev

abbreviated

long

short

object

HyperTalk Definition

The object HyperCard, or any expression that identifies an object by name, number, or id.

For example:

HyperCard

me

[the] target

button 1

background part 6

card field id 3894

this card

next background

stack "My Stack"

AppleScript Definition

An identifiable part of an application, or a thing within an application that can respond to commands.

text

An expression that evaluates to a text string.

A text expression can be a literal string surrounded by quotation marks or the value of a container.

For example:

"Hello"

"The sum is:" && 3

card field 1

line 1 of bg fld "Address"

the Message box

the selection

myVar -- a variable

See also: background, bkgnd, button, card, field, menu, menuItem, and stack

menuItem

An expression that evaluates to one of the following:

menuItem text

menuItem posInteger

ordinal menuItem

For example:

menuItem "New"

menuItem 2

second menuItem

name

Examples

Demo Script

Related Topics

Placeholders

adjective

object

text

menuItem

menu