Modal
An XCMD allowing you to create and display a modal dialog. Unlike the Dialog command, each text item can have its own style and font.
Modal XCMD. Version 1.1d1, by Sam Deane. Copyright ©1994 ULTRALAB. Compiled 16:50:58, 28/04/94.
[last exit to hypercard]
[externals index]
[download Modal]
Description
This XCMD creates and displays a modal dialog.
Unlike the Dialog XCMD, the Modal command creates the dialog on the fly, from parameters that you pass it describing all the dialog items.
The dialog items can each have a different font/style, which makes the command more flexible than the Ask and Answer commands, and allows it to deal with situations where the Dialog XCMD couldn't cope either.
Currently this command allows you to display editable text, but doesn't return it so that you can find out what was entered! This will be fixed in a later release! However, the command is still useful as it is, for displaying multi-font (perhaps multi-lingual) dialogs.
Commands
create
This command creates a modal dialog.
The basic syntax is:
Modal "create",<item>,<item>,....,<item>
Each <item> parameter describes one item in the dialog. The format of the parameters vary depending on the kind of item being described, but the basic format is:
"<type> / <rect> / <status> / <other parameters>"
The <type> parameter can be one of: text, edit, button, or picture.
The <rect> parameter describes the position and size of the item, relative to the top left hand corner of the dialog.
The <status> parameter says whether the item is inactive (ie can't be clicked on), active, or is the default or cancel item. The default item is outlined with a thick border, and it chosen by default if the return or enter key is pressed. The cancel item is chosen by default if the escape key is pressed. The <status> parameter should be one of: active,inactive,default,cancel.
The other parameters vary depending upon the item type:
PICTURE ITEMS
The full syntax for a picture item is:
"<type> / <rect> / <status> / <name>"
The <name> parameter gives the name of the PICT resource to display.
OTHER ITEMS
The full syntax for a button, text or editable text item is:
"<type>/<rect>/<status>/<source>/<font>/<size>/<contents>"
The <source> parameter tells the XCMD where the text for the item should be taken from. It should be one of: resource,string,global,card, or background.
The <font> and <size> parameters specify the default font and size for the item.
The meaning of the <contents>parameter depends upon the value of the <source> parameter.
If the <source> parameter was card, or background, then the <contents> parameter gives the name of a card or background field containing the contents of the item.
If the <source> parameter was string, the <contents> parameter contains the contents of the item.
If the <source> parameter was global, the <contents> parameter contains the name of a global variable containing the item's contents.
If the <source> parameter was resource, the <contents> parameter contains the name of a TEXT/styl resource pair, containing the contents of the item.
Example script for create
on mouseUp
put "picture/13,13,45,45/inactive/test/" into picture
put "edit/53,13,309,45/active/resource/another test" into text
put "button/245,53,309,73/default/string/geneva/9/this is a bit too long OK" into ok
Modal create,picture,text,ok
answer the result
end mouseUp
