TweetFollow Us on Twitter

Dialoger
Volume Number:5
Issue Number:11
Column Tag:Kelly's Corner

Dialoger™ Helps HyperCard

By Dave Kelly, MacTutor Editorial Board

A dialog with HyperCard

Are you getting tired of only being able to create dialogs with only 3 possible replies. HyperTalk supplies the “Answer” statement which displays a dialog box containing a prompt and one, two, or three buttons. The “Ask” statement displays a dialog box containing a question and an edit box for the user to type a response. For very simple responses these statements may be good enough, but what do you do if you want a more complex dialog?

You could write your own XCMD or XFCN to display a custom dialog that you could create with ResEdit, but why re-invent the wheel? Introducing Dialoger™ from theResult Software Inc. At the heart of Dialoger™ is a set of XCMDs and XFCNs which provide versatility and flexibility. Dialoger™ is a productivity tool. The Dialoger™ package consists of four stacks, 3 of which provide help and examples.

The Dialog Maker stack is the tool provided to create dialogs which can then be exported to any stack along with a button with a script to call the dialog. This stack provides a tool palette which lets you create the custom dialog on a HyperCard card. The tools let you create the items used by the dialog. The limitation here is that even though you can create as many items as you have room for, you may only manipulate (or modify) items 3-16 from your HyperCard script. A bit of planning and this won’t be too much of an inconvenience.

The Push Button Tool lets you create a new push button. The limitation here is that the first item of any dialog should always be an ‘OK’ push button and the second item should be a ‘Cancel’ push button. If you don’t want an ‘OK’ or ‘Cancel’, you can define the size to zero and make the item virtually invisible. Since you can only manipulate items 3-16, it is recommended that the first two items be defined as ‘OK’ and ‘Cancel’.

The Radio Button and Checkbox Tools allow you to create radio and Checkbox controls for the dialog. Radio buttons may be grouped together such that only one button may be selected at a time by ordering the buttons next to each other in the item list. You can re-order the item list by clicking the create button.

The editable text and static text tools are for providing text in the dialog. User text placeholders (such as ^0, ^1, ^2, and ^3) may be used to replace text when the dialog is called (in your script) or text items may be editable or static. The usertext tool is an alternative to the static text. It is not restricted to begin in the default font; any font and size may be specified.

The icon and picture tools allow you to use icons or pictures in your dialog. When you click on these tools, a list of ICONs or PICTs from the current stack are shown. An open button allows you to open another stack to use ICON or PICTs from there. ICONs or PICTs from other applications or files need to be moved to a stack using ResEdit or ResCopy (which comes with Dialoger™).

The box tool is used to create boxes which you can have direct control over how the box will be displayed (such as pen pattern, fill pattern, etc.) from your script. However, you will not have control until the dialog is created and the box item must still be between item 3 and 16 to be able to set the patterns, etc.

The Popup Tool creates a new Popup menu item for your dialog box. The menu items are included in the button script when you export the dialog to your stack.

The List tool is used to create list items.

Buttons are also available to create ICON, PICT and SICN (small icons) from any part of the HyperCard window.

‘Import’ button will import existing dialogs into HyperCard for editing. ‘Create’ will create DLOG and DITL resources from the HyperCard card. Before creating the dialog you may re-order the items to the order you want them to appear. You may also specify the type of dialog that you want to create. The ‘Show’ button will give you a quick preview of what the dialog will look like. This gives you a chance to see what needs to be modified in the dialog before actually exporting to your stack. The ‘Export’ button allows you to install your dialog and pre-defined button script into your stack. You may also export the Dialoger XCMDs and associated XFCNs into your stack.

Dialoger™ Scripts

The Dialog Maker stack creates the dialog and a script which you can build upon to link your stack and dialog(s) together. The Dialoger XCMD is call with a HyperTalk ‘Put’ or ‘Get’ statement:

  put Dialoger(“Example”& return & “on exampleHit”¬
  ,”” ¬ --Placeholder replacement text
  , “”¬ --Radio Button “Deep Dish”
  , “”¬ --Radio Button “Thin’n Crispy”
  , “”¬ --Checkbox “Home Delivery”
  , “”¬ --Icon “20086”
  , “”¬ --Button “Motto ”
  , “userBox Black,None,Copy”& CR &” Style “¬ --Box (Black pen, None 
fill)  “ Style “
  , “userText New York,18,White”& CR &”Peter’s Pizza Palace<B<U”¬ --Text 
“Peter’s Pizza Palace”
  , “userList Geneva,12”  & CR & List1¬ --List “Anchovies”
  , “”¬ --Editable Text “”
  , “”¬ --Static Text “Name:”
  , “userPop”  & CR & PopUp1¬ --PopUp “Small”
  , “”¬ --Static Text “Size:”
  , “”¬ --Static Text “Toppings”
  , “userBox Gray,None,Copy”¬ --Box (Gray pen, None fill)
  ) into dResult
  
  -- Beyond Limit: , “”¬ --Card Picture

Each parameter of the function corresponds to each item in the dialog. Parameters 3-16 may be modified when the dialog is called, any others are beyond the limits of the function. The status of each item in the dialog is returned by the function and (in this case) placed into the variable dResult. Each line of dResult corresponds to the status of each item in the dialog at the time it was closed. dResult might look like this:

OK

true
false
true




3,4,5,6,7
Dave

Small

The ‘OK’ above indicated that item one of the dialog was selected. Item 2 was not selected. Item 3 was true, 4 was false, 5 was true. The list item (item 10) had items 3,4,5,6, and 7 selected. Item 11 was the editable text field; Dave was returned. The Popup menu item ‘Small’ was selected in item 13.

Since the scripts are pre-defined by the Dialog Maker stack, implementing the dialogs is a breeze. The dialogs may be customized even more and controlled by a script handler even when the dialog is still active. The “on exampleHit” statement in the dialoger function will generate a HyperCard message “exampleHit” which may be handled as desired even when the dialog is still active.

Additional commands are available to give even more flexibility to the dialogs. For example, you can use the ‘ResIDList’ or ‘ResNameList’ to get all the names or IDs of a specified resource type. This would be useful to get the names of all fonts to put in a menu or a list. The weakest aspect of Dialoger™ is the manual. theResult Software has recognized that this is a weak point and will eventually update the manual. An experienced program will still have no trouble figuring out how things work, but still may have to dig a little to find out what each function/command does. There is a help stack which gives an overall tutorial of Dialoger™ and a Commands stack which gives syntax and a description of some of the XFCNs which may be used in conjunction with the dChanger, and dialoger XFCNs. Not all functions are listed anywhere in the Dialoger package, though may be useful to you. The following XCMDs and XFCNs are found in the Dialoger package:

XCMDs:

CloseResFork: (example: closeResFork(fNum)

CoSortInt: (Don’t know what this does)

dChanger: this function is used to change items in a dialog.

DisplayPict: assumed that this displays PICTs

GetPicture: assumed that his gets PICTs

ResCopyQuick: (example: resCopyQuick fromFile,toFile,”PICT”,(short name of obj) )

SetCursor2: sets cursors

XFCN’s:

AfterChar: (example: put AfterChar(quote, strName) into var ) this will put all characters after the specified character into the variable.

BeforeChar: (example: put BeforeChar(quote, strName) into var )this will put all characters before the specified character into the variable.

ChangeStr: (Don’t know what this does)

dActivate: (example: get dActivate() ) used to activate modeless dialogs

dBreaker: (Don’t know what this does).

dBubble: (example: get dialoger(dBubble() & return & “dismiss”) according to the manual, this is used in the closeStack script for modeless dialogs to help determine which dialogs are still open so they can be dismissed.

dContents: (example: put dContents(dialog) into dIntermResult) gets the contents of the dialog at any one moment.

Dialoger: (see example above) displays dialogs and returns the contents of the dialog when dialog is dismissed.

dMaker: (example: get dMaker(dInfo, iTypes, iRects, iTexts, getsHits)

Dragger: Don’t know what this does.

FileName: (example: get fileName(“STAK”, “Select stack to install dialog in:”) ) uses standard get file dialog to get a file name.

FontHeight : (Example: put fontHeight(( textfont of obj), (textSize of obj)) into fH ) gets font height

FontName: gets font name

iMaker: create icons out of any part of the card (example: iMaker(“”,it) ) uses it as the icon’s name.

NewFileName: (example: get newfilename (“Report Name:”) get a new file name using standard get file dialog and use the parameter as the default.

OpenResFork: put openResFork(fName) into fNum

PictRect :(example: get pictRect(rID)

put item 4 of it - item 2 of it into dH

put item 3 of it - item 1 of it into dV ) get the coordinates of a PICT rectangle

pMaker: creates a PICT out of any part of the card (example: pMaker(“”,it) ) uses it as the PICT’s name.

ResIDList: (example: get resIDList(fName,rType) gets IDs from file name fName which have resource type rType.

ResNameList: similar to ResIDList, but gets resource names instead of IDs.

ResSortedList: sorts resource list.

rInfo: Don’t know how this works

sMaker: creates small icons out of any part of the card (example: sMaker(“”,it) ) uses it as the small icon’s name.

StringWidth: (example: put stringWidth(short name of obj,”chicago”,12) into oldPixLen ) gets a portion of a string.

StripItem: Don’t know how this works

TestBed: Don’t know how this works

UnScrunch: Don’t know how this works

Dialoger™ is in fact an ingenious productivity tool which should help you in all your stack development efforts. I recommend it for anyone who uses HyperTalk. Hopefully this overview has given you a good feel for what Dialoger can do for you. Questions regarding Dialoger may be referred to the address below:

Dialoger™ for HyperCard® is available from:

theResult Software, Inc.

616-D Guilford College Road

Greensboro, NC 27409

Fax (919) 855-6931

(919) 294-5034

Price: $94.29 single license version

or add $55 to upgrade to unlimited runtime version:

$150.00 unlimited runtime, (developer version)

includes HyperCard version 1.2.2 and is

NOT COPY PROTECTED!!

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Alfred 3.2.1 - Quick launcher for apps a...
Alfred is an award-winning productivity application for OS X. Alfred saves you time when you search for files online or on your Mac. Be more productive with hotkeys, keywords, and file actions at... Read more
OmniPlan 3.6 - Robust project management...
With OmniPlan, you can create logical, manageable project plans with Gantt charts, schedules, summaries, milestones, and critical paths. Break down the tasks needed to make your project a success,... Read more
Backblaze 4.2.0.990 - Online backup serv...
Backblaze is an online backup service designed from the ground-up for the Mac. With unlimited storage available for $5 per month, as well as a free 15-day trial, peace of mind is within reach with... Read more
AppDelete 4.3.1 - $7.99
AppDelete is an uninstaller that will remove not only applications but also widgets, preference panes, plugins, and screensavers along with their associated files. Without AppDelete these associated... Read more
Apple GarageBand 10.1.4 - Complete recor...
The new GarageBand is a whole music creation studio right inside your Mac -- complete with keyboard, synths, orchestral and percussion instruments, presets for guitar and voice, an entirely... Read more
Adobe Lightroom 6.8 - Import, develop, a...
Adobe Lightroom is available as part of Adobe Creative Cloud for as little as $9.99/month bundled with Photoshop CC as part of the photography package. Lightroom 6 is also available for purchase as a... Read more
iMazing 2.1.3 - Complete iOS device mana...
iMazing (was DiskAid) is the ultimate iOS device manager with capabilities far beyond what iTunes offers. With iMazing and your iOS device (iPhone, iPad, or iPod), you can: Copy music to and from... Read more
Little Snitch 3.7.1 - Alerts you about o...
Little Snitch gives you control over your private outgoing data. Track background activity As soon as your computer connects to the Internet, applications often have permission to send any... Read more
OmniPlan Pro 3.6 - Professional-grade pr...
With OmniPlan Pro, you can create logical, manageable project plans with Gantt charts, schedules, summaries, milestones, and critical paths. Break down the tasks needed to make your project a success... Read more
Apple GarageBand 10.1.4 - Complete recor...
The new GarageBand is a whole music creation studio right inside your Mac -- complete with keyboard, synths, orchestral and percussion instruments, presets for guitar and voice, an entirely... Read more

Latest Forum Discussions

See All

Galaxy on Fire 3 and four other fantasti...
Galaxy on Fire 3 - Manticore brings the series back for another round of daring space battles. It's familiar territory for folks who are familiar with the franchise. If you've beaten the game and are looking to broaden your horizons, might we... | Read more »
The best apps for your holiday gift exch...
What's that, you say? You still haven't started your holiday shopping? Don't beat yourself up over it -- a lot of people have been putting it off, too. It's become easier and easier to procrastinate gift shopping thanks to a number of apps that... | Read more »
Toca Hair Salon 3 (Education)
Toca Hair Salon 3 1.0 Device: iOS Universal Category: Education Price: $2.99, Version: 1.0 (iTunes) Description: | Read more »
Winter comes to Darkwood as Seekers Note...
MyTona, based in the chilly Siberian city of Yakutsk, has brought a little festive fun to its hidden object game Seekers Notes: Hidden Mystery. The Christmas update introduces some new inhabitants to players, and with them a chance to win plenty of... | Read more »
Bully: Anniversary Edition (Games)
Bully: Anniversary Edition 1.03.1 Device: iOS Universal Category: Games Price: $6.99, Version: 1.03.1 (iTunes) Description: *** PLEASE NOTE: This game is officially supported on the following devices: iPhone 5 and newer, iPod Touch... | Read more »
PINE GROVE (Games)
PINE GROVE 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: A pine grove where there are no footsteps of people due to continuous missing cases. The case is still unsolved and nothing has... | Read more »
Niantic teases new Pokémon announcement...
After rumors started swirling yesterday, it turns out there is an official Pokémon GO update on its way. We’ll find out what’s in store for us and our growing Pokémon collections tomorrow during the Starbucks event, but Niantic will be revealing... | Read more »
3 reasons why Nicki Minaj: The Empire is...
Nicki Minaj is as business-savvy as she is musically talented and she’s proved that by launching her own game. Designed by Glu, purveyors of other fine celebrity games like cult favorite Kim Kardashian: Hollywood, Nicki Minaj: The Empire launched... | Read more »
Clash of Clans is getting its own animat...
Riding on its unending wave of fame and success, Clash of Clans is getting an animated web series based on its Clash-A-Rama animated shorts.As opposed to the current shorts' 60 second run time, the new and improved Clash-A-Rama will be comprised of... | Read more »
Leaks hint at Pokémon GO and Starbucks C...
Leaked images from a hub for Starbucks employees suggests that a big Pokémon GO event with the coffee giant could begin this very week. The images appeared on Reddit and hint at some exciting new things to come for Niantic's smash hit game. | Read more »

Price Scanner via MacPrices.net

12-inch Retina MacBooks, Apple refurbished, n...
Apple has restocked a full line of Certified Refurbished 2016 12″ Retina MacBooks, now available for $200-$260 off MSRP. Refurbished 2015 models are available starting at $929. Apple will include a... Read more
Holiday sale: 12-inch Retina MacBook for $100...
B&H has 12″ Retina MacBooks on sale for $100 off MSRP as part of their Holiday sale. Shipping is free, and B&H charges NY sales tax only: - 12″ 1.1GHz Space Gray Retina MacBook: $1199 $100... Read more
Apple refurbished 13-inch MacBook Airs availa...
Apple has Certified Refurbished 13″ MacBook Airs available starting at $849. An Apple one-year warranty is included with each MacBook, and shipping is free: - 13″ 1.6GHz/8GB/128GB MacBook Air: $849 $... Read more
Apple refurbished iMacs available for up to $...
Apple has Certified Refurbished 2015 21″ & 27″ iMacs available for up to $350 off MSRP. Apple’s one-year warranty is standard, and shipping is free. The following models are available: - 21″ 3.... Read more
Apple’s Education discount saves up to $300 o...
Purchase a new Mac or iPad using Apple’s Education Store and take up to $300 off MSRP. All teachers, students, and staff of any educational institution qualify for the discount. Shipping is free: -... Read more
Back in stock: Apple refurbished Mac minis fr...
Apple has Certified Refurbished Mac minis available starting at $419. Apple’s one-year warranty is included with each mini, and shipping is free: - 1.4GHz Mac mini: $419 $80 off MSRP - 2.6GHz Mac... Read more
Twenty-Five Years Of Apple Laptops – A person...
Among many other things, the often tumultuous 16th year of the new century marked the 25th anniversary of Apple laptop computers, not counting the optimistically named 16-pound Mac Portable of 1989.... Read more
Landlordy iOS App Adds Support For Appliances...
Riga, Latvia based E-protect SIA is releasing major update (version 1.8) to its Landlordy app for managing rental business financials on the go. Landlordy is iPhone and iPad app designed for self-... Read more
Holiday sale, Apple iMacs for up to $200 off...
B&H Photo has 21″ and 27″ Apple iMacs on sale for up to $200 off MSRP including free shipping plus NY sales tax only: - 27″ 3.3GHz iMac 5K: $2099 $200 off MSRP - 27″ 3.2GHz/1TB Fusion iMac 5K: $... Read more
Holiday sale: Mac minis for $50 to $100 off M...
B&H Photo has Mac minis on sale for up to $100 off MSRP free shipping plus NY sales tax only: - 1.4GHz Mac mini: $449 $50 off MSRP - 2.6GHz Mac mini: $629 $70 off MSRP - 2.8GHz Mac mini: $899 $... Read more

Jobs Board

*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Retail - Multiple Positions- Trumbul...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
*Apple* Retail - Multiple Positions- Philade...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Retail - Multiple Positions- San Ant...
Job Description:SalesSpecialist - Retail Customer Service and SalesTransform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Products Tester Needed - Apple (Unit...
…we therefore look forward to put out products to quality test for durability. Apple leads the digital music revolution with its iPods and iTunes online store, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.