Note: This is a work in progress and will be formatting errors. 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

choose

Examples

Placeholders

Related Topics