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.

choose

choose tool posInteger

choose toolName tool

where posInteger is between 1 and 18.

The choose command chooses the tool with the specified number or name from the Tools palette.

HyperCard sends the choose command to the current card when you choose a tool from the Tools menu.

HyperCard passes the word tool to the first parameter variable and the tool number to the second parameter variable. You can handle the choose command as follows:

on choose what, toolNumber

  statements

end choose

Examples

choose browse tool

choose tool 1

choose button tool

choose tool 2

choose field tool

choose tool 3

choose select tool

choose tool 4

choose lasso tool

choose tool 5

choose pencil tool

choose tool 6

choose brush tool

choose tool 7

choose eraser tool

choose tool 8

choose line tool

choose tool 9

choose spray tool

choose tool 10

choose rectangle tool

choose rect tool

choose tool 11

choose round rectangle tool

choose round rect tool

choose tool 12

choose bucket tool

choose tool 13

choose oval tool

choose tool 14

choose curve tool

choose tool 15

choose text tool

choose tool 16

choose regular polygon tool

choose reg poly tool

choose tool 17

choose polygon tool

choose poly tool

choose tool 18

Placeholders

posInteger

An expression that evaluates to a positive integer.

For example:

3

67 mod 13

the number of bg fields

the number of backgrounds

the number of cards div 2

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

toolName

One of the following:

browse

brush

bucket

button

curve

eraser

field

lasso

line

oval

pencil

poly[gon]

rect[angle]

reg[ular] poly[gon]

round rect[angle]

select

spray [can]

text

statements

Any return-separated list of built-in commands, user-defined handlers, or keywords that are part of a message or function handler.

put "Hello world"   -- built-in command

get total(field 1)  -- function call

global HelpInfo     -- keyword

HyperTalk Reference

Version 0.8b4 (July 4, 2025)