Main Topics for HyperTalk Reference
1. lack an item to 2et a list of Impies:
Hyp e rTa 11:T_ b a s ic s Editin2 script kga icomi
Systen-L messa2es Keywords nu-na nds Functions Properties Pra and eons nts •• H11001101K
; imp Audio Help 0% Find Ti: pie • •••):: L:IvercmeTAT t Help ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••• Set the user level to scripting Card 1 of 1
Before you ':an write :p7our own tri the Preferene es card of your Horne scripts.. yoU rclust set your slack and set your user level there yo u to (5). want it set to S2riptin2 every time 5r0 Start HyperCard.
Your current user level is: 5
lack Set to 'Ser1ptin2 if it is less than 5. •:•>iE,t !:.;(
End cif TO pie • :"...... t>s—Nx • ...::e).1.:4.2;•?•:.?
0, Find Ti: pie /via irt Ti:' S HyperTalk and scripts Card 1 of 1
HyperTall:® is HyperCard's script The followin2 2raphic shows a handler 1an2ua 2e. You use it to write En2iish-like for the mouseup event It's part of the siztements that respond to .F,7.W.s (such script of card button id 1. as when the user clicks a button or 2o es EI:1 Script of card button Id 1 IZE to a new card). 1.3••3• on mo ii se Up go next. fri HyperTalk. respDndin2 to an event is end mouseLlp called handling the event. As a scripter.. you write a specific 1:41:-Adlp...for each event that :p7ou want your slack to handle. A collection of handlers is called a script. ,TrT
End of Topic e ,sf:.);•••.:,?.P.;•?/2.1:?•!?).??.:,..:•••••:::: i".••••••?3,..,N; • p
Main Ti:' piC S What are messages? Card 1 of 3 A rrtessae. is simply an a nnoune en-tent HyperCard does the same thin2: that an event has occurred: The user has clicked the mouse, requested the answer 1. It determines the content of a to 4 * 3 added a new card to messa 2e (what just happened). a sth.c1::„. and so on. 2. It decides where to send the Ti:' undersiand messa 2es„ think of mailinig, inessa a letter to a friend. You write rs• 6.1• • •• a messa 2e and place it inside an envelope. "."4;:]•- Then you address the envelope and send it to 5.7our friend.
•
--- More ---
e 711,1 Roloted Tcpcs•
Main Ti: piC S ,,.•••••• What are messages? (contd.) Card 2 of 3
•- What's the content of a message? EHample Button) The messa 2e itself is just HyperCard's name for the event that ocieurred. Iti,rperTalk_ translations: HyperCard acts as a translatpr: it •'watches" the sick arid translates event mouseEnter into messa2e names. mouseWithin mouseLeaue Ti:' see HyperCard lam riS late events intn mouseDown messa 2e names, move the pDinter over mouseStiliDown the &le Button and click. mouseUp
--- More ---
e 711,1 Roloted Tcpcs•
Main Ti:' piC S What are messages? (cuntd) Card 3 of 3
Where does HyperCard send the message?
HyperCard determines what cibip-4:t, Once HyperCard knows b 0 th the content ithe user has acted on and uses this cif the messa (the messa 2e name) and as the ''address" for the messa2e. the destination of the messa 2e (where tJD HyperCard then sends the messa send it s ends to one of its objects: the messa 2e to the object.
• a bi,itton • a field • a card • a bac.kro.i,ti-pd. • a siaek End cif TO pie e •••••••••••••••::::?..4 711,1 Roloted Tcpcs•
Main Ti: FriC S Handling messages Card 1 of 1 As a scripter, you write messa 2e l:k4iAl.m3 On MO US eUp to resp:ind to m.F,!..454. When an *.F,$,I; P 'lb° i nd" receives a messa 2,2.. HyperCard searches end mouseLlp the objects ci.cript for a handler with the ] same name (a handler starts with the I WO rd 0 n follarATed by the name of a Boing messa 2e). If HyperCa• rd finds a match it ntriS any HyperTalk siaten-Lents in the handler until it hits an end statement. Click Related Topics for more information about openin2 For e>an-Lple„ if you want a button a script window. to respond to a mouseUp messa2e„ you would add a mouseUp messa 2e handler to its script. End cif TOpie e 711,1 Roloted Tcpcs•
Main Ti:' piC S The message-passing order Card 1 of 2
What happens if an that receives a Initially HyperCard sends messa 2es rA-.1,!;•Rair. docsw handle it? In a specific button or field or to the current card. If a button or field doesn't In this ease.. HyperCard Fosses the handle the messa2e„ it 2c, es on to the messa 2e to other objects and searches current card. From the current card, their scripts for a messa 1-.4.rd.F,:r that the messa 2o es to the followin2 matches the current rnessa 2,2. The order objects, in order: in which HyperCard passes a messa 2e to objects is called the • the current back2round message- pas s 2.72g ordey or the • the current slack ;72 S (IDE- OE. S 242 g path • the slack script of the Home slack • HyperCard its elf
--- More --- Tips 711,1 Roloted Tcpics
Main Ti: FriC S The message-passing or der (c o nt• Card 2 of 2 Ti:' see tile messa passiri 2: order in action, click eael-L of fc, 11,DTArirt butbDriS :
t Message Box)
C. Field 1 )
Button 1
Dynamic.• Path)
End cif TO pie s 711,1 Roloted Tcpics
0, Find Ti: piC Main Ti: FriC S Writing message handlers Card 1 of 2 When you write a 1-.4eK for a -.;-J.e.;4„4.2,.e., Important: The messa 2e name does 7,1ot you specify a sequence of statements for ha To- e to be one of Hyp e r Ca rd.'s built-in HyperCard to rim. Each messa 2e handler system messa 2es or commands. has the foLlow_it-t2 form. Iii;rith the italicized wo rds as pia e hold e For e>an-iple, it you wanted a new command called doub teBeep that TATould 1Dn beep trATic e, you TATould write ea tE.55•6:?1' a handler for it as follows: end ..z,csage/Yame on doub L eBeep When it runs the messa,re handler, beep HyperCard sends each line of the handler beep, as a messa 2e itself (so handlers cart call end doub L eBeep other handlers). - - - Mo r e - - - I DOM° S cdpt rips 711,1 Roloted Tcpcs•
Main Ti:' FriC S ••,.• •• • Writing message handlers ont'd) Card 2 of 2
Cif cours e, HyperCard do e s re' t 1:7110 TAT It the s ript a Is o c o nth. ins the 'Jou b I eBeep about the doub eBeep corral-arid, so handler (or if the script of any object later it will ne er be sent a uto matically in in the messa2e-passinp• path conizins r eSpenS e IDD an ent. But you can send the mouseUp messap,e will send the doub eBeep from the Messa 2e box or use 'Jou b LeBeep rnessa •/ pe„ a h eBeep it as a siztemertt in other handlers. ill send trATO beekcommands Because beep is a built-in con-inland.. HyperCard For e3,an-Lple„ the script of a eard bUtOrL b e eps twie e rrLipht contain the followin2 handler for the system messap,e mouseup: If HyperCard can't find the-1Lou_, Beepe messa pe„ it will eornplain (with a dialop on mouseUp bio>::) that it "can't undersiznd" the 'Jou b LCB22p rnessap:e. end mouseLlp End of TO pie I DOM° S or/Jo t Tip s 711,1 Roloted Tcpics
Main Ti: piC S Using parameter variables Card 1 of 1
A handler can receive values (called on mouseLlp :1 and use the In as it rt_triS tt smillessade "red", "app re" represent each value with a pAR!igtca.„ end mouseLlp yoAd*. A parameter 7.7ariable always follOTATS the handler name in a On SMIlleSSQqe coLor, fruit mma-s eparated put "1 want a" && cotor && fruit end sawrlessade For e3,an-iple„ Wh e n running the folloTATin2 MOuseUp handler, HyperCard calls You can use the variables I and Say message With two values, "red" and fru i t anywhere inside the handler. "app re" It then binds these values to the When HyperCard se es them„ it uses parameter variables co_ Ior and fruit the values currently bound to them. the sayrlessage handler. (rhe variables remain bound only while the handler 11111S ..) EndcifTOpie I DOM° Script REVorcedTcpcs
0% Find Ti: piC Main Ti:' piC S ••,••••••• INTriting function handlers Card 1 of 1
When you write a 1:4A-.14,10. for a function, on mouseUp you specify siaten-Lents that compute and put square(5) into the Message box return a Ta to the handler that calls the end mouseUp function. Each function handler has the fo no TATin fo rn-L• wh e r e the italicized function square x wo rds are pla e hip e : rPturn (x * x) end square funi- t on 7e,nc The function square recen7es a nurnber 12 n d t-e.,5-51f• t Co'51.05.7rE tl-LiDu211 its ppy.4.m..,:,•tF,:: x. It then returns the value 0 f * x to the HyperCard has many built-in functions, handler that called it (mouseUp) usin2 the but you can aLqo write your own: return keyword.
End cif TO pie I DOM° Script REVorcedTcpcs
Main Ti:' FriC S ••,••••••• The building blocks Card 1 of 1
Building0 blocks " HyperTalk ss,itts use a mu-fiber of basic buildin2 basic sources of valJAP blockL. as sourc es cif valuP A operator I I expression lack one for n-tore it-don-nation about it. constant Local. variabLP gtobal. variabte it button fietd message box seLection chunk. expression _ propertw ,..., aud cif TO pie Tlps REVorcedTcplos §
0, Find Ti: piC Main Ti: FriC S Referring to objects Card 1 of 1
Refer by You can refer to HyperCard .9k,,kcts and other name elements from a ii-,!A•••ipt.i.rtany of several ways. number i d lack_ a term in the Ref er by" list for more part information about that term. ordinal. position lack Tips for a list of synonyms that me you can use for referrin2 to objects. target
End cif Topic
1.):oes Tlps • •
• '•••,. 0, Find Ti: piC Main Ti:' FriC S Add conunents to a saipt Card 1 of 1
In HyperTalk scripts.. 17, ao hyphens (--) • Ti:' conunent s eueral lines at one e, it. -acute a comment HyperTalk dra :2: to s elect the Lines you want to all conunented lines when executin2 comment, and then choos e Comment a script from the Script menu (or press N--)
r e xa mpl e : • Ti:' "uncommene s everal lines at one e, dra to select the lines you want on mouseUp uncornment and then cho 0 e DiSpLaqS diatod box Tin: 0 Min e rtt fitim the 3i2 rift me rtIA an.=.1mPr "What?" with "No" or "Yes" (or press N-=1). put it -- the user's reptq end mouseUp
End cif TO pie • ▪ •
WYVVY,
Main Ti: FriC S •••••••••••• Close a saipt window Card 1 of 1 There are several ways to close a script To close a script window without window. If you close a window in W hie h saving your changes: you've made chan2es.• HyperCard asks you if TO U. TATant to save the chan2es Press N-. (period). before it closes the window.
To close a script window: To close a script window and save yout changes: • rack the windows close box. Press Eftter. • 'Moos e Oos e from the Edit menu (or press M-T,AT).
• Hold down N-Option and click. End cif TO pie Tips 711,1 Roloted Tcpics
Main Ti:' FriC S Debug a saipt Card 1 of 3
HyperCard ptpvides sorne us eftd tDols 2. Giek to plaee the insertion pDint for tiDubleshootin2 your up.sits. These on the line with the on or f unc t i on debui,2-$4-in2 tDols let you step throu2h a siatement that defines the handler. tia.iAm line by line as it runs„ inspeet the values of7.•,..3yiat,,Is„ and frac e the tl TAT 0 f dependin2 on where you want -,[.-.k.!•!.P.4.res • tO S tt, piaci e the insertion point on any slatement of the handler Ti:' debu2 a handler, follow these steps: that is not a eon-anent.
1. Cipen the script that eonlains the messa 2e or function handler you want to debti2.
- - - Mor e
I DOM° S c rip t Tips 711,1 Rola tad Tcpics
Main Ti:' FriC S Debug a saipt ' t •1' Card 2 of 3
3. 0-Loose Set raeckpciint from the Vial. en Hyper Card hits the chec kpo int it S2ript menu (or press ND) to set opens the script and puts a bOX arciund
a t emporarT ch1:4!4-11a4:0; the current siztement. HyperCard also displays the Debu22er menu. A ,211 e '2 kr•c, int tells HyperTalk where you want tO S tit wat2hin2 the SCTipt HyperCard es not enter the script as it n_triS • editor itself: All of HyperCard's normal menus remain in the menu ban (Because 4. Press Enter t:, save the script and the script is still runnincr• HyperCard close the script editOr Wiltd0 must preser7e the current ciDnte Xt.) But an iy the 1:4E 2.S a ChME • 5. Now. perform the action in HyperCard that will run the script (for e>an-tple, eli,2k a button). - - - Mor e Tips 711,1 Roloted Tcpics
Main Ti:' pics ••,.• •• • Debug a saipt'1,11-2 t 0 rt.,' LI) Card 3 of 3
6. 0100 se co rnma rids fro rrL ti-it L:Iebu,r,rer Step m e nu to pro c e ed. Step into Trace lack a co mina nd fo r mo r e Trace into into rma tio ab 0 tit it Go
Trace De lay__ Set Checkpoint Abort
Yar iab le Watcher Message Watcher
End ci if TO pie Tips 711,1 Roloted Tcpics
0, Find Ti: piC Ma in Ti: FriC S Move between open scripts Card 1 of 1
In HyperCard. you ':an have more To move between all open windows than one script TATindoW open at 0 ru2 e (including windows thzt C ont ain 51acks:
To move between the windows • CM.0 0 s e hie 3 • raek to aetivate the script 1;Alind0 TAT in which you want to work. • raoose an open script window from the 1:=To M e nu End cif TO pie Tips • • p § , Main Ti:' FriC S Open a script window Card 1 of 1 Objects lack any object in the list at the left to see how A bu t tOn to open its script window. A field A cord You can have rciore than one script ToVird0 TAT A background open at a tinle.• and you can leave the script A s tack window Open while you work on your slack_ As you write handlers in a script wLndoTAT.• place each HyperTalk siaten-Lent on a sin2le line. Press Option- Retiml. to break a siatement across more than one line. Press Tab to reformat the script. End cif TO pie Tips 711,1 Roloted Tcpcs• § 0, Find Ti: piC Main Ti:' FriC S ••,.• •• • Save a saipt Card 1 of 1 Cinee 5.7ou have made chan2es to a When you close an unsaved script's you can save it in 1-r,roo ways: windo TAT b Ti any method other than p'essin2 Enter, HyperCard asks if you • Ti:' save a script without c1osin2 its want to save the chan2es. script window. choose 'EaVe aiript frDm the File menu (or press N • Ti:, save a script and close its script window.. press Enter. End of TO pie Tips •r"163,, • p , Main Ti: FriC S Set the font and size of a script Card 1 of 1 T P >:1: in the script windoTATs appears For e>an-tple, tD set the font and size of in 9-point Monaco as the default. You can the script windows to 11:::1-point Geneva.. chan2e the default font and size of the type the followin2 messa 2es into the text 570 ttin script wirido TAT us ift trATO Messa box.. and press Return: PrO p e s : the scriptTextFont 2p.t the 2c: r I ptTextFn nt tn "FiR ni:!•./a " the scriptTextSize These two FTO perties affect all script windows—you can't set the font and stile of each script window separately. set the sr r i pflextS i ze to 1 0 End cif TO pie Tips REVorcedTcpcs • '•••:. Main Ti:' piC S Commands sent automatically Card 1 of 1 HyperCard sends some commands HyperCard sends he p as a messa autDmatically in response to .!•.T..:7.!:,:r.kt,s, just when the user chooses Help from the Go as it sends system messa 2es But unlike menu (or presses M-71). system rrtessa 2es.• if the command passes all the way to HyperCard. HyperCard HyperCard sends orrowK performs a built-in action. So if you trap commondKe140 I.1.1 COntr- the command, the action won't happen. en ter I riFi d.• en terKey. fun': t i onKe% keulDown„ re turn I niFietd, re turnKey. and HyperCard se Is.hc. loose and. dor-hero,' tobKew as messa 2es when the user as messa 2es when the user chooses presses a key. It automatically sends a tDol or an item from one of er r or D Log and a pp IeE..nit rnessa 2es. HyperCard's menus. It sends C • 0 e as a messa2e when the user clicks Oick Related Topics for /nore the close bo>:: of a window. infonnation about each corn/nand. EndcifTOpie e ,sf•••••;;',.:y.P.;•?p.):•5?.:.*:• 711,1 Roloted Tcpcs• Main TOpiCS •• •••• • • • Message sending orders Card 1 of 1 Eventss For some .!;:7.mts„ HyperCard automatically HwperCard startup sends a secliAene e of system n-Lessa 2es. Resume New stock For e>ample„ TAThen you close an existin2 sizek New stack in a new window by ,D p e nin 2 a rt0 th er one.. HyperCard sends the New background folloTATin2 s57stem n-Lessa 2es in order: osecard„ New cord cLoseBackground, cLoseStack, openStock, DeLete stack openBackground, openCard. EIPLete background lack an event to see the order in TAThich OPLete cord Cut card HyperCard sera: multiple system messa 2es Paste card tn resporiS e it. End cif TO pie e REVorcedTcpcs 0, Find Ti: piC Main Ti: FriC S Where messages are sent initially Card 1 of 1 Messages sent to HyperCard automatically sends system Buttons messa 2es and a few commands tri n e of three FieLds objeets: a specific. button, a speeifie field, or the The current card current card. If none of these objects handles the messa 2e, it continues a1on2 the messa passin2 order until it reaches HyperCard itself. The conunands HyperCard sends autDmatically deal with keyboard events and menu events. lack an object to see the messa2es it ':an receive frorn HyperCard. End cif TO pie e REVorcedTcpcs 0, Find Ti: pie Main Ti: FriC S appleEvent Card 1 of 2 app L2E..2rut E:.•5•IdE:.•-• ci is the 2eneral cate2ory of the event (such as Qeut rri j Id is the actual Handler: event received (such as -1 , pdoc , dosc , of Eoy' and E:•••5•1YE:•-• is the name on app L eEven t ass, i d, •=•PridPr of the application or pipe ess that sent the sea tc•m&•• ts event. is•nd app L EEven t Because Apple event commands are HyperCard sends the app L Even t usually 2enerated by other pme ess messa 2e tD the current card when it you may TATant to check make sure that receives an Apple event from another the:p, are not destructive. rack E•arnples pi)D2ram. It sends the inessa 2e at idle to see a handier. written for the Home time as soon as all pen1in2 handlers have slack., that intercepts an incomin2 Apple finished runnin2. event. --- More --- e E,:•atvp/o•E •••••:. :.:••••••••• 711,1 Roloted Tcpcs• Main Ti: FriC S appleEsrerd (cortfril) Card 2 of 2 You'll see lots of a p p teEvent messa2es in You don't have to define an a p p Lu2E..rit the messa 2e watcher when HyperCard is handler enable HyperCard to handle }jipjtrr controlled by Apple Script from Apple events. Use an app LeE..ent handler another application ordy if you need tD 2et a peek at the incomin2 Apple events or to handle them Apple events 2enerated internally TAThen yourself HyperCard rUriS Apple 'Script don't prDduce app U2E...lent messages. The app eEvent messa 2e °caws only under System version 7 .0 and later. Use the request co Mina nd within an api eEvent handler to obiain additional information about the event. End cif TO pie e • •••••-:::...:?..4 711,1 Roloted Tcpcs• Main Ti: FriC S doseBackground Card 1 of 1 cLoseBackground Handler: on cLoseBackground end cIoseBackground HyperCard s ends theI c.oseBockground messa 2e to the current card when a user (or handler) quits HyperCard, p,o es to a card whips e back,;_rmund is different from the back2round 0 f the current card, and when a bac1:z2round or slack is 'deleted. End cif TO pie e REVorcedTcpcs Main Ti:' FriC S do seCar d Card 1 of 1 cLoseCard Handler: On cLoseCard tatez.E.ts end closefard HyperCard sends the c.oseCord messa tp a card when a user (or script) ps tn annthPr card; ri.P1P1-Ps a card, backil,,roura. or sizek; or quits HyperCard. End cif TO pie e REVorcedTcpcs Main Ti: piC S doseneld Card 1 of 1 c oseF i e Ed The folio win2 actio riS s e a field, saT„7in2 any changes that were made Handler: to the text: On C LoseFieEd • 'MC En 2 0 litS ide the field s to temE ts • Movin2 the ins ertio ft. point end closeFieEd to the next field with the Tab key • Pressin2 the Enter key HyperCard sends the c toseF i e Ed • Pressin2 Shift-E to revert messa 2e to an tu-docked field when, after the field tri the last saved version editincr• a user (or handler) performs an • noin2 to another card action that clips es (that LF2„ removes the • Cktittin2 HyperCard ettion point from) the field. HyperCard sends LoseFie Ld rdy when the text actually changes. End cif TO pie e REVorcedTcpcs § Main Ti:' FriC S do seStack Card 1 of 1 cLoseStack Note: If you have more than one slack open at a tirne„ HyperCard s ends Handler: suspendE; tack, not c I oseS 1:012k. TAThen the stack ecomes inactive on L oseS tack. to temer, ts end cLoseStack HyperCard sends the c_oseStock messa tD the current card when a user (or script) opens a different slack in the current windmAT„ closes the current windoTAT, deletes the slack.. suspends HyperCard to launch an application, or quits HyperCard. End cif TO pie e REVorcedTcpcs § Main Ti:' piC S deleteBackground Card 1 of 1 d e LIR teBOCkgrOUrd Note: You cannot stop a backi2rotind fronl. b ein2 deleted by trappin2 the Handler: de e teBock dund messa 2e Iristead.• you must handle the dorienu messa 2e 0 r set On de L eteBackground the can tDe L ete 1:To/Deity for the s to te.mc ts bac1:2round. 'end de L eteBackground HyperCard s erds the de Le teBock dund messa 2e tD the card that is b ein2 deleted if no other cards in the slack share its back2round. HyperCard sends the rrtessa 2e just b efore the card disappears. End cif TO pie e 711,1 Roloted Tcpcs• Main Ti: FriC S deleteB utto n Card 1 of 1 de teteBut ton Note: You cannot stop a button fmrn being deleted by trapping the Handler: de 1 e teBu t ton message. Iristead• you must handle the dorienu message. inn de e teBu t ton to temeef, i2nd de e teBu t ton HyperCard sends the -ILe I • et _e_P:u _on messa ge tD a butbn that is being deleted lust before the button disappears. End cif TO pie e 711,1 Roloted Tcpcs• Main Ti:' piC S deleteCar d Card 1 of 1 de e teCard Note: You cannot stop a card from b ein2 deleted by trappin2 the de t e teCard Handler: message. Iristead.• you must handle the domenu rnessa 2e or it the can tEle Lete inn de e teCard r impel-1:y for the card. to temeef,ts 'end de e teCa•d HyperCard sends the de Le teCord mesa 2e to a card that is 1'ein2 deleted lust b efore the card disappears. End cif TO pie e ,sf:.);',.:,??;•?/21:?•!;• 711,1 Roloted Tcpcs• Main Ti: piC S deleteField Card 1 of 1 deLeteFieLd Note: You cannot stop a field fnpmbein2 'deleted by trappin2 the deteteFietd Handler: messa 2e. Instead, you must handle the doMenu messa2e. on deLeteFieLd end deLeteFieLd HyperCard sends the deteteField mesa 2e to a field that is bein2 deleted lust before the field disappears. End cif TO pie e REVorcedTcpcs Main Ti:' piC S del& eStack Card 1 of 1 de t e teS tack Note: You cannot stop a slack fttim being deleted by trapping the Handler: de e teS todk message. Instead, you must handle the dorienu message 0 r set the inn de e teS tack can tEle ete property- for the slack. s to Lee.. ts i2nd de e teS tack HyperCard sends the de t ete!E;todk message tp the current card of the slack that is being deleted. End cif TO pie e 711,1 Roloted Tcpcs• Main Ti: FriC S errorDialog Card 1 of 1 errorDiaLog ErrlyagETExt is lite contents of tile Handler: error g baY: that wi:itddbe dis pia ed if tile tookErrorD i a togs Fri) p e rty were On errorD i a L 011 n5c7 TE:V fciLe. tEME.•:.• end errorDiaLog HyperCard sends the errorDiaLog messa 2e and its text to the current card if it eropunters an error when the LiDckError0 i ci Logs property is set true. (*.In such a ea s the ordinary error dialo boy: is riot displayed.) End cif TO pie E,:•amplos• DOM° Script 711,1 Rola tad Tcpcs• Main Ti:' FriC S odffiel d Card 1 of 1 exitFieLd Handler: c'r12::< tF i e d to teme.ef,ts end ex i tF ieEd HyperCard sends the ex i tF ietd messa 2e tD an tu-docked field when., after elieldn:2: in a field or labbirL2 to it. a us er (or handler) r e /no es the ins e /tic, n point frorn the field without chan_rin2 any of its te34. End cif TO pie e REVorcedTcpcs Main Ti:' pies idle Card 1 of 1 idte Handler: On i d I. e ta teme.ef, ts end idte HyperCard repeatedly sends the i d e messa 2e to the current card when no other events are occurring 1.'ithat is, when all handlers have finished 1-1.innin2 and HyperCard itself isn't s erv_lit-L2 other messages). End cif TO pie e 711,1 Roloted Tcpcs• Main Ti: piC S mousenoubleClick Card 1 of 2 mouseDoub L L i ck For HyperCard to send this messa2e„ the fo 110 Win conditions must allbe true: Handler: (a) The downstroke of a second click 0 n miDuseDoub L ck follows the do Taristrok e0fa previous s to teme.ef, ts click within the double-click speed set in end mouseDoubLeCtick the Mouse control panel; and HyperCard sends this messa 2e to a 01) the second click occurs TATithin four butbn„ field, 0 r card after the mouse is pi:< els 0 f the first.; and clicked twice at the same place. When the messa2e is sent, its the only one sent (el) the second click ocel _tr S within the same dUrift 2 the second click; there's no object as the first. miDuseDown.. miDuseS ti LL Dow n or m 0 useLlp message sent after the 1:i• t - - - Mo r e - - - REVorcedTcpcs § Main Ti:' FriC S mouseDoubleClick (cot tfri) Card 2 of 2 If the user clicks repeatedly at the same location faster than the double-click speed set in the Mouse contml HyperCard treats each odd-ntunbered click as a first click and each even-ntunb eyed click as a second click End cif TO pie e • •••••-:::...:?..4 711,1 Roloted Tcpcs• Main Ti:' piC S mousen own Card 1 of 1 Flu C' USIRE101.1.111 HyperCard sends mouseDown to the current card when the user presses the Handler: mouse button down and the pointer is not in the reeizn2le of a button or field. on mouse DORI • S ea' tEMEefe end FM:11,1S 120011111 HyperCard sends the mouseDown messa 2e to a butbn or to a lou:ked field when the user presses the mouse butbn down and the pointer is inside the recizn2le of the button 0 r field. End cif TO pie e • •••••-:::...:?..4 711,1 Roloted Tcpcs• Main Ti:' FriC S mouseEnter Card 1 of 1 m o us e En ter Handler: on mouseEn ter s to teme.ef, ts end mouseEn ter HYP er Card sends the m ou seEn t en messa tD a buton or field just after the p:'inter mo v e s within its r e 12 ft 21e End cif TO pie e 711,1 Roloted Tcpcs• • • • • • • • • • • • 0, Find Ti: FriC Main Ti:' FriC S ••••••••• " • •••" •••• •••" •••• •••" •••• •••" •••• •••" •••• •••" •••• •••" ••••••• " •••• •••" •••" •• mouseLeave Card 1 of 1 flIOUSELea0-2 Handler: On rnouseLeave s to teme.efe ts 12n13 flIOUSELIROVe HyperCard sends the mouseLeove messa tD a buton or field just after the pointer moves outside its recian2le. End cif TO pie e 711,1 Roloted Tcpcs• • • • • • • • • • • • 0, Find Ti: FriC Main Ti: FriC S ••••••••• " • •••" •••• •••" •••• •••" •••• •••" •••• •••" •••• •••" •••• •••" ••••••• " •••• •••" •••" •• mouseStalDown Card 1 of 1 mousest i ttookun HyperCard s ends mousest i L mown to the current card when the user holds Handler: the mouse butbn doTATrt and the pointer is not in the recizn2le Of a button on mouseSt i [Down or field. to Lee..e2nd flIOUSeSt i WOW' HyperCard repeatedly sends the mouses t i L mown messa2e tO a button or a lqi,,,Iv•-4.TAThile the user holds the mouse button down and the pointer is inside the recizn2le of the buttin or field. End cif TOpie e 711,1 Roloted Tcpcs• Main Ti: piC S mo useUp Card 1 of 1 rnousialp HyperCard sends rnouseUp tO the current card when the user both presses and Handler: releases the mouse button while the pointer is not in the recizn2le of a button On 1110 US eU or field. tc7 tEME.•:.• 12n13 rnouseUp HyperCard sends the mouseup messa tO a button or lock,e4f. i.qct when the us et' releases the mouse buttonand the pointer is. inside the recian:2:le of the same button or field it was in when the user pressed the mouse butbn. End cif TOpie I DOM° S cdpt 711,1 Roloted Tcpcs• Main TOF1CS ••,••••••• mouseWithin. Card 1 of 1 mouseWithin Handler: On mouseWithin end mouseWithin HyperCard sends the mouseWithin messa 2e to a button or field repeatedly while the pointer is inside its rec1an2le. End cif TO pie e REVorcedTcpcs Main Ti:' piC S moveINin do w Card 1 of 1 i rdow Handler: on ndow to teme.ef, end MC0021,1 i ni3ow HyperCard sends the moveWindow mesa ,re to the auTent card when the user or a script n-Loves the Tait-LI:10 many cases.. HyperCard will send a s i i ndow messa 2e immediately before a movew ndovi messa End of TO pie e REVorcedTcpcs Main Ti:' piC S newB ackgro tin d Card 1 of 1 n e 1.1.1 BOCk qr 0 1,1111J ,.•11,1thou2h the neTATbae1c,2round will not ha T.7 e a !,4.,.-_,Ap!t with wl-deh to respond Handler: In the messa2e„ any other Rtij.!;•c!, a1on2 the messa2e-passin2 path can handle it. on newBackground to temE end newBackground HyperCard sends the neu.eockground messa 2e tD the auTent card (in this ease, the first card of idle new bael:_2,tpand) just after HyperCard creates the baell2mund. End of TO pie e 711,1 Roloted Tcpcs• Main TO FriC S nelATB utto n Card 1 of 1 new But t on Althou2}t the neTAT button will not have a with. TAThie h to r e s rid to the Handler: messa 2e.. any other obitc,,t a1on2 the messa2e-passin2 path can handle it. on n ew But t on to temE end n elm But t on HyperCard sends the rieu.,But ton messa 2e to a butbn just after HyperCard creates it. End of TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti:' FriC S ciA7 C ar d Card 1 of 1 nem:at-A iklthou211 the new card will not ha e a with which to respond the Handler: messa 2e.. any other otitcyt a1on2 the messa 2e-passin2 path can handle it. 0 n n 1.1.1 I:: a rii tEME:efe tS rld nel.1.11:a HyperCard se ndS the rieu.cord messa to the cim'ent card this case.. the new one.) just after HyperCard creates it. End cif TO pie e •••.:y.P.;•?/2.1:?.?;• 711,1 Roloted Tcpcs• Main Ti: piCS riciA7Fi el d Card 1 of 1 nei.uF e Althou2h the n e TAT field will not ha e a script, With Whieh tO reSreild tO the Handler: messa 2,2.. any other otitcyt alon2 the messa2e-passin2 path can handle it. on newF IeLd sea Lee.. ts end newF ield HyperCard sends the i eId messa 2e to a field just after HyperCard creates it. End cif TO pie e 711,1 Roloted Tcpcs• § 0, Find Ti: FriC Main Ti:' FriC S newStack Card 1 of 1 ruRiuS tack Althou:2;11 the new slack will hOt have a with which to respond the Handler: messa 2e.. any other otitcyt alon2 the messa2e-passin2 path can handle it. On ne1.1.15 ta2k. fa' fEME..•:.• i2nd newS tack HyperCard sends the negE; tock rnessa 2e to the cim'ent card this case.. the first card of the new slack) just after HyperCard creates the slack. End cif TOpie e 711,1 Roloted Tcpcs• Main TOpiCS openBackground Card 1 of 1 openBackdround Handler: On openBackdround to teme.ef, iRrid openBackdround HyperCard sends the openBockground messa 2e to the current card just after a user (or script)_ro es to a card whose backil,,round differs from the back2-round of the most recent card. End cif TO pie e 711,1 Roloted Tcpcs• Main Ti:' piC S o p enCar d Card 1 of 1 openCard Handler: 0 n 0 0 e • I:: a • d to teme.efe ts 12nd openCard HyperCard sends the open I:: o d messa2e tp the auTent card just after a user (or handler) 2o es to the card. End cif TO pie e 711,1 Roloted Tcpcs• 0, Find Ti: pie Main Ti: FriC S o p d Card 1 of 1 openFieLd Once opened for editincr, a field rt0 1on2et' receives openF i e Ed messa 2es. Handler: on openFieEd statets end openFieEd HyperCard sends the openF i e Ed messa 2e tD an tu-docked field when a user (or harp:11er) first opens it for text editin2. A user opens a field for editing either by clic1in2 in the field or by Jabbing from the previous field. End cif TO pie e ,sf•••••;;',.:,??.;•?/2.1:f?.:.*:• REVorcedTcpcs § Main Ti:' FriC S o p enStack Card 1 of 1 o pie nE; tack Note: If you have more than one slack open at a time.. HyperCard sends Handler: resumeS tack, nOt open!E; took.. TATh e n the stack becomes active. on openS tack to temE ts i2nd openS tack HyperCard sends the op e riS tock messa 2-e when a user (or handler) cn-, Ps tr, a card in a slack different from that of the most recent card. End cif TO pie e 711,1 Roloted Tcpcs• Main Ti:' piC S quit Card 1 of 1 t Handler: On OLI fa' fEME:efe fS 12nO qu i t HyperCard serds the qu i t messa to the current card when the user chooses Quit HyperCard from the File rnenu (or presses M- CA. just b efore HyperCard quits. End cif TO pie e 711,1 Roloted Tcpcs• Main Ti:' piC S restune Card 1 of 1 resume Note: HyperCard_ 1- es not send this messa 2e when its runnin2 under Handler: ladtiFinder. On resume tc7 tEME:efe tS 12nO neSUflie HyperCard sends the resume messa to the eim'ent card when HyperCard resurnes runnin2 after the user quits an application launched from HyperCard. End cif TO pie e • •••••-:::...:?..4 711,1 Roloted Tcpcs• Main Ti: piC S restuneStack Card 1 of 1 resurneS tack HyperCard s ends resurneS tack 0 rdy TAThen it is disp1a1jTin2 rf LID e Handler: than 0 rt e on resurneS tack Imp ort ant HyperCard do es not send to teme.ef, ts resu eS tack. When the user switches to i2nd resurneS tack HyperCard from another layer under MultiFinder. (lack Related TO pies for HyperCard sends the resurneS tock more infonnation about the pmpert,r,,, messa tD the current card when the the suspended .) slack's windoTATbecornes active after bein2 inactive (for eyainple„ when the user clicks in a w_indoTAT). End cif TO pie e 711,1 Roloted Tcpcs• Main Ti: FriC S sizeWindow Card 1 of 1 sizeWindow Here are the ways a window can b e resized: Handler: • The user resizes the TAILtlid0 Tic on s zeUi •dow 11.5in2 lite size bo>::. to temE • The user resizes the window end sizeWindow us irL2 the Rroll TATindo w. • The user clicks the zoon-Lbo and HyperCard sends the s i zekl i n the morn chaft 2es the TATindow size. messa 2e to the etuTent card when the • A handler set the rec t of the card user or a script resizes the window. TATirudow to a new size. many cases.. HyperCard will send a • A handler resizes all the cards in a moveWindow messa 2e inunediately after sizek by settin2 the rec t of the card a sizeWind ow message. to a new size. EndofTOpie e ,sf•••••;;',.',?.P.;•?/2.1:f?.:.*:• REVorcedTcpcs Main Ti: FriC S startUp Card 1 of 1 s tar tl_lp Handler: on s tar tl_lp to temE 12nO star tl_lp HyperCard sends the s tor tUp messa to the first card displayed when HyperCard is first slatted. End cif TO pie e 711,1 Roloted Tcpcs• • • • • • • • • • • • 0, Find TOpiC Main Ti: FriC S ••••••••• " • •••" •••• •••" •••• •••" •••• •••" •••• •••" •••• •••" •••• •••" ••••••• " •••• •••" •••" •• suspend Card 1 of 1 suspend Note: HyperCar 1- es not send this messa 2e when its runnin2 under Handler: ladtiFinder. On SUSOend tc7 tEffe&•• 12nd suspend HyperCard serds the suspend messa to the cim'ent card when a user (or harp:11er) launches an application from HyperCard with the open Commarpd• just before the applicatdon is launched. End cif TO pie e 711,1 Roloted Tcpcs• Main Ti: FriC S susp en dStack Card 1 of 1 suspendStack HyperCard sends suspends tack ordy when it is displayin2 n-Lore than one slacik. Handler: Important: HyperCa es rupt send On SUSOendS ta2k. suspen d S k when the user swithes to tc7 tEffe&•• another Lay er under MtdtiFinder. (lack 12nd suspendStack Related Topics for more information about the property the suspended.) HyperCard sends the suspendE;tick messa tD the current card when the slacik's Tairuflowbecical-Les inactive (for e>:ample.• when the user clicks another card windo End cif TO pie e 711,1 Roloted Tcpcs• f•'•••„ Main Ti: FriC S do Card 1 of 1 diD [ as c:.•-• i/in-Len 5Tott use the as fi:irm HyperCard eXec ttt e s th e script The do keyword fo re es HyperCard to 6:,Es.ic.:•••• us in 2 the OSA- c o mplia nt evaluate #.:.:!!:;!,-2•:-..-47-:477.:!::.r2L.5.- arid to sertd thies c riptin c o mpo n ent na m e d result a s a th e current card. scr et_ 1:7•••50. The value of g.?•••:;::•47.47....:'..c..!? can coniain do fieLd 1 as AppLeScript rruD r e tha 0 fie line. For e 3•:E. rnpl if yip do theScript as UserTaLk have a series of siatements in a card field called R,ample, HyperCard will apply do You can also send do fitan to each line: the Messa 2e box. do card fieLd "Exampte" End cif TO pie I DOM° Script REVorcedTcpcs Main Ti:' FriC S •••••••••••• exit Card 1 of 1 exit repeat The ex i t feinc ticvoigme arid ex i t PXit fe,nc• :•.7!f.fgqq.:•••:!,!• forrns stop the current exit :q7g..C!•7.q• messa 2e or function Contml exit to HqperCard returns to any pendin2 statements from another handler.. if any. The ex i t kerATond interrupts the current flow of control. Ex i t to HuperCard terminates all runnin2 or pendin2 handlers and cancels Ex i t repeat sends control tr, the end all pendin2 messa 2es. of a repeat structure.. endin2 execution of ill-Le loop re 2ardless of the slate of the TS t t:, leave a function handler controllin2 conditions. sets the value of the function tr, empty. End cif TOpie E,:•amplos• DOM° Script 711,1 Rola tad Tcpcs• Main TOpiCS function Card 1 of 1 f r-11: t i ri iieo!.•5•C• te,•-.L 127 e Vilhen a function is called, HyperCard t evaluates each item within the e tid- 1-ei.ef,c• t nef,..q•E•a.z parenthetical list folio win2 the function's name When the handler b e 2ixis -n-Le fund t i on keyword defines a new execute, HyperCard assi2ns each value to function I:Lai:4.y. of the specified name. a 2a,ran:Lyel;..er...7.,Viat;',1,e. in the You. call a function by placin2 parenthes es after its name.. enc1osin2 any parameters within the parentheses: Use the re turn keTWOrd Within the function definition to have the cI2t de L e teSpaces he L o fttnetion return a value in the handler that called it. If you don't use return, the The Or:1116ral lets a function evaluates t emp ty furtetion handler reeeive values sent a1on2 with the function call. End cif TO pie DOM° Script 711,1 Rola tad Tcpcs• :::::::::::::::::::::::::•:: 0% Find Ti: pie Main Ti: FriC S :::::::::::::::::::::::::::: ••••• ••••• ••••• ••••• ••••• ••••••••••• .• ••,.• •• • gb b al Card 1 of 1 q b I. 1. atej EL 1. L Global variables are not saved between s essions of HyperCard. Crlobal The g L':'bci L I e TAT o r d nukes a 7ki:igtit variables are also lost under System 6's and its contents available to any handler sin2le Finder when a user (or handler) in HyperCard. raa ruin 2 the value of a stts'erids H.rp,p e r Ca rd by la tine hin 21obal variable in any handler clun2es its another application with the open value ever/where. COrnmand. Note: YoU must use the g oba I 1:J23,7670rd in each handler declare the 21cbal variables -,ropu want tO use. End cif TOpie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main TOpiCS ••,.• •• • if (mtdtiple-statement) Card 1 of 1 i f truelf7;--F7ise then sta..teg:e'5:.ts Because each part of a complex i f [e Ise i f se then S121112 tW• e may conlain more than one statement, you must have an end i f [e se statement at the end of the structure. s ea temeef, ts ] iRrid i f The multiple-statement i f StrIACiture tests the specified condition and e>::ecutes one or more siaten-Lents if the condition is true. You use the optional e Le i f Or e L se fOnTi tO run alternative blocks of code in ease the 12 ndition folloTATin2 i f is false. End cif TO pie I DOM° S cdpt 711,1 Roloted Tcpcs• Main Ti:' piC S if (single-statement) Card 1 of 1 i f truElf75--F7lE• then ta tEME:.•5' 171• Because each part of a simple i f [e se _F tc7 EME.1 ] structure is limited to one statement., you don't need an end i I statement. i tr•eiElf7;--FalE• then ea tEME:el• You can send a one-line i I structure [e 1 se i f e frO in the Messa then ta [e se 2z tc7 EME.1 ] The sin2le-s1ztement I f structure tests for a condition and executes one sizternent if the condition is true. You use the optiorial e 1 se if Or et se fOnri to run 0 tiler blocks 0 f code in ease the condition following i f is false. End cif TO pie e E,:•amplos• 711,1 Roloted Tcpcs• § Main Ti:' FriC S n Card 1 of 1 On ...TrEac.717E:.•••7...TrE• tant /27 ] tE:.55•6:.•3' erd The on 1:eTTATOrd defines a new n-Lessa2e of the specified name. The ptio nal lets the handler receive values sent a1on2 To' Atli a messa 2e. HyperCard assi2ns each value h:iataiititiI -,!arvi4tk in the End cif TOpie I DOM° S cdpt 711,1 Roloted Tcpcs• • • 0% Find• TOpiC Main TOpiCS pass Card 1 of 1 Pass (.eY2C'q'Fi In 2eneral• a sizek should pass any Pass '.f.c7gEN7f system messa 2es that it handles so that other sizeks later in the messa2e-passing The pass kerATord ends execuidon order also 2et a chance to handle the of the current 1.14xy,*.y., and sends the rnessa2e. entire IyLe.acrF that initiated e>::ecution of the handler to the ne>t ot.i! in the For e>arnple, a mouseW i th i n handler in messa2e-pass1n2 order. your Home slack WO nit e er run if you also have a mouse• i th in handler without (Ordinarily, once a n-Lessa 2e is handled, it a pass siatement in a siackbefore Home doesw.c* continue alon2 the messa In the n-Lessa 2e-passin2 path. passin2 order.) End of TO pie e E,:•amplos• REVorcedTcpcs Main Ti: FriC S repeat Card 1 of 1 repel] t [forever If HyperCard executes a ne x t repea t siatement it returns immediately to the end repea t e 2,rinnin2 Of the repea t loop. The slaternents in a repeat forever structure repeat continuously. If HyperCard executes an ex i t repea t Siztement in the loop. it continues n_innin2 the handler stIrtin2 fitim the fint statement after end repeat. End cif TO pie I DOM° S cdpt 711,1 Roloted Tcpcs• Main Ti:' piC S repeat for Card 1 of 1 repeat [for] [t i [ries] If HyperCard executes a next repeat siatement it returns immediately to the end repeat e 2,rinnin2 of the repeat loop. The slatements in a repeat for structure repeat for a specified ntunber of tirnes. If HyperCard executes an ex i t repeat siztement in the loop. it continues nInnin2 the handler stIrtin2 fttim fint statement after end repeat. End cif TO pie I DOM° S cdpt 711,1 Roloted Tcpcs• Main Ti:' piC S repeat until Card 1 of 1 repeat unt i L...171.:.:1!!!E:11.7.;::!•71:7/6 If HyperCard executes a next repeat t_F siatement, it returns immediately to the end repeat b e :;_rinnin2 of the repeat loop. The slaternents in a repeat un t i t structure repeat as lon2 as the condition fo HO Win 2 the word unit i L is false. HyperCard cheeks the condition efore the first and any subs ecluent iterations of the loop. If HyperCard executes an ex i t repeat statement in the loop, it continues runnin2 the handler slartin2 frorn the first statement after end repeat. End cif TO pie I DOM° S cdpt 711,1 Roloted Tcpcs• Main Ti:' FriC S repeat while Card 1 of 1 t- 12 peat 1.1.11-1 i e trY.i611.7.-Fc.716 If HyperCard executes a next repeat •••••••••,•••—•••,,,t_F siaternent„ it returns immediately ID:, the end repea t b e :;_rinnin2 of the repeat loop. The slatements in a repeo t "hi e structure repeat as lon2 as the condildon folloviyiri.2 the word "hi e is true. HyperCard cheeks the condition b efore the first and any subs ecluent iterations of the loop. If HyperCard executes an ex i t repeat siztement in the loop, it continues runnin2 the handler slartin2 frorn the first siztement after end repeat. aid of TO pie I DOM° S cdpt 711,1 Roloted Tcpcs• Main TO piC S ••,.• •• • repeat with Card 1 of 1 F-1-2 p 12 t t h = The value of the variable increases tEgE.-1 t 0 6-761.-• (or decreases) by 1 durin2 each iteration EME:efe of the repeat 100p. 12t1O r-epeat If HyperCard executes anf ex repeat repeat 1.1.1 i th = statement in the loot), it continues tE,E,•-• to ,,..•5•tE,E,•-• runnin2 the handler sizt-tin2 from the ••••••••-•-•—•-•••-•-•-•,.ta tE.TrE.L5• first statement after end repeat. If end repeat HyperCard executes a next repeat statement, it returns imn-tediately to the The statements in a repeat 1.1.1 i th bie2innin2 of the repeat loop and structure repeat tultil a variable with increases '(or decreases) the ,;.7alue of the an irdtial value cd is 11,rreater variable. than (or.. in the ease of down to.. less than) the nurrib er End cif TO pie DOM° Script 711,1 Roloted Tcpcs• Main Ti:' piC S return Card 1 of 1 re turn g.?!.:1-2!•.•::•447./..„c..• The valuef the _He resu It as set by a return statement is valid ord:p, The return keyword ends execution immediately after the return statement of a harudler and in ftulction handlers., executes.; each new statement resets the returns the valuefo_ tO th P resu It to empty. handler that called the tuncb,on. If return appears in a rnessa 2e handler (as opposed to a function handler).• it ends execution of the handler and places lite value of the expression .-intn the HyperTalk fun,: H-0 /1 the resu It. End cif TO pie I DOM° S cdpt 711,1 Roloted Tcpcs• Main Ti: piC S send Card 1 of 4 send current card).. 0 r you can bypass handlers [ to ob it later in the rnessa2e-Fassin2 order that send ume.7c7.7.E.N.-me ]" - rni.:2;ht otherwise handle the rnessa2e. to I-Liper-Card You can send messa 2es tD any object send to or odr orn in the current slack, and you can send p-ogng...7"I progr an) d pr•Ceq..-1:711;•./J17 I —1 messa 2es to another slack ljput not to this program } [without reoLu] objects TATithin another slack). In the first two forms., the send e ywo rd Imp ort ant If you send a messa IDD sends a directly IDD a partiadar a card other than lite current card. ot.1!;•.q1-, or tri HyperCard. For e>an-Lple„ HyperCard esn't 2o to the card or you can send a messa 2e to an object open it. already pass ed by in the rnessa passin2 order (from a slack back tD the - - - Mo r e - E,:•amplos• DOM° S t REVorcedTcpcs Main Ti: piC S sendi:lecintd.) Card 2 of 4 For e7,a/Tiple„ if you send a messa 2e tD If the object doesn't handle the messa another slack. and the handler refers to a tl-te rnessa 2e continues along the field that's specific tD that sick., you'll get messa ge-passing path ft)Dm that point. a script eritir. If you send a messa 2e directly to HyperCard evaluates any parameters Hyper 'Card.. you ensure that no other before it sends the messa 2e, even thou2h objects will handle the messa 2e. For the entire messa 2e is in quota- tion e mple.. marks. (YOU don't need quolatiOn marks send "doMenu next" to Hyper-Cord if the messa 2e is a sin2le word.) always 13.17_ es yo tt to th e ne>t card. When an object receives a message from You can type send as a message in the send.. HyperCard sets the value cif the IvIessa 2e box. target tO the name of the object. - - - Mo r e - e 1)RP.;•;(..., REVorcedTcpcs Main TOF1CS send 1:le Card 3 of 4 The third form s ends a do scr i p t Apple .!:p• .::q :4F F J.::.c.:!• .5: is any valid exp. essiOrt Of event frorn HyperCard to another any sequene e of eon-al-Lands in the nAnnin 2 application: s riptin 2 la tLt1e s uprpc, rt edby e taret 2ram. If the izr2et 2ram is send to 41 program Hyp e r Ca rd, th e se riptin 2 la n2ua e is p-ograrz• I program id ro-ogram HyperTaIll. this program • [without repti_i] By default HyperCard waits for a reply where prt-,1_75-1:77 is the path name to the fmm the la r e t pro 2ra m b efor e iar2et prro2ram in the form o ntinuincr b ut you can spec itpr thOU t „ and ro.-01.7.-,7.651.0rep L y if you dO ri t want to wait for 0 ri e. jj tkte s tur e of a pro 2ra m o n th e same co mput er. th i s program de ri.0 te s Hyp e r Ca rd. - - - Mo r e - - - e E,:•amplos• REVorcedTcpcs Ma in TOpiCS Arty reply fro m the thi',ret pop 2ra e s Into the rg-r•ut. 711,1 Roloted Tcpcs• f•'•••,. 0, Find TOpiC Ma in TOpiCS ••,••••••• add Card 1 of 1 d d .•51!•!..7.11Le E.- • t [ C:6Y. - E )•- • Note: The container or chunk referred to must conizin a nuither. The add command adds the value of tO the nurnb er in a OD fit. ifie t• r chunk and rerlac es the contents of the coniziner or chunk with the result. (You can us e the is a Ope ra to r to see if the container is a ntu-nb er.) End cif TO piC1 e E,:•amplos• •••• • 711,1 Roloted Tcpcs• Main Ti: FriC S •• •••• • • • answer Card 1 of 3 a n s tE:,••• t If you use answer witho ut spec itvin 2 any answer itE,••• t ini th 4.. I replies. HTFI e rTa displays an OL:butbn i]nswe r tE::y• t 1.1.1 t h or as the default. Otherwise„ the last reply a n s e r tE:)••• t thrE,rJ.i1:1r :!„.:..•!•.:1,.!7!-' -1 you specify b ecomes the defatdt button. r •—• (Pressin2 Enter or Return chooses the default button.) Answer returns the name answer- f i le t [of type of the button clickedby the user in the local variable it. mswer program S..qpnt [ o f type pr•CeCEaryol—cE ] Answer autrimaideally sizes the dialo box: TI-Le form answer vi!!..!!:„.1:4. diS plays a to fit the size of the text (up to 13 lines). question ) in a dialo 2 box. The The tolz1 length of the text cannot exceed dialo 2 box: contains fitim One tp three 254 characters. butbDris„ each repines entin2 a different reply the user can select. --- More --- E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti:' FriC S arLsArer 1:lecit-Lt!di) Card 2 of 3 The fOnYL Answer fi Le displays a Answer file also sets the result t=1 direct:in/ dia 10 bo 3•:: that :pip U. use to seleet Cancel if the user clicks Cancel. 'Meek a file. the value Of the resu I t in the siatement munediately ffillOTAILI-L2 answer f i Le. answer file Sc,a:t 0 f type displays 0 nly files of a specified type: The f':'nri A n swer program „text produces application, picture.. painting Of a dialo bo>:: of all System 7-friendly pa i ri t.•=• tack.. Or text. (raek the processes currently nil-a-Lin:2: On the local plat' eholde t. for MO re machine and on any networked information about file types.) computers tD which the local machine has access. Answer f i Le returns the full pathname of the selected file in the local ,;.7ariable i t. It returns el-rip ty if the user clicks Cane el. --- More --- e .1)RP.;*; .:••••:••••••?i 711,1 Roloted Tcpcs• Main TO S answer (12 oilt)d) Card 3 of 3 A System 7-friendly piticess is a pm 2ra M Use the f-t-rr a n sine r pr °qr. a Fri r entity that's earable 0 f exchary2in2 o f ti4pe onrocea re,pe to see ordy inforrnation with another process. The types of pro 12 esses (spell checkers., word name of the selected pro 2rarn is placed in priticessors„ spreadsheets.. and s on) ithe coniainer i t. An application's 'default process type is its is a qtiotedpromptintrirtthat creator. 'So to see ordy copies of appears at the bpi:, of the dial° bo>::. HyperCard, you'd use 1.1 LD. you pro,..7ide the ntd1 strin2 for ....evq.:!.evt (that is„ " ")„ the system Fruts choose ID program For more de1iIs., see "FTC Toolbox" in to L n k. t o : at the top of the dialo 2 box. /-n s lyfa C2.72 1LOS V.6 0 r IwsiiiElyfaci-ntosh: I72teiap adz' 072 avnrz 2i722.c11117.072S End cif TO pie e • •••••-:::...:?..4 REVorcedTcpcs Main Ti:' FriC S arrowKey Card 1 of 2 arrowKeu If the 21obal property teX t Arrows is true., the arrouil(ey command naT..7i2at es If the 21obal property tex tArrows thipu211 cards unless the ins ertion point is fa the a rrokuKe y 120 inrna nd na 2a t es in a field. Then a••owKey rruDTJes the throu2h cards: ins ertion point within the field. arrowKeu left = 2o to previous card HyperCard sends the arrowKeu arrowKeu right = to ne>:t card Command to the current card when arrowKeu up 2o forward thro1i2h an arrow key is pressed. The value passed re: ent cards to the parameter variable dir•E'C' arrowKey down = backward through left, r i igh t„ up, re: ent cards Or do wn„ dependin2 0 n which arrow key is pressed. --- More --- e E-..%:•ampices• REVorcedTcpcs Main Ti:' FriC S anowKey I-1Y ft Card 2 of 2 Ti:' handle the ar r 0 messa 2e.. use the fo TATini2: fo nrc On arr K 1214 w i K 1214 to teme.efe end arrowKeq In the above form the parameter variable "hi ch K y is set to a End cif TO piC1 e REVorcedTcpcs Main Ti:' FriC S ask Card 1 of 2 ask tE:v t.i [1.1.1 i th Ask. returns the text_ entered by the user., if any, in the local variable i t. ask password [c tear I i;L.,••••V [w i th S.f,a12 If the user clicks Cancel, ask. places empty in i t. ask. fi Le tE:v i th EA:7555•E ] Ask. also sets the HyperTalk furi.cEon the The ask command displays a question r esu It tO empty if the user clicks CIE: or ) in a dialo 2 box alon2 with a te>t to cande L if the user elieks Cancel. 1.•:SD box where the user can 17/Fe a reply. The you can use the value of the r-esul t to ask. dialo autnmatically PrO T..7ides the OK detennine whether the user provides an and Cane el b utto riS . ernpty sia-11-1.2 or clicks Cane el.) 'You must check the resu It in the siatement You can supply a default reply ttsin2 inunediately after the ask command. the th Iq.::!!:117' option. The default text appears hi211.1i:2hted in the text box. --- More --- E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti:' piC S ask (ccint d) Card 2 of 2 NOte: ask autnmatically sizes the dialo NOte: ask password is different fmrn bo>:: to fit the size of the te>:t (up to settin2 the password of the slack TATith the thirteen lines). The tolzilen2th of the text Protect Sizek dial':' 2. TORth as.:. password, cannot exceed 254 characters for both the your handler must set and check any prompt and the default reply. passwords. Fisk password displays a bullet (*) Ask f Le displays a directory dialo for each character the user types and box in which you type the name of a file. encrypt the reply as a number. You can The w i th option provides a saVe this ntunber in a field to compare default name that appears in the te7,-.± bo>::. with future Fasswords. (The ask password c Lear fo dOeS ?2CILL encrypt the reply. but it dc.e3 display a bullet for each typed character.) End of TO pie e REVorcedTcpcs Main Ti:' piCS b eep Card 1 of 1 b 'Rep beep The beep con-Inland s 0 unds the Macintosh systern e ep. TPTC"-t SPer-lifY a ac,eVatqqqr, Your /via einto shbe el:Ps that rriariTJT tin-Les End cif TO pie I DOM° S cdpt 711,1 Roloted Tcpcs• Main Ti: FriC S ••,••••••• choose Card 1 of 1 CIICICIE2 t CI CI HyperCard passes the word tcoi to the choose tooltla.7•6, t L first paAw.p.tF,:y.,74.0.4.1,* and the tool ntu-nber to the second parameter where 07!:!;-..4F...!:!•.5.:..F.L.q•qq.:!•.:• is between I and variable.18. YOu can handle the choose command as follows: The choose CO rnrnand chooses the tool with the specified ntu-nber or name fitim on choose 'Atha t , too L Number the TOO is r511,,E...m.. y ea tEmE:1-5• ey end choose HyperCard sends the choos E• command to the current card when you e 110 0 S e a tool from. the Toi:ils menu. End cif TO pie E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: FriC S click at Card 1 of 1 c L i ck cit If is within the r eeizn2le of L ck at th an urdocked field. HyperCard sets c L i ck cit i th , e• the insertion point in the field. c L i ck at i th The th options specify The c i ck at Command clicks the mouse mbinatioris 0 f the comminroiKey, the frcirn within scripts. It acts e>actly as if the ':'pt i i:iriK2141 and the sh i ftKu. ittSt as if user had clicked the rruDuse on the screen. the user were holdin2 down lite key or keys while clickin2 the mouse. If is within the rec1zn2le of a button.. a .19.,.3..kpj,fitl.4 or anywhere else on the card.. HyperCard sends the mouseDouift. mousiest i L mown.. arid mouseup messa 2es to tl-Le End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti:' FriC S ••,••••••• do se Card 1 of 3 C Lose pr inti If you try tD close an unopened file.. the cLose fi Le fl l'ElY17.55•E -.•••• • ••••••••—•-••••••••••••• resuL t icr,ets F i Le not open. C 0 se [ clocumE:t in I th I ] HyperCard autDmatically closes all open c L 0 se I card ndow files when The ciose printing command ends • it runs an ex i t to HyperCard a pint Ob 'eiotis1ybeun TATith an open siaten-Lent.. pr inti riq COrrimand. • the user presses A:- (M-period).. Cr • the user quits HyperCard. The c ose f i Le command clos es a disk_ file previously opened with the open You must provide the full path name i Le commands Usually.. you 0 pen files to of the file if its rupt at the same directDry irnrort or e>pDrt te>t. AlTATays use C Lose level as HyperCard. f i Le when :you: re finished. --- More --- e Ex•amplos• 711,1 Roloted Tcpcs• Main Ti: FriC S close (120 nt d.) Card 2 of 3 The cLose [docuaEne{inlwith)] The form o lose 7J.ci7t. s ervis a commarul closes the narrLed t Apple event, while the forrrL Lose nAnnin2 doeturtent application., or desk doc•e,•T•E:e•t th S erul3 accessory. (Tile words i n and i th are a c Los Apple event. synonyn-Lous.) All Apple event-aware applicaldons Note: This 12 onunand works only TATith support the ou i t Apple event„ but they Apple event-aware applications rurtnin2 don't all S ttFpD L 0 s under System 7 on the same D•lacintosh as HyperCard. The otose C 0 rnrria rid closes an external wit. -Lc,ow—a-1 palette or If the docturient 0 r application isn't other wit'Ldo displyedby an external fttnrt.la the resu I t is set to No such Pi:in-inland or external function—and document or No such appLication as r e rruD e s it fro m the -tdo w list. appropriate. lvIore .40.??P.;•;(:•• REVorcedTcpcs Main Ti:' S close (12 0 nt d) Card 3 of 3 Thus TO ti can't show an externalw_indow once you'T,;re closed it; you'll have to create on d Lose a new one usin:2: its external command 0 r s LL tomn ts eYteinal function. end c [012 The c L ose card u) i ndow command closes the fmnbnost sick if at least two stacks are open. HyperCard also sends the c Lose command the current card TAThen the user clicl:7s the close box of the card window. You can handle the message as follows: End of TO pie e 711,1 Roloted Tcpcs• Main Ti: FriC S conunan dK eyD own Card 1 of 1 C 0 fli M d 12 14 D 0 1.1.1 You can handle the commandk: E. y 0 inn messa 2e as follows: The co MMandKeyElo wn command pmvides a way 0 f sendin2 a ::-key On C 0 Fri Fri OndK Eq4 El 0 inn E. 14 ef.7 L 6:6,6:e? event frorn a ki..4.n4im. It acts e >:a 12 tly •••••••••••••••••••••••••••••••,•••,•••,•••••••••••••• as if you had pressed a6 at the same end commondE:::e 14 0 0 1.1.1 time as the specified character. Note: command E::: e y El 0 11 is ru:'t s ent HyperCard sends the common d K ey 0 0 1.1.1 n fO r characters typed usin.2 the type comn-Land a field (if the insertion point con-inland. is set) or to the current card when the user presses a N-key combination. The value passed to the parameter variable correspDnds the key pressed. End cif TO pie E,:•amplos• DOM° Script 711,1 Rola tad Tcpcs• Main Ti: piC S co ntrolKey Card 1 of 1 COntr0 LKE0-1 HyperCard passes the followin2 nurnbers for each control key combination: The con tro Key comrciand has no built-in effect. HyperCard sends the contr.° K ey eon-a-nand the current card when a Value Key Pressed 1 a, 1-11:111) e combination 0 f the CO ritml key and 2 b , Enter another key is pressed. 3 4 d , end You can handle the con tro tKey messaie 5 .2, he p as follows: ci h, de tete on con tro LKew theKewriumber ci i , tab teere 47, end con tro Kel4 End cif TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main TO FriC S co /weft Card 1 of 4 COtTy'et- t ( fraieiE• I ccoL5-LL i• [ f r OM -1 The fonal con V 12 r t 1•'1:71' t 0 ft:n.7):7 fOr..551:7 e....5ec.7.55•E [and fo.'-..55i7 ey'lc7.55•E• ] ] returris converted mg.ie....E in tile local to lconZec7 e.•••••e:7•57••E [and .7•17:.-.1.7.4.7 variable i t. The foriyi ro..• e t CY:oL5' tc7 1••5•E:e•-• to flar:63):7 ti.6.747cE• 12 nv e rts, a The co n r t e rraTtand chan2es a .T:T4.1mt value in a chunk or (irt.cluclirt2 expressed as a valid date, time, or date variables) and places the result in that and time format to another format. chunk or conizirier. 'You us e and .1' orm7 eih7me combit'Lation You use the form from fanma t in with the first : to convert a s itua fiS wh e r e you don't want value to any two formats (often the date Hyper Card to do the corrciersion and time) a utr, ma tic a Hy. - - - Mo r e - E,:•amplos• DOM° Script Tip E 711,1 Rola tad Tcpics• Main TO S convert (lcont d) Card 2 of 4 There are four types of date formats: • date. wl-dch has one of three formats: • seconds.. a positive integer equal to [dmiName,] monthName, day, year the numb er of s econds sine e 12: 00 month/daw/wear rnidrd2ht on January 1, 19(4 month-daul-Liear • date! terns, a comma-delimited list of where daoame = sundau, sun, seven pDsitive inte 2ers equal to the Nondaul, Non, Tuesdaul, Tue, fo 110 Win 2 values: Wednesdow, Wed, Thursdow, Thur, Fridaw, Fri, Saturdaw, Or Sat 'jean, month, daul, hour, minute, second, daqNumber where daLiNumber 1 = Sundauland 7 = Saturdaw. -- More -- Tlps REVorcedTcplos Main Ti: FriC S convert (corit d) Card 3 of 4 monthriame = JanUarq, Jan, You can precede the format names date Februarui, Feb, March, Mar, Apr i arid time With an optional Flpr, miT41 June, .Jun, 1.14, Jut, produein2 the followin:2: forn-tats: August, Rug, September, Sep, October, Oct, November, Nov, abbre.,.. date Fr i , Jun 15, 3CIF1 December, or Dec Long date Fr i dow , June 15, 1 gg0 shor t date 5 /1 51/11171 • t i rue Whieh has the folloTATin2 format abbr t i me 3 : 30 PM Long time 3:30:00 PM hour : m i nu te [ :second] [t i meCif[lai4] short time 3:30 PM Where time0 Day = an Of pm -- More -- TpE REVorcedTcpcs § 0, Find Ti: pie Main Ti:' piCS ••,••••••• convert (cont d) Card 4 of 4 Note: HyperCard can handle dates from When System 7.1 is runnincr. HyperCard 11111111111 to 1213119999in all formats. It uses the date and time settirql•rs from the handles (dates from 11111 to 12/ 31./ 9999 Date 87: Time Control Panel. only in the date I terns or seconds format If you try to convert an invalid date (such as "Fr i day, Hay 50, 11;11;09.. Hyp e r Ca rd sets the HyperTalk funetion the resuLt bp "Invalid date." End of TO pie Tips REVorcedTcpcs § Main Ti: piC S copy template Card 1 of 1 cop 14 t fli p L']t2 t E.5.-97e t tO ..t The copy temp La t COnualand iyialces a copy of printing report template tEff,p t ENOME from the current sizck and moves it into the sizelc End cif TO pie e E,:•atvp/o•E 711,1 Roloted Tcpcs• Ma in Ti: FriC S ovate Card 1 of 1 1r-121J te menu :!57.:!:.!•!!':0•:!' The create stack conunand creates a new slaek ...nprnf within a handler without crea te stack. fliE/Yame i 1-1-1 pr es entJn,r the New Slack dial':' box. The [in a ne1.1.1 1.1.1 i cards in the new slack are the same size as the cards in the current slaek. The create menu command makes a new menu and adds it to the menu bar. HyperCard sets the function the resu I t HyperCard 'displays an error messa to "Cou dn t create stack . " if it can't if you try to create a menu that already create the sta_ek; otherTATise., it set the e >fiS tS r esu It empty, 'go es to the new slack.. and sends a newS tack messa 2e to the Use the put command to add menu only card in that slack (that is„ the current items to the new menu. (Oick Related card"). Topic's for TCLO e information about put.) End cif TO pie E,:•amplos• DOM° Script ,'Ps. 711,1 Rola tad Tcpcs• Main Ti: FriC S debug Card 1 of 1 debug checkPoint Gick Related Topics for information The debug checkPoint conuTarEisell about debu22in2 scripts. a permanent clv.,-,,,Y.s.cikkt in a HyperTalk ki..4T4Iv.:. When HyperCard runs a handler, the -1Le.Jug h checkpo i t 12 fin-a-nand causes HyperCard to enter the debu22er; it pauses execution of the handler and opens a script windo TAT with a box around the line with the el-Lei:I:Taint. ThiSelDnUrarEiWOrkSCIrdyWherithe user [2.2 t property is set to 5. End cif TO pie Tips REVorcedTcpcs Main Ti: FriC S delete Card 1 of 1 de L e te f You can't use con-a-nand to delete a e te [Areeneil eL2:::t anywhere e>32ept on the current ide L e te [1.7.;•eneil tal.n• from] 17.;•ei6N, card. 'de Le te 1 f ;E• I •-•-• 4. 1 Note: UsLt-1.2 ic L e te to delete a line ruD t, the same as putting crap ty int] the line: The de 1 e te command removes text from de [etc removes the final re turn a e 0 rtiairter. menu items fro M a menu, character as well as the text.. while puttin2 menus from the menu bar, and buttons crap ty into the line just removes the text. or fields fttim the cut-rent card or back,,:,rround. 'When you use the form de Leth ,jeeteE:ijttr,r-, or deeteFi e L is sent tO the object that's bein2 deleted. End cif TO pi': E,:•amplos• DOM° Script Tips 711,1 Rola tad Tcpcs• Main Ti: FriC S ••,••••••• Card 1 of 1 If yo u use t}i u. i th modem 0 ptio th IT1 0 e rn HyperCard set up ealls usLt-1.2 the rnoden-i [.mode..55Commay•512L•7 ] onrinpotpri to the modem port. For n-tore information about usirt2 mode MS with The id j a L 0 rnmand 2enerates toueh-tone HyperCard, see the Phone Dialer siaek. sounds for the di21tsin See •• _tr modem manual for valid throu2h the blacintiDsh speaker. Ti:' dial lite phone frorn HyperCard, you must either hold the handsetp:un t the speaker No t e : If you includ e a hyph e n in the 0 f your blacintiDsh 0 r use a device that numb e r„ pla e th e entire e >Tit' e s s ion in feeds MaeintDsh audio output to the quo tion rna rks e rwis e „ Hyp e r Ca rd telephone. pc rfo rms a s tra tio n b efore (J]jflCr the numb er. End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti: piC S disable Card 1 of 1 d sdb Disabled buttins don't receive d sab Le :!'..,5:e.!:-.,1:..tf:!•••• 171 mouseDown, mouseStilADown, mouseUp, or disabLe beitto, mouseDoubLeCtick messa 2es when you click them. The• di sat, Le command dims menu items., entire menus.. and buttons. It a shotteut for settin2 the e nab L e d property of a menu iten-L. menu. or buttin to fi]Lse. Ts PI'S ParLI-101: phoose dirnn-ted IYLCILU items. End cif TO pie E-..%:•ampices• DOM° Script Tips 711,1 Rola tad Tcpcs• Main Ti: piC S ••,••••••• divide Card 1 of 1 divide [cbeeRk ------. cc,neajnEr-- bw nuaber-If the result is put into a field or the Messa bOX.. it is displayed according The d i.. i de command divides the to the 2Iobal propery number FO r m t numb et' in the CO rib. efOre FLW-LIc by :!•••;:i:.,.:!7747:!•••,- and puts lite result into the (You can use the i s a operator to see cordziner. if the container is a number.) •Dividin b y 0 places I HF (fcir infirdty) into the chunk or coniziner. Division is carried out to a precision of up, to 19 decimal places. Note: The container or chunk referred to must conlain a nun-lb er. End cif TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti:' FriC S do M enu Card 1 of 2 1j Menu i thcuit cq th EpY chooses the named menu th kee,..17 ] eornmarud with the shift, option. arid) or d °Menu te.eYa..57.•E• c7.7e6 aE: keys pressed. [1.I.1i ti-ifiLlt di a og] ['iii t The d o menu comrnand performs the To determine from a script wl-dch keys action specified by idle item name arid were specified, look at para M CI ) 0 f the menu nan-te just as if the user chose the ori2ina1 eornma item ect, fro m the menu. 1.1.1 t I-I 0 t didLog byrass es the dialo 2130X that would rionnally appear after the con-I./yards Delete Sizek and Convert Slack., and, when a Lai:44-round field is selected. after Cut Field and Clear Field. --- More --- E-..%:•ampices• DOM° S t TipE 711,1 Roloted Tcpcs• Main Ti: piC S doMenu (12 0 ntd) Card 2 of 2 HyperCard sends the domenu ',kite: A domenu handler can ovenide a as a -..!-A.F,:ps•a.cre. to the current card when the rnenurlessode. user selects a menu item. is the e>act name of the menu item selected, and .•55•6:el•Le.67.•55•6* is the e>zet narne of the menu that conizins the menu iten-L. Ti:' handle the do rienu messa 2e„ US E• this forrn: on dorlenu the I tem, therlenu end dorlenu End cif TO pie Tips 711,1 Roloted Tcpcs• Main Ti:' FriC S ••,.• •• • drag Card 1 of 1 dr-ad f 0M /1 1,1 1:0 The i th ...e.;:#-e.,!• options specify drag from m t 0 i th combinations of lite commandKey, the § drag from t optionK e , and the sh i f tKey , sirrtu1atin2 i th the user holdin2 down the key or keys dr a f 0 M t 0 while dra22in2. With 4e...! The drag cornrnand simulates the user dra 211,rin the mouse manually (except that you must use the v., i th sh i ftKu2u4 ptiO ft in order to select text in a field). End cif TO pie E,:•amplos• DOM° Script REVorcedTcpcs Main Ti:' FriC S edit script Card 1 of 1 edit [the] script of ca.214ece Note: EV en thou2h HyperCard its elf is an object (it can receive messa 2es), The ed i t scr i pt command opens the it does not ha V e a script. The fo HO TAILn suipt of art object witli the HyperCard si.terrierit yields an error: script editor. edit the script of HuperCord liThen run as a statement in a handler. edi t scr i pt suspends execution of the For this cornrnand to WO rk.• the uPrI_PvP, handler until the user closes the script property must b e set to 5. editor cur activates the ca.rd....y.irkdoT.,.,T End cif TO pie .5.%:•ampices• DOM° S t 711,1 Roloted Tcpcs• § Main Ti:' FriC S enable Card 1 of 1 eriab e The e nab le COmmand enables ondy items enab L e f in H:pTerCards menus that are currently enab L e t available the user. FO r eyample„ the followin2 con-mai-Lid will not enable the The enab e command activates menu Button Info eon-a-nand in the Cbjects items., entire menus.. or buttnns that are menu unless a button is currently inactive (dimmed). Its a shortcut for selected: settin2 the enab L ed property to true. enab L e menu I tern 1 d f menu "Ob ts" End cif TO pie Ex•amplos• •••••:. 711,1 Roloted Tcpcs• Main Ti: piC S enterInField Card 1 of 1 enterInFieEd You can handle the enterInFieEd rnessa 2e as follows: HyperCard sends the enter I nF i e Ed mmand a field when the user presses on enterInFieEd Enter and the ins ettion pDint is in the field. end enterInField This eon-a-nand saves the results of any chan2es the user or a handler makes to a field and closes the field. HyperCard sends a ctoseFieEd messa 2e if the user made chan2es to the text Or sends e::.::i tFieLd if the user did not make any clun2es). End cif TO pie E,:•amplos• 711,1 Roloted Tcpcs• Main Ti:' FriC S enterKey Card 1 of 1 en terKeLl You can handle the E• n ter Key messa2e as follows: The en terKey command sends a siztement typed into the Messa 2e box on en terKel4 to the current card. ef.7 LE:.!,6:e? e, •••••••••••••••••••••••••••••••,•••,•••,•••••••••••••• end en terE:::e14 HyperCard sends the enterKey 120 mina nd the current card when the user presses the Enter key unless the insertion point is in a field, in which case HyperCard sends en ter I nF i eLd instead. End cif TO pie e E,:•amplos• 711,1 Roloted Tcpcs• § Main Ti:' piC S export paint Card 1 of 1 i2xport pa i to fi --- E..•!e...7;•E• If export paint Su''P P1s,Hyper Card sets the function the resu tt to empty; if The export paint COmmand saves a the command fails (if. for e>ample, you Paint ima 2e of the current card to the use export pa i nt when the Bmwse tool specified file. Ex por t paint works only is chos en).. Hyper Card sets the resu L t TAThen one of the tp.glts. is Chosen. in "Couldn't export paint." This command has the same effect as the Expc rt Paint menu item that appears in the File menu (when a PaLt-it tool _3i, chos en).. except that it avoids the dia lo box that pipmpts the user for a file name. End cif TO pie e E,:•atvp/o•E REVorcedTcpcs Main Ti: piC S find Card 1 of 3 find [international] of the etuTent [in fiEicl [nf marked cards] find chars [international] International considers diphthonuil,rs and [in f./..#.../.9..1 [of marked cards] diacritical niarks as it searches. I n searches curdy a specific card or find word [international] teve biack2round field. U f ffiiFk.eu-I cards [in /7Elal [of marked cards] restricts its search to marked cards. find whole [internationa[] tEve in 17cla1 [of marked cards] 1A.Then f i rid Si P Pils.• a box appears find string [international] anpund found text (cur the first port of the [in t1E1c] [of marked cards] text if the lar2ets are chscontinucrus).; the reiiL t is set to empt1.1. TIATh en fi rid fails.. The f i rid command searches for the rJA t is set to the str1n2 "riot a te7,:t strin2 in all the card and found" biac4rround fields (T,7isible Cr not) --- More --- .5.%:•ampices• DOM° Script REVorcedTcpcs Main Ti:' piC S find (cont d) Card 2 of 3 The con-trnartds f i rId, f i rid chars.. The COrrin-tardS f i nd who Le and and Ii rid word treat eaeh rd f the fi rid str i ng treat spa: es as Fart seamh strin2 as a separate search item. of the seanh strin2. For in:an-pie., For e3,ample„ find whoLe "this command" find "this command" succeeds only if HyperCard finds that is. treated as f nd " th i s" and e>a et stifle, ine1udin2 the space. The f i rid "command" The s earvh Slion P prls words must appear in order for f i rid if HyperCard finds all the WO rdS of the who Le S P seareh strin2 anywhere on the card (or any-where in the specified field). To prevent find from searchin2 in a The Taords do not have to be in order. Faitictdar field, card, Of bad:74;4'1'011114 see don tSearch in Related Topic's. --- More --- Tips REVorcedTcpcs Main Ti:' FriC S Here are the forms of f i rid types: Command Matches fi nd 'y'y' hip le or partial r i ng:3 stia rt ng fro m the beg inni ng of a %dcur']. fi nd 11 a r 3 Partial r i lig3 roy,y.the re ..he it hi n a .y.eo rd fi nd 'V° rd 'y'y' hip e wo rds o n find ri le hip le or partial r i ngs i nu:: i ng :3 paues starti ng from the beg inni rig of a %do rd. fi nd 3t r i rig Pa rt i a I r i ngs a nyw he re in,:: I i n g 3par es (ignores %do rd bo nda r i ) 1 TipE 711,1 Roloted Tcpcs• q. Find TOpiC Main TOpiCS tundio nKey Card 1 of 1 fur-ict i or-1K 1214 You can handle the furic e message as fc11 Mpte: p,,0T.c.7 must yield a number between 1 and 15. On functionKew whichKew 27eatEmeney HyperCard sends the f urict l• • end funct i onKew COmmand the current card Wh e n the user presses one of the function keys 0 n the Apple E7 The funct i onKey rnmand performs an undo, cut copy., or paste for the values 1 throu2h 4. Int e 2er values 5 thltiu:01 15 have no built-in effect. End cif TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti:' FriC S get Card 1 of 1 get E E7 C".1 1112 t [ [ID f e4L4e: t The ge t CI:Iran-and puts the value o f any e e s s io n o r pro p e rty into the local variable i t. That is.. g e t is tile same as pu t•--•—•-•-•-•••••••-•-expi-e2-72-71L-06 i tip it End cif TO pie E,:•amplos• DOM° Script 711,1 Rola tad Tcpcs• Ma in Ti:' FriC S go Card 1 of 2 [to] 110 [ t ] If you name a slack (or back:;_rround) without specit,7in2 a card. HyperCard q1:1 [ 1:L7r "7: [1:1 f 147'.'d [1:1f 71711:71fA• ] 2o es to the fint card of the slack [1:1:1] P g••• [1:1f tqL,T (or back:;_rround). 110 [ HyperCard puts empty into the function 1D1:1 [to] ,7r.g. of][4:6!(og of the resu t when the go command [ i n a newi I)) • nuol.1.11 [1.1) i thou t d t og sup," P PrIS„ it priltS "NO Such card " Or "No § such s tack." into the resu L t When it §§ The go corn/Tend lakes the user to can't 2,0 to the card or slack. a card in a slack. The ..;_c./if.!: and § fu:unyi take the user to a card trL the eurrerit slack. --- More --- E,:•amplos• D OM 0 Script 711,1 Rola tad Tcpcs• TipE § Main Ti:' pics ••,••••••• go (cortfd) Card 2 of 2 The in a ne1.1.1 w i ndow option tells If you don't us e i thou t dilDtog• the HyperCard to open a slack in another resu t is set to Cance if the user clicks window when it ,;lo es to the sizek. the "Where Is " dialo box's Caro el b tilt] n. The thou t og option tells Note: The options i n a new ndow HyperCard to :1r,0 to another sizek directly and i.'. i thout d i a log lake effect only based On the sf,g.p-,!hsel:p that are if the do CO/yanand explicitly specifies specified on the Search Paths card of the a slack 014 Ja _.. _ler n •-Le current slack. user's Home sick. If Ftprperfard can't find the sizek. it places " such s tack " into the rP-r•u t. End of Top112 Tips 711,1 Roloted Tcpcs• Main TOpiCS help Card 1 of 1 he p The he lp command:2.o es the first card You can handle the he lp messa of the HyperCard Help sizek. as follows: HyperCard sends the he • p COmmand on he lp to the current card when the user chooses tEhTeen tS Help frO M the Cc' menu end help r,Or press es a6- Note: The cornrnand go help is eqUiValent to go stack. "he p " , while the he lp COMMand fries to execute go stack. "HyperCard He p" End cif TO pie e 711,1 Roloted Tcpcs• Main Ti: piC S hi de Card 1 of 2 hide menuBar The h i de conunand removes hide titLeBar HyperCard objects and elements hide groups from view. hide card picture hide menuBar removes the menu bar hide background picture fmrn the 1-_,Dp of the screen. hide picture of hide picture of tiz5V hide tit[ eBar removes the title bar on the Roy.d...T.,,,,,Tki:doTAT. fiEid beiten'-e Us e th 0 f the e co /almonds wit}i core: • , elY.V1CCV hidin2 the menu bar. or the title bar of a E.N.tEn windoTAL may co rduse your users. -- More -- E,:•amplos• DOM° Script TipE REVorcedTcpcs Main Ti: piC S hi de (cont Card 2 of 2 The hi de groups COrnmand removes the For buttons, fields., and W—indOTATS, two-pixel ::,rray underline displayed for the h i de command is equivalent text that has the " 1,1•11.0.E• text style. The to settin.:2: the visible prOperty tO underline appears curdy after fa L2. a show gr oups con-inland. If you hide the fronfrnost document For 2raphics, the h i de command windo TAT, the next document window rein° es the card or backrround picture becomes active. Hide dO es not remove fitim view. Its the same as settin2 an in:ten-21w_indow from the TATindow the showp i ct property of the card (from iyternOr use the 1-• 1-11=• or backrround to fQl.se. cornmand to chspose of the window. End cif TOpie Tip s 711,1 Roloted Tcpics Main TOFilsCS import paint Card 1 of 1 i moor t pa i nt from fi Le If i mport pa i n t Stiff' P PriS.• Hyp er Ca rd sets e function the resu t to empty; if The i mport paint rnma loads the con-Ln-Land fails (if. for e>an-Lple, you a Paint rp to e current card n-L use i moor t pa i nt when the Bmwse tnol a file. I mpor t pa i it only works when is cho s e rL)„ Hyp e r Ca rd sets t h e resu L t one of the T-.1,aviply-_199.1s, is chosen. in "Couldn't import paint." This cm-lin-tarp:1 has the same effect as the Irnpc, rt Paint menu item that appears in the File menu (when a Paint tool is chosen), e ept that it avoids the dia b o x that pro n-Lpts the us e r for a file name. End cif TO pie e E,:•atypio•E REVorcedTcpcs Main Ti: piC S keyD own Card 1 of 1 kel4Dokurl You can handle the ke14000.1n messa2e as follows: The keypown command simulates a key press from within a handler. It acts e>actly on keyDoinn tl-leKey as if the user pressed a character fnpm the ef.7 LE:.!,6:e? e, keyboard. end keyDo 1•1•1 HyperCard sends the key Down ciommand Note: keyDown is not sent for characters to a field (if the insertion point is set) or tr, typed 11sin:2: the type comrriand. the current card TAThen the user presses a key. The value passed in the pArvaxc-.1.,F71...m. no-.47.:,::• corresponds to the key press ed. End cif TO pie ,sf.:.•;;',.',??;•?/21:?•!;•I DOM° S cdpt 711,1 Roloted Tcpcs• Main Ti:' piC S lock Card 1 of 1 Lock {messages I recen t I screen Lock screen has the same effect as settin2 Lock error diaLoos the property t ockScreen tO true: it e e nts Hyper Card from upda tin 2 the Lock messages has the same effect as set screen. L 01:1essages to true: it prevents HyperCard from sendin2 open , I ose Lock error diat g prevents error suspend , and resume SyStern messa 2es dialo 2 boxes from appearincr; instead. the alon2 the messa2e-passin2 rath. messa2e err 0 rD ji Log ErrOr:PIE=c7ge sent tr, the current card. Lock recent has the same effect as set Lock:Recent to true: it prevents aid:it-1.2 is autornatieally urdclekeci at idle HyperCard from keepin2 a T..7isual record of cards T..7isited by the user (Or a handler) in the„ Re': ent Card dial:, Y End of TOpie I DOM° Script REVorcedTcpcs Main TOpiCS ••,.• •• • ar k Card 1 of 1 mark aEL cards The mark corrayandseilthe marked mark cang' Fir:vet-17 of the specified cards to true. You can operate on the set of marked mark cards where cards with 120 inn-Lands such as pr irit.. mark cards bui finding-1 ShOW, and sor t. [international.] Iye [in fie/a] mark cards bq finding chars Mark cards where evaluates the given [ internati ona L ] [ i n fWvq.'] expression for every card in the slack. If mark cards bq finding word it value is true, the card is marked. [internationa L ] [ n fielc] mark cards bij finding whoLe Mark cards by finding rnarkseards [international.] text [in fleie] us1n2 the same mechanism as the f i rid mark cards bq finding string command. It marks cards very quickly. [internationa[] tEvt [in End cif TO pie E,:•amplos• 1 Tip E REVorcedTcpcs § q. Find Ti: pie Main Ti: FriC S ••,••••••• p Card 1 of 1 tip 14 tc7 .115•E)•-• The result is displayed in a field or the b Messa 2e box accordin2 to the 21obal property numberf ormot. wh ere .cy';:eeRk. must 120f-03.in a nurnb er (You can use the is a operatnr tr, see tt the container is a Lurnb er.) The muttipty comnund multiplies the mirth er in the coniziner or chunk by :!•••,5:,!.,.:0::!•••,- and puts the result into the container or chunk. The result is calculated to a precision of up to 19 decimal piaci es. End cif TO pie E,:•,3inpio•E 711,1 Roloted Tcpcs• Main Ti: FriC S op en Card 1 of 1 °Pen If HyperCard can't find the docurnent or open f 1' EN am e th application, it displays a directory iiialncr box and asks the user to find it. The open com.mand launches arLother HyperCard also sets the resu tD application prD2ram 0 r opens a docitunent Cande L if the user clicks CarLe el in the with another application fmm within dial° :2: box. Otherwis e„ it sets the r,,u I t HyperCard. Yu:uu must pr07.7id e the full to empty. path nan-Les for the files if they're not at the same directory level as HyperCard. If HyperCard has proble MS open the specified application (for e>ample„ there's Under the Finder in System 6„ HyperCard not ertou2h men-tory), it sets the resu tt sends the suspend system messa tr, the tO "CouLdn't open that appLication." cut-rent card b efore turnin2 over contitil to the application. End cif TO pie E,:•amplos• DOM° Script REVorcedTcpcs Main Ti: FriC S o p en tile Card 1 of 1 open Me fileAgme If HyperCard has problems opening the The open Me conuTandopensthe specified file., it sets the reuL t as specified file so that you can read dila folk WS from it and write to it. Usually. the file is an• 62;4 text file opened to allow Nonexistent file that can't b e created: irCire itirt2 or e7 Main TO FriC S o p en printing Card 1 of 1 open printing [with dialog] The open pr inti rig COmmand e You must us e the '2 lose pr inti rig a print job. It us es the current s ettin2s cm-a-nand to end a print job b e 2-un frcim th e Print Sth. ek dii1cup,rbox. with open pr inti rig If you specify the with diat og option. Hyp e r Ca rd displays the Print Da e k dia lo box., and the user can choose new s ettirys. HyperCard sets the resu L t to cance 1. if the user ks Cane eL i:itherwise, it sets the resu I t to empty. End of TO pi': e .5.%:•atvpio.E 711,1 Roloted Tcpcs• Main TO piC S open report printing Card 1 of 1 open repor t pr inti nq If you specify lthe w i th d i a tog option, open repor t pr nt no w th i a Log HyperCard 'list:lays the Print RepDrt Open repor t pr inti no dialo 2 box and the user can choose new w i th temp Late fE.).::..t settin2s. If you specify the i.i i th temp Late option. HyperCard prints the slack TATith where .tevt. is the name of a report the named report template. template in the ctuTent slack. HyperCard sets the funetion the resu tt The open report pr inti no command tO cmce if the user clicl:s Cancel in the be2ins the priD ess 0 f printin2 a slack dialo 2 box, to no such report temp Late Or part of a slaek_..) as a report. It uses the if you specify a template that doesn't current settin2s ftpm the Print Repoit exist or to empty in all other eases. dialo 2 box. YO u must use the c Los 12 pr inti riq cornrnarid to end a1-•Jo e E,run. with open report pr inti no. End cif TO pie e E,:•atvp/o•E 711,1 Roloted Tcpcs• Main Ti: FriC S play Card 1 of 3 p a 14 stop Important: HyperCard continues to run p L au' handlers and perform other actions e a sound plays. Use the command i t P 'J'-i un t i L the sour' id is done to stop a p L au' 2 terripO handler until the sound is done playing. p a 14 .7.5:;.:4/:.•:;:i7' tempo The text string notes is an urdirrdted The p ay op nunand plays a sound or sequence of words in which each word a series of notes using- a sound through represents one note. A note has the the speaker of the Macintosh (or through folk Will 2 NA OD format (Name, the audio jack if its in use). alave, and Ehiration.): PLay stop stop S the current sound irnmediatel:p7; otherwise, the sound plays until its done and stflps by itself. --- More --- E,:•atvp/o•E 7-,/?•!•:- 711,1 Roloted Tcpcs• Main Ti:' pics play (ccint'il.) Card 2 of 3 Name one of these L=tt=r=: e = eighth note a, b, c, d, e, f, g, r = = lbth note (whe•e r = r=st) t = 32nd note AccidentaL one of these characters: x = F4th note # b Octave a positive integer You don't have to specify the accidenial.• (4 is middLe C) o 0 r dttra nofa te Irdtia e Duration one of the L=tt=r=: accidenizl defatdts to none. The oc1aT,7e w, h, q, e, s, t, x and duration default to I.'.' here the same values as the previous note. • = whote not= or to 4 (ocizve) and q 1:1dttra tiO ft) for the h = haLf not= tint note. q = quarter not= --- More --- e .1)RP.;•;(:, REVorcedTcpcs § 0, Find Ti: pie Main TOpics play 1:lecintid) Card 3 of 3 in the cim'ent slack., a sizekbeing used. or Specify the note r 2et a rest. the Home slack. For eyainple: HyperCard requires more PANI re --eighth notP to play Iar2e di2itized sounds—about 22I::: for ever/ second the sound plays. A duration followed by a period (.) means a dotted note. A duration folio ed by the If HyperCard can't find the s urtid or load mu-fiber 3 means one note of a triplet. it int:, memory. the resu tt 2et5 cou L d t gad sound. If the Ti7i:11111-11 e is set HyperCard can a_31, o play di2itized sounds to if an ::%:.(-MD is usin2 the sound stored as 'grid resources. channel. or if HyperCard is ntnnin2 in the Use p Law with the name of the resoune bac1:2round. the resu I t 2ets sound i s as the sound The resource must appear of f End of TO pie e REVorcedTcpcs II Main Ti:' piC S pop Card 1 of 1 pop card If you do specify a conizin e r, pop pop card ( into I after- I befor-e puts the cards identifieation int] the [ce5u..24 of] cce.to.inee- conlainer.• and you don' t ii;_?] anywhere. You can then check the card ID or sick to The pOp card conuTandrebieves decide whether you want to return the id e ntific a tion (full card ID a s k tO tha t card. path name) of a card previously saved with the push card COmmand. If yo tt do n' t pi)] vid e a co niz in e r to hold t}te e a rd info rma tio ri.• pop ::,,Oes directly to the popped card. End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Ma in Ti: FriC S ••,••••••• print Card 1 of 3 print car-d [froM •-•• •-e t Fri nit card prints arL in-La 2e of d-Le pr irit a L ca earre nt card. The option from 7crineit to pr i n t marked car d specifies a rec1zrL2-tdar area print 1:IJ s of the card. pr n t weeeeeeeee.LTarci [from t t ] Pr int at L cards print the in-ta 2e print ( fiE id I button of e 7.7 ery card in tl-L e stack. • pr n t •••• .• e / fc7.55•E• 1.1.1j th cT401.e t pr n t Pr i n t marked cords prints a subset of tl-Le cards in tl-Le sizekbased on each The pr nit con-Ln-La rid prints card in-La 2es, cards marked property (as reflected in its the contents of fields arLdbuttorLs„ Card Info dialo bcc,:). YO U can n-Lark do c tun e nts fro n-L o e r pro 2ra rriS , or tl-L e cards witli the mark COrnrna value of any HyperTalk expression. - - - Mo r e - - - E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti: FriC S p/int (cont'd1) Card 2 of 3 Pr i nt cards prints a rari2e Pr in print the contents of the of e I-LS ecutive eards slartin2 from the specified field, preservin2 the fonts., sizes., current card. and styles of text used in the field. Pr i nt print the card specified by Print .1 i Le with opp i t i on prints a the card expression. The option from doctunent us1n2 another pro :;_rran-L. to pcJ.t2 specifies a recian2u1ar HyperCard launches the application; the area of the card. HyperCard sets the application tries to print the doe Urn e rit function the rei. L t tO "No such cord ." (The user rrii2ht see a Print lo 2 box.) if the specified card doesn't exist; otherwise., the re'[ t returns empty. If HyperCard can't find either the doctunent 0 r the application. it displays a Pr i nt be" e en, prints the 12 0 f 'tents of the directory dialo box and asks the user to speeitied button. find it. --- More --- rips 711,1 Roloted Tcpcs• Main TOpics pint (cont'd) Card 3 of 3 HyperCard also set the resu tt print Frit-its cinnce if the user clieks Cane el in the the T..7a1lie 0 f any HyperTalk expr ession. dialo bicix. Otherwise., it sets the resu It You can print the Va e s of loeal and M p t y rrinbal ,Tariable- fiPlIf e•p'essions, the eurrent selection, the If Hyper Card has prDb e MS 0 p e rtin 2 the contents of the D•lessa 2e box,. and the application (for e mpl e , there's not re s 0 f any funetion 0 r pitiperty. enott2hmemory)„ it sets the resu It to "Cou tin t open that app Ii catiOn." EN,:pressionS are printed usLn2 the settin2s pr i ntrlarq i ns, pr i nt-re>::tR qn, After printincr• the applieation prD2rram ntTextFont, pr i ntText5 ize, quits., and eontrol returns to HyperCard. pr ntTextHe i qht1 and pr i ntTextSti4 End cif TO pie Tips 711,1 Roloted Tcpics Main Ti:' FriC S push Card 1 of 1 push car-d Each call to push saves a card ID in push nang' [cif2z tank ] last-in„ first-out order. You can return to PI-Is h [1:1 ] saved locations us_in.2 the pop command. push tack Note: The word stack. that forms The push COmrnand saves the part of the sizek identification of a card in HyperCard's is optional with the push 12On-inland. men-tory. If you specify a back,,round or sizcic HyperCard stores the location of There is a limit of twenty pushes. the first card of the backi2mund or sizek. In all cases, HyperCard saves the full card If yott p p rn.0 r e than you push.. you :;_n.:1 ID and the path name for the sizek. to the Home sizek. End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti: FriC S ••,.• •• • p ut Card 1 of 2 put The contliner can b e a button, a field a pi t variable. the Message bcc.<„ the selection., a [ c•15•/..65•.k o cy:0•• el7...•.•••E••••-• pt..,.y!7.:6: expression, or a menu. If you don't sp e ify a coniziner.. HyperCard pAts the put value int] the Message bo>::, showing it if 1:1 t ' it hidden. i th menu messages Use put With i n to replace the The pu t command evaluates an contents of a cont. in er or menu„ with expression arid places the value it e 7•:tracts before to place the value at the nto„ a f ter.. or before the contents of a begng of its contents., and with after- coniziner. to append the value tr, the end of its contents. --- More --- E,:•smplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti: FriC S ptri (ccint di) Card 2 of 2 The lines of text_ that you put into a The optional ff•.-.7.4-.7.70,....:!!:4-7..y..L is a pop-up buttnn b eccane the items 0 f the OD mma-s eparated list of .1:-.4-.kAgAcrE,!. names menu that appears when you click the that HyperCard sends the current card bUttOn. wherL the user chooses one of the menu items. The ntu-nber of items in the Before you can add items in a menu., the 5..:q.4F4Fgqq4„:!::4F.! must equal the number of menu must already exist. items in. The is a C omma-separated To skip a inessa 2e name.. use an empty list of the items you want to add to the item—a nttllbetweeri two 12 0 mina S : menu. Use the sin2le character "-" t„o get u_ a 2ray line. You can put up to 64 items tr Message 1„1iwMessage 3" into a menu with a single put slatement End cif TO pie 1 Tips REVorcedTcpcs Main Ti:' FriC S react Card 1 of 1 read froM fi Le fi ENG...7"E [lJt [- ] the file. Subsequent reads continue fmm tEL7E.-] f or pc, tE176,- 'Lint i I the last pDint read. The read command reads data fmm Read continues until it has read the a file. (You must have already opened the speeified nurnber of characters or it file with the open f 112 command.) Read reaches the named ASCII character plae es the data into the local variable i t. (which can be specified as a constant: cc: on, co rn [no , end.. cat.. form feed.. quote.. Readin2 of a newly opened file starts re turn.. space.. Or tab). § from the be2innin2 0 f the file, 0 r § o ptic, na Hy at lura et er If you All characters count as dalz, includin2 use the form at - readin2 starts return characters at the end of lines„ § at characters fitim the end 0 f sraces.. and tab characters. EndcifTOpie e E,:•amplos• •••••... 711,1 Roloted Tcpcs• § Main Ti:' FriC S reply Card 1 of 2 replw 62.cr.esico'5• [with kewword )(Ott use rep Ly error E:....p.r-E2:a:71crn aEXE.e...word ] notify the Apple event sender that an rep' lw error c:)...TeresY/co error has occurred. E.,•:;e:0-6,7„,,,-0•3• is any text. ReA'epy,.4,-0,-d is an Yotteanuse repLy error E...... 41r.E=ion t=1 Apple event kerATord (a 4-character define your own error n-Lessa 2es • This strincr). form is equivalent to rep 114 E::.•;470-Eu o?? w j th keyword "errs" The Apple event The rep L y command answers an keyword 'errn'.. sets the error number. incornin2 4rple event. The reply command sets the result to No If you don't specity a key7oprd. current Apple event when there is Co'5' becomes the direct ctuTent. Apple event to handle. parameter of the reply. -- More -- e E,:•atvp/o•E 711,1 Roloted Tcpcs• Main Ti:' piC S reply (co rit Card 2 of 2 Us e r ep I y Ordy if you're hand1in2 Apple events yours elf. If HyperCard handles an Apple e ent. it will pro vide the a ppit, pria te info rrna ton in the reply. See the docurnenizidon for the s endin2 pro 2rarn to know which rep I y keywords it expects. (errs and errn are sizndard keyTATords .1) In Apple Script, you 1-rta y ne ed to reply with both a n error s trin 2 and a n e ism r ntu-nb er to tri22er an ernDr clause. End cif TO pie e ,sf:.);••••:,??;•?/21:?•!:• • •••••-:::...:?..4 711,1 Roloted Tcpcs• Main Ti:' FriC S request Card 1 of 3 r...quest E);cr.Eyin.L5. from lof program and i are interellan2eable. r.roy7r.am request 6::.•:T.:.-Elcze7 from I f A-op-an yields a valid pro ram path program id 07.r.c..c.7..•-amAg name in the fon-ft request ENT.r.Ey/c..,..5. from lof this program ZC:••••6•••••• targE• tre:07.:Pe, tE:e•-• tig.e•-•CE• t.P..e•-•CeCrT57 request appleEvent datalcLasslidi n senderlreturn idlsender id where is the narne of a request appleEvent data prc, :;_rram ilirinin2 on cornprut er with keqword ta—CE tri:7:6o7re,e Er' in network ZOne ZCoL5•E • PrreCry7.65117 applieation's si_rnatttre. yields an expression RE:AE.4.7..41-0-e is an Apple e ent 1:7_e :prr•VID rd. undersizrdable tr, the izr2et prro2ram. --- More --- E,:•atvpies• DOM° Script REVorcedTcpcs § 0% Find Ti: piC Main TO S ••,••••••• request (contd.) Card 2 of 3 The reques t command sends an Vilhen the 1zr2et pit,_rram executes the evaluate expression" Apple event from siatement, the result of the request (the HyperCard to another application. value of the expression) 2,o es into the local variable i t. You can use this eon-al-Land to send an expression to any pro ram that Ti: the izric_ret pro _rrarn report-, an error, unde rs rids the sindard e.ci I Apple HyperCard sets the result with an error event. messa2e. The expression you use rnust b e You use the reques t app eEven t fOrrnS undersiandable to the lar2et ,rram. to e e the data and attributes of an For nail-Tile., if the 1zr2et priDram is Me 0 min:2: Apple event. another HyperCard, the expression can be any valid HyperTalk e>pressi --- More --- e 711,1 Roloted Tcpcs• Main Ti:' pics request (contd.) Card 3 of 3 You can 0 /ydt the rc,,,5-6- parameter from the pro 2ra M path name when the lar2et computer is in the same zone as the sour): e computer. You 12 a n omit the ea-peen-05re" te,- parameter if the izr2et prcu,rram is runnin 2 n the san-Le computer as HyperCard. You can pass the user selection frorn thP ns e progr m C rnrna nd as th e 070,-oc.756-am parameter. End cif TO pie e • •••••-:::...:?..4 711,1 Roloted Tcpcs• Main Ti:' FriC S reset Card 1 of 1 rese t menuBar- RE•SE• t pa in reinsiztes the default values reset pr in niq for all the paintin2 prDperties„ reset pa i nt as folloTeVS: Reset menuBar restores the menu bar brush tex tAl• idn: Left to Hyperfards sta_ruiArd menus. Reset centered: faLe tFont : Genewo pr- inti ng restores the default values for fi [Led: fatse te tHe dht : 115 the printin2 prDperties„ as follows: dr id: faL se tPx zP : 12 L i neS i ze : 1 te- t'S IDA Le: plain pr i ntrlard i ns : 0, 0, 0, 0 muttipte: fatse printTextFa idn: [eft mu L t i Space : 1 pr i n tTex tFon t : GerP.,ea pattern : 12 pr i ritTextHe i dht :1 3 po L LIS i des : pr ntTextS ze : 10 pr i ntTextSty Le: plain End cif TO pie e ••••••••••••••••••-:::...:?..4 711,1 Roloted Tcpcs• § Main Ti: piC S returnInField Card 1 of 1 returnInFieEd HyperCard autDmatically sends the return I iiF ieEd command to a field when The returnInFieLd comrnand places the user presses Return and a return character at the position of the the insertion point is in the field. insertion point in a held. You can handle thet re .urn I Fie -I If the au to Tab property of the field is messa2e as follows: true and the ins ettion point is on the last line of the field and the field is any type on returnInFieLd e7<12ept Ser011incr• thef re _urn I .n. Fi -I —_ —a —tEoEn — — — — — — — coffin-Land does not insert a return end returninFieEd character but instead sends the tabKey COrrayand the field. End cif TOpie e REVorcedTcpcs Main TOpiCS r et ur n Key Card 1 of 1 returnKeLl You can handle thef re_urn_ey messa as folio WS The returnKey command sends a siztement typed into the Messa 2e box On returnKew to the current card. end returnKew HyperCard sends the returnKey eommand the current card when the user presses the Return key unless the ettiOft Feint is in a field in which case HyperCard sends return I e instead End cif TO pie e 711,1 Roloted Tcpcs• Main Ti:' piC S run Card 1 of 1 U send "run" to c.:11/Ec.t The run conuTandexecutes an OSA script. Usedinanyotherway• run does riO thin 2. End cif TO pie e El:•amplos• REVorcedTcpcs Ma in Ti:' FriC S save Card 1 of 1 save [this] stack as [stack] (iYEA7A7e If the specified sizelc already exists, .r.avim stack ly /E.LeamE HyperCard sets the value of the •esu t as [stack] I/ E)••••ii757•E• tO " ciju t dup t i ca te s tack " 101A can test whether HyperCard saved the The save COrnrnand saves a eopy stiek successfully as follows: of a sick. Its the same as choosin2 save A co FT frOM the File menu.. save this stack as "Mu C OpiA" but it doesn't 'display a iiireetory dialog if the resu Li: is not emptu then box. Use save when you don't want a dialo box to interrupt a handler. The form save [this] stack saves a copy Of the current sizelc. End cif TOpie e .5.%:•ampices• 711,1 Roloted Tcpcs• Main TOpies select Card 1 of 2 12 L2ct empty The se tec t command selects se ect tut to...5. buttons. fields. Or te 3 - - - Mo re - E,:* ample E DOM° Script 711,1 Rola tad Tcpcs• Main Ti:' piC S select (el:int:el) Card 2 of 2 Se L ec t crap ty removes the current Sc L ec t .c.,".?yne.;: applies to a specified ran2e selection. Use se lect empty instead of teyt in the Messa 2e box or in a field to of c i ck at to deselect text or object,. one or more lines in a list field or to a line (that is., a n.merrd item) in a ForruF, Sc Le,: t te)::t applies to all the text in button. a field or in the Messa box. You. 12 an select all the text or place the insertion In the Messa 2e box or in a field you can point b efore the first character or after the select the entire ran2e of text or place the last character of text. ins eition point b efore the first character or after the last character of the ran2e. End cif TO pie Ras 711,1 Roloted Tcpcs• Main Ti: FriC S set Card 1 of 1 set [the] The set command chan2es the site set [the] pt ° f ' of a specified property. If lite otdnat, or t1:1 element to which the property belo 1. 1, 27S is not specified.. the poppet-1y must be a •E2 t [ f 21obal property 0 r paintin2 property. 1:1:1 set [the] proper tu of [,!F;:;!•2q1...z.lge..• of] You can use the Info dialo bo>:: of an '55::!:e•!' to f:.),•Z:!•:::•••••!,...1,.::!•:e5. object to set many of its prDperldes. set [the] cif •';;:n.r.'6: of fEJd to n-Lust yield a valid s ettin2 kir the specified pi)Dpet-ty. End cif TO pie E,:•amplos• DOM° Script Tips 711,1 Rola tad Tcpcs• Main Ti: FriC S ••,••••••• show Card 1 of 2 show menuSar show [at 4:E..q/....qt1 show titLPSar show EvtEr:11y71.2://,•5•donY [at pol?1•t show groups The show command displays HyperCard show al.!. cards objects and elements. show marked cards show cards Show menuSar displays the menu bar at „the top of the sere en (unless the sere en show card picture is loci:lea). !E;how t i t LeBar show background picture displays the title bar on the cia„rc...... T6T.incloy.,:•!.T. show picture of if its been hidden. (I./or/Tally, the title bar show picture of isyrs' ble.) show field [at in ] show t toef,t ] -- More -- E,:•amplos• DOM° Script Tip E REVorcedTcpcs Main Ti:' piC S show (cont d) Card 2 of 2 I-I 1.1.I groups displays a two-pixel 11,rray The other f rillS 0 f the shou., con-in-tat-id underline for all te>:t that has the group clis pia Ti the card or back2round pieture„ text style. (By default, the group text a window„ or an object at a specified is incyis. ) The underline appears for location on the screen. If the po_int is not 2rouped text in every field (in all slaeks). ,riven„ the TATiftd0 W or object is displayed Use the hi groups conunand to at its previous location. remove the underline. SI-Lowin2 a vi,TindarAT makes it the The show cord fonns display the fronianost TATindow. Tkl 'Atli external specified cards in the current sick windows, an .,;:;7t.F,Tnal....!;.,;9:14Ygnd in turn, be2innin2 With the next eard external funetion must first ereate a or the next marked card. TATtndo b e to re sh01.1.1 Will WO rk on it. show do es not create TAT'S End of TO pie 711,1 Roloted Tcpcs• Main Ti: FriC S sort Card 1 of 3 t sort [c/5.ei..5.,ea of] b1-1 [Fn-eStqle] [this] stack [sr.r.t.27/rEctic.....d [bw •71-ir [marked] c▪ ards [of this stack] -1 where ithein,ez are limited to either lines ------or iten-is (See neyt card for delzils.) bq The first five forms 0 f the SO t •71-11-1: command 0 rder all the cards in a sizek or back2rDund the value •71-ir [marked] c▪ ards of tAy.p.ITY of evaluated for each card ka-6q6Ctiafl in the sizek 0 t• backwound. bq 14ore E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• § q. Find Ti: pie Main Ti: /J1.. C S ••,••••••• sort (Cont'd) Card 2 of 3 The last fo fin of the sor t ccimiyiarid S:irt directio ri '':2riui i ng Orden' qnitc4 lines or items of a the sort elements—the value of the coniziner by any expression. If you don't expression on each card or the lines specify, sor t rd e rs by lines. Before or items in the coniziner—fttim lo Tic er IDD is evaluated for each line or hip;her values. item of the coniziner the local variable each is set to the contents of the chtu-Lk. Sort direction descend i ng orders the sort (lack the R,:amples buton tp see s:p7niax elements frD rri 1-er JD 1 ID er values. examples•itus.,.,-142: each.) Sort style te>,:t compares the sort For all forms of the sor t command, elen-Lents based on their ASCII values: the default sort directdon is ascend i and the default sort style is text. "1" "101" 112" "a" < "ab" < --- More --- e E,:•amplos• 711,1 Roloted Tcpcs• Main Tupics sort (cont'd.) Card 3 of 3 Note that neither case nor diacritical The sort Style dateT i me Orders the SO rt n-La rks matter TATitl-L the sort style t ex t : elements by their date or time format. (See the conver t 12 CI n-Ln-Land for valid date "app Le" = "APPLE" = "app Le" and tin-Le formats) '3:1rt style numer i c COrreetly sorts The sort style i nternot i ono L correctly ntu-nb e With sort style t ex t , sorts nor!: ErL2lish text conizinin2 (diacritical marks and special characters 111" "100' < "17" based on the international resoun-2 e insizlled in the the current sizek.• the The 13 0 rt style numer C CI rreetly sorts Hon-Le slack.. HyperCard itself.. r the these values as: System file. 111" 112" "17" "100" End cif TO pie e 711,1 Roloted Tcpcs• Main Ti:' FriC S start using Card 1 of 1 start using 470.:;', HyperCard records the full path name of the slacks bein2 used as lines in the The start us i rig COrrirnand inserts the global property the stocks I nUse. YOu specified slack into the messa2e-pass1ng earl add up to 16 slacks. order between the current slack and the HO M e slack' (or between the current slack The first slack in use is on line 1 of the and any other slacks bein2 used). stacks I nUse„ the second slack is on line 2 of the stacks I nUse.. arid so on. The order Handlers in the slack script of the newly of items in the Stacks I nUse determines inserted slack can inten ept messa 2es as the messa2e-pass1n2 order the messa 2es move throu2h the from the current slack line 1 of the messa2e-passin2 order. Stocks I nUse„ In line 2„ and S 0 on, to the Home slack. End cif TO pie E,:•amplos• 711,1 Roloted Tcpcs• Main Ti:' pies stop using Card 1 of 1 stop using The stop us i ng COmrnand removes a slack from the rft essa 2e-passin2 order. Handlers in the slack script of the rernOVed slack will no 1on2erbe a T•.;ra for use to the current slack. End cif TO pie E,:•atvp/o•E 711,1 Roloted Tcpcs• Main Ti: FriC S ••,••••••• subtract Card 1 of 1 sub tr act fr on) o f For e>ample.• if you say ccoi• tal..L5•Er sub trac t 3 from theTo where coNtfi-n E 0 r 612 U 72 n-Lust c rit. irt a numb er. and this, Tota[ previously held 7.. it will no W hold 4. The subtract command subtracts from lite specified container (or ch11rd,, and puts the result int:, the C10 rdziner (or chunk), re1 p-12n it what was there. (You can use the is a Ope To to r to see if the conthiner is a ritu-nber) End cif TO pie E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: FriC S ••,.• •• • tali Key Card 1 of 1 tabk:ey The tabKey comiyiarid ope LS fields in the folloTATin2 order: fro rft. the lowest to The tabKey Command opens the the 1-441-Lest nurnb ered bad:12round field first urdocked field on the current card or then fitim the lowest to the 1-d21-Lest back2round (placin2 the insertion pDint numbered card field. the field) and selects its entire contents. HyperCard sends the tabKey command If a field is already Open for editincr, to a field or the current card when the thbr: ey closes it and opens the next user presses the Tab key. You can handle editble field., selectin2 its contents. the thbKey messa 2e as follows: (A field is edilable only if it is unlocked and T.7iS e on tobE:::e14 •t L E end thbKeul End cif TO pie E,:•amplos• DOM° Script 711,1 Rola tad Tcpcs• Main Ti: FriC S type Card 1 of 1 To perfon-n a menu '2i:in-inland. tuipe th COMMand use ithe fonm type th c mmand Key For e>an-iple. if yott have a The type command acts e7,:actly as if the 2rapl-de on the lapboard, you can paste i user had typied ftpm the keyboard. with the comrnarufl The text appears in the Messa 2e box tupe "V" with commandKeu when its T.7islile (or also when it's hidden if bL i rpflyp i rpg is s et tO true). Ti:' type text into a field or add paint text.. a handler must first set the insertion point (usin2 either the se t Or cdi at 120 Mil-End) End of TO pie .5..!,:•amplos• DOM° S t 711,1 Roloted Tcpcs• § Main Ti:' FriC S ••,.• •• • unlock Card 1 of 1 unlock {screen' messageslrecent) ac tiO LS n the card, and then urdock the unlock error dialogs screen with a visual effect. unlock screen th ei.ect [47Tff:q] [ t° ] Unlock messages let open, close, unlock screen with visual [effect] suspend, and resume messa 2es traverse kegqi [t° ,•0-7.f] the rriessa 2e-passin2 path. Un lock screen lets HyperCard uplate Un L ock recent lets HyperCard keep a the screen after a Lock screen visual record of visited cards in the Recent commarui. (rack the pike eholderS Cards dialo :2: box. f prgcf, 4,7f•f:L,7; and .i.T.57aq; 11:1 s e e their possble replac ements Un L error dial ':'ql lets HyperCard show erttir dialo boxes when an eritir artionally, you can add a sin2le visual e airs effect. You can lock the screen.. perform End cif TO pie E-..!,:•ampices• DOM° S t REVorcedTcpcs Main Ti:' FriC S u mn ar k Card 1 of 1 ururn']rk. WA cards The unmark Conunand sets the marked unmark piroperty of the specified cards to fa se. Us e it tri deselect sets of cards that you unmark cards where have marked. unmark cards bij finding [charslwordl who[elstring] Unmark cords where TASill eacheardin [internationa[] the sick and evaluates the expression. If tEve [in 2.1/c7] [of marked cards] it value is true, HyperCard uraTarks the card. Unmark cards by finding unmarks cards us1n2 the same mechanism as the f ind corm-arid. It unrnarks cards very quieldy. End cif TO pie E,:•amplos• Tip E REVorcedTcpcs Main Ti: piC S visual Card 1 of 1 i SU a L [e f fec t ] [q)d The to i,".5.:57,97q: optic, n chan,res the screen [ to 1."71•7e ] to white., 2ra y„ b la el:7_, inV e e „ or the it-fa :2:e of the destination card The i sUO t COrnmand specifies a visual before app1yin2 the visual effect. effect for HyperCard to use as it rcuDves frlDm one card tn another. (lack the HyperCard uses the visual effect pi Lain pike eholde I'S 4Fgiqqq; and as its default effect. The defatdt ima to see their possIde replac ements ) IS card. i suo t must b e folio TAT ed by a go COMMand have any effect. Note: Ordy the effects push.. scro shr i rik..s tre tch„ and ZOOM work with The optional pçc parameter tells the command go th is card. HyperCard to perform the 7.7isua1 effect faster or slower than normal. End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• § Main Ti:' FriC S w ait Card 1 of 1 [ for [ticks] If you do rcit specify seconds as the unit [ f 'Dr seconds 0 f time, Hyper Card us es ticks (One tie 1'7_ L•in t i t equals one-si•tieth of a second) white The "cii t command causes HyperCard to use before executin2 the rest of a l.:L.4TvAltr,„ either for a specific 1en2th of tirne„ until a specified coraition becomes true., or while a specified i:ijriditjcin re iris true. End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• § Main Ti: piC S 'write Card 1 of 1 kur- i te tE:)••• t fi Le fiieNc.7...Z•E• The - r riptinn- • - • b P rrifif rrritin. Cr at [a t ( eo f I end I [- ] tE-1•61-11 characters from the file's end. The vir i te command copies text to a file. Warning: HyperCard does not ask if you You must have already opened the file want to write 0 er e >:is tin t e with the open fiLe COmmarld arid you shotdd clos e it when Writirt if: co rripleted Subsequent kw i te cornrnands append with the c Lose f i Le COmmand. text to the file's '2i:intents after the last character written until you close the file. The first Kir i te command after openin2 a file b e Rins at the start of a file unless you Not e : You must Fp] vid e frt. e full pith use the at option.. with name of the file if its not at the same as the character position within the file directpi-y level as HyperCard. vi,Th e r e wr1tin2 is to b e End cif TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: piCS at) s Card 1 of 1 the abs 0. Value returned: number equal tO the absolute value of End cif TO pi': E,:•amplos• REVorcedTcpcs § 0, Find Ti: piC Main Ti: FriC S •• •••• • • • annuity Card 1 of 1 e.12) An interest rate involves a certain pen ent (expTess ed as a deeinlal) per where r e pr e s e nts the some urdt of time—usually per year. You filtered rate (ex:pressed as a decimal) must use the same unit of time to and represents the nurnber measure the ntunber of periods. of periods 0 T.7 er which you receive annuity payments. For example, if you have a yearly percent. 2e rate but :p7our annuity pays Value returned: the totl cost of an you montldy„ use rate / 12, and b e sure anriuity now that will pay you one urdt to express the ntunber 0 f periods as per period over the specified ntunber of months (2 years = 24 months). periods, ':'r a number equal to - 11 + rate) -periods) / rate End cif TO pie e E,:•amplos• REVorcedTcpcs Main Ti: FriC S atan Card 1 of 1 the tan o f Value returned: nurnb e r eqttil tO the tri 2o no m e an, th.rt,rerit of express ed in radians Note: There are 2 pi radiarts in 360 de2rees. End cif TO pi': E,:•amplos• 711,1 Roloted Tcpcs• § 0, Find Ti: piC Main Ti:' FriC S average Card 1 of 1 17'1E'r-I]q121•••• Value returned: numb er eqttil tO the arithmetic av era 2e of the cornma- s eparated list of nurnb ers End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti: FriC S ••,••••••• charToNtun Card 1 of 1 tb2 c r- T o riurn 0 f Value returned: po sitiv e int e 2er e qua 1 to the T•yalue of the ..2!;:c7.!:: End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• § 0% Find Ti: piC Main Ti: FriC S ••,••••••• dickChunk Card 1 of 1 the cLickChunk The chun1:7_ expressiori returned has the Value returned: character chunk followin2 fon-n: expression equal the word the user clicked or the lon2est ran2e of characters chcmP.P„. 1:1:1 with the tint style Gtoup around the of character that the user clicked (if the text has been 2rouped1 The text style Group allows the 12 i CkChUnk. to extend b e:p7ond word boundaries. End of TO pie E,:•amplos• DOM° S t Tip E 711,1 Roloted Tcpcs• Main Ti:' FriC S ••,••••••• dickH and diekV Card 1 of 1 the c L i ckH the L ick.V Values returned: L i ckH retun-is an inte2er equal to the ntunber of horizontal pixels fro in the left side of the card to the place the mouse was last clicked. L i ck.V returns an inte 2er equal to the mu-fiber 0 f vertical pixels from the top of the card to the place the mouse was Last clicked. End cif TO pie E,:•amplos• DOM° S t Tip E 711,1 Roloted Tcpcs• Main Ti: FriC S dickLine Card 1 of 1 the i:L i ckL i rue The chun.1,1 ex:pression returned has the follOWin 2 form: Value returned: line chunk expression equal to the line that the user clicked or. if Line the text has been 2rouped• the first line of the 1on2est ran2e of lines with the text style GnDup around the character that the us er elkked The text style Group allows the c[ i ':kL inc to extend b e:p7ond one line. End cif TO pie E,:•amplos• DOM° Script 711,1 Rola tad Tcpcs• Main Ti:' piC S dickLoc Card 1 of 1 the C i CkL0C Value returned: equal to the place on the screen where the user most reci entl:p7 clicked relative to the top left corner of tile current card HyperCard does not reset the c L i ckLoc at idte, nor do es it reset when a handler is runnincr. urdess you use the up] i t cionimarufl: i t unt i L the mouse!: Li ck End of TO pie I DOM° S crpt Tips 711,1 Roloted Tcp.its Main Ti: piC S dickText Card 1 of 1 the cLickText Value returned: teYt strin2 equal to the word the user clicked or the lon2est 12 0 riti 21_10 US S triri 0 f ha ra c ten TATith th e text style Group anDund the character that the user clicked The te style Gro up a 110 WS the i ckTex t to e xt e nd b e yo nd wo rd boundaries. End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Ma in Ti:' FriC S o nun an dK ey Card 1 of 1 the commandKey the cmdKey T•iIalue returned: either of the 12011SiZrOS up or down, derieridirl2 TAThether the M key is ur., or down End cif TOpie E,:•amplos• DOM° Script Tip E 711,1 Rola tad Tcpcs• Main TOpiCS ••,••••••• comp o un d Card 1 of 1 compound(kgt.:1, neait'Erl) An interest rate invoh7es a c ertin pen enia 2e (expressed as a decin-lial) per where r epr es ents the some urdt of time—usually per year. You filtered rate (expressed as a decimal) must use the same unit of time to and represents the ntu-nber measure the number of periods. of periods over which the interest iS rrtF0 tulded. For e>ample, if you have a yearly interest rate that is compDunded TCLO :p70 tt Value returned: value of one unit of must convert the principal invested at the interest rate and yearly rate to the interest pet' month comFounded over the specified nu.rnber (rate 2) and b e sure to express the of periods, or a mu-fiber equal mu-fiber 0 f periOCIS as months to + ra te ) per i ods (2 years = 24 months). End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti: FriC S COS Card 1 of 1 the cos o f Value returned: nurnb e r e civa 1 to th e tri no e o s e o f express ed in radians Note: There are 2 pi radiarts in 360 de2rees. End cif TO piC1 E,:•amplos• 711,1 Roloted Tcpcs• § 0, Find Ti: piC Main Ti: FriC S date Card 1 of 1 the [adiec-t/h.E] date ) When HyperCard is runnin2 under Value returned: te7,:t strin.2 reprresentin.r, System 7.1„ the loncr, abbrev.. and short the current date set in your Nlacirttosli. in forn-is a 2re e With the fonnats set in the the follovoirt2 date fot-mats: Date 6: Time Control Panel. the date 12/25/q::: The forin. the Eng i sh date returns the datP( ) 12/25/cn date in the form day, Ar,onth the abbrev date Sat, DP.: 25, 11:11:1:7: :veartle usin2 en2lish weekdays the shor t date 12 /25 and months no matter what lan2ua 2e the the Long date Saturdaw, system is localized for and no matter December 25, 11;11D3 what the s ettin:2,s are on the Date ,12z Tirne the EngLish date Saturdaul, flintjril Panel. December. 25, 1 EndcifTOpiepi E-..%:•ampices• DOM° S t Tip E REVorcedTcpcs /Via It. Ti:' FriC S destinatio n Card 1 of 1 the destination Value returned: e full path nameof the sizek that HyperCard is in the pitie ess of pp1n2 to (as in I ns i :HyperCard :Home) End cif TO pie e E,:•amplos• • • Main Ti:' piC S diskSp ace Card 1 of 1 the diskSpace [of disk dikName] Value returned: a positive 1nte2er equal to tl-te mirth er of bytes of free space on the chsk that contains the current slack or of the disk whose name appears inci.i4.,Yame (assurnin2 C7_40;5557E' is a mounted voltune). End of TO pie E,:•amplos• DOM° S t Tip E 711,1 Roloted Tcpcs• Main Ti: FriC S ••,••••••• exp., expl„ exp2 Card 1 of 1 the exp of exp2 returns a number equal to 2 raised the expl of to the pDwer of :!•••;:i!.e74,6:!•••,- the exp2 of Note: e 2 .71 82:31:3 Values returned: i2xp returns a number equal to the 12 0 riS iant e raised to the pDwer of neprebEY- exo returns a nurnber equal IDD 1 less than e raised to the power of nioro,tf.fr. End cif TO pie E,:•atvp/o•E 711,1 Roloted Tcpcs• Main Ti: piC S to un dChunk Card 1 of 1 the f ou rd Chunk Value returned: a character chunl::_ e 7•pression that indicates where the most recent f i rid command located its 1ar2et strin2. If nothin2 was found, it returns i2mpty. The chtu-Lk expression returned has the follo Win 2 form: o f c•col• ea End cif TO pie E,:•amplos• DOM° S t Tips 711,1 Roloted Tcpcs• Main Ti: FriC S toundField Card 1 of 1 the foundF i e Ld Value returned: a field expression that identifies the field in wl-dch the most reeent f i nd cornmand loeated its th.r2et strin2. If nothin2 was found, it returns iRrnp ty. The field expression returned has 0 fie of the follo Win 2 forms: card fieLd n bkgnd fieLd v,There is the mu-fiber of the field. End cif TO pie E,:•amplos• DOM° Script Tip E 711,1 Rola tad Tcpcs• Main Ti: piC S toundLine Card 1 of 1 the foundLine where i is the line number and 15' is the nurnber of the field. Value returned: a line expression equal to the line of a field where the most recent Note: A return character determines f i nd command located its lar2et strin2. If a line, not the line wrap. A line that TATraps nothin2 was found, it returns empty. and is displayed as two lines is treated as one line by HyperTalk• The line ex:pression has the f011OWitt2 fOITCL: L i ne of card f Line / of bkgnd fieLd End cif TOpie E,:•amplos• DOM° S t Ras 711,1 Roloted Tcpcs• Main TOpiCS to un dl'ext Card 1 of 1 the fourdText Value returned: a strin2 equal to the characters enclosed in the box after rnost recent f i nd C'Orcayand has located it 1zr2et strin2.It r tbit TATas found, it returns empty. End cif TO pie E,:•amplos• DOM° t Tips 711,1 Roloted Tcpcs• Main Ti: piC S heap S p ace Card 1 of 1 the heapSpaCe The available mernory detetmines Value returned: a mu-fiber equal whether the user can use the Paint tDols, to the amount of workin2 n-Lemot-y whether HyperCard can open a sick in a HyperCard has left (the number of bytes new window. and Other remainin2 in HyperCard's application perfonnane e-related factors. heap) The memory that HyperCard can use is divided into two parts—the heap and the slack. S tackspace returns the amount men-tot7,7 that's available in the sizek portion. HeapSpace returns the amount available in the heap portion. End of TO pie 711,1 Roloted Tcpcs• § Main Ti: piC S ••,••••••• Value returned: the number of chara 12 ten in the T.7a1ue of the expression E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• 0% Find Ti: FriC Main Ti: FriC S inl„ log2 Card 1 of 1 the En of the Eril of neizot.Er the Loq2 of \Talues returned: 1 n returns a number equal to the bas e- e or natural 1o2aritl-a-n 0 f returns a numb er equal to the natural parithm of 1 + •••:•.F.4-!f?,•-••• L n2 re tun-is a ntirl-b er equal t:, the base-2 lc, patitl-a-n. of :••••••,..5.5.5:4-..:q.,:::•• End cif TO pie E,:•amplos• Tip E REVorcedTcpcs Main Ti: piC S m ax Card 1 of 1 MID X ree.i..7.11LeEl•-•L • t Value returned: the hi2I-Lest-valued ntu-nber fitim the comma-separated list of ntu-nli ers End cif TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti:' piC S menus Card 1 of 1 the fliehLIS Value returned: a return-separated list of the names of the menus in the current menu bar If HyperCard is runnin2 tinder System 7.. the list includes the System 7 n-tenus (such as System Help and Application). Note: The strinp: App te is a synon:prm for the *menu. End cif TO pie E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: piC S ••,••••••• min Card 1 of 1 • iii I 1'1 1, ,.•511./...7.2-..E.•:4...!::4-.7)71) Value returned: the numb er with the lowest value fitim the comma-separated list of narnbers End cif TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti:' piC S mouse Card 1 of 1 the mouse Value returned: one cif the constants up or down indicatin2 whether the mouse button is up or dO Note: Use the mouse to return the current slate of the mouse buttnn and the mouseCtick tp return whether the mouse has been elieked in the eurrent handler. End cif TO pie E,:•amplos• DOM° Script 711,1 Rola tad Tcpcs• Main Ti: FriC S mouseClick Card 1 of 1 the mouseCtick Value returned: the conslant true Note: TS e M 0 Use r etm-L if Ithe mouse has been clicked sometime the current slate of the rnouse during the running of the current handler, button and the mouseC t i ck to Or fi] L se if it hasn't. return whether the mouse has been clicked in the current handler. If lite mouse button is down, the mouse': Li ck waits uritil the mouse buttnn is up b e fo re re turnin true End cif TOpie E,:•amplos• DOM° Script rips 711,1 Rola tad Tcpcs• Main TOpieS ••,.• •• • mouseH and mouseV Card 1 of 1 the mouseH the rnouse1y1 Values returned: mouseH retun-is an inte 2er equal to the ntunber of pixels from the left of the card to the current location of the n-tous e pointer. mouse1y1 returns an inte 2er equal to the nturiber 0 f pixels from the top of the card to the cim'ent location of the /YLO us e pointer. End cif TO pie E,:•amplos• Tip E 711,1 Roloted Tcpcs• Main Ti:' FriC S mo useLio Card 1 of 1 t h e S el_ C Value returned: a equal to the urr ent s itio n 0 f the me, us e po int e r re1atjie to th e curr e nt card End C if TO pie E,:* mp ce DOM° S c rip t Tips. 711,1 Rola tad Tcpcs• Ma in Ti: piC S /nun b er Card 1 of 2 the number of [card] {buttonsIparts Values returned: A non-ne2ative inte 2er the number 0 f bkgnd {buttonslports} equal one 0 f the fo HO Win 2: the number 0 f cord fieLds the number f [bkgnd] fieLds • total nurrber of blAtbDriS or fields on ithe current card or back2round the number of morked cords the number of cards [in k-..!:.A • tolz1 number of Felts (butbons and [of this stack] fields combined) on the current card the number of bkgnds[of this stock] or back:L.rrOund the number of windows • total number of marked cards, the number of menus cards in a specific back,rrourd the number of menultems of cards in an entire sizck, or the number of LLn back2rounds in a slack --- More --- E,:•amplos• DOM° S t 711,1 Roloted Tcpc Tip E § 0% Find Topic Main Ti: piC S munber (cont d) Card 2 of 2 • number of all the wiridaras (inc1udin2 built-in palettes and extental TAT_indows) in HyperCard • rum:rib e r of /a-terms in the menu bar or the ntunber 0 f menu items in a specified menu • tntal number of characters., words., itis.. or lines in the ,;.7a1ue of any HyperTalk expression (treated as text) End cif TO pie Tips 711,1 Roloted Tcpics Main Ti: piC S /nun To Char Card 1 of 1 tIu2 ruurruTi:uCbijr o f Value returned: th e ha ra 12 t e r TATIO S e A S I e quiva e nt equals ,:,-.9-,74-.7.:!!:,vg-ger- End C if TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• § 0% Find Ti: piC Ma in Ti: piC S offset Card 1 of 1 Offset( tE:)••• el, tE:v ta?) Value returned: the number 1:::1 if „t" does not appear in otherwise., a pDsitive inte 2er equal to the ntualber of characters from the first character of fq.:.:!•::t2 to the first character of veleyvt/ within End cif TO pie E,:•amplos• DOM° S t rips 711,1 Roloted Tcpcs• Main Ti:' piC S optionKey Card 1 of 1 the optionKey Value returned: one cif the co ns nts up 0 r down inflic a tiri wh e e the OptiO rt key is up or do wn End ci if TO pie E,:* amp/0 E DOM° Script 711,1 Rola tad Tcpcs• Ma in Ti: FriC S p ar am Card 1 of 1 the Par-a M f Value returned: the value (as opposed to the name) of a paraAy.qe.i7...7.a.riable. in the current haviAlvq, or empty if the parameter variable doesn't exist The pa-am of 0 is the narne of the messa 2e its elf. End of TOpie E,:•amplos• DOM° S t Tip E 711,1 Roloted Tcpcs• Main Ti: piC S ••,.• •• • p anunCo unt Card 1 of 1 the paraniCoun t Value returned: a positive inte 2er equal to the trilal ntu-nber of pqr4.rrp:tm passed IDD the cuff e fit 1-..4:41.1,ET End cif TO pie I DOM° S cdpt 711,1 Roloted Tcpcs• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • :::::::::::::::::.:.:.:.:. : • 0% Find Ti: pie Main Ti:' piC S ••••••••• • • • •••• • ••• • •••• • ••• • •••• •••• • •••• •••• • •••• • ••• • •••• • ••• • •••• • •••••• • • •• • •••• •••• • •••• • ••• • •••• • •••••• • • • ••• • •. • p ar am s Card 1 of 1 the pararns Value returned: a text strin2 equal to the entire 2a.rap:k.0.;.q• list, inc1udin2 the mesa ,re name., passed to the currently e>ecutin2 baD41,;•••K End cif TO pie I DOM° S cdpt rips 711,1 Roloted Tcpcs• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • :::::::::::::::::.:.:.:.:. : • 0% Find Ti: pie Main Ti:' piC S ••••••••• • • • •••• • ••• • •••• • ••• • •••• •••• • •••• •••• • •••• • ••• • •••• • ••• • •••• • •••••• • • •• • •••• •••• • •••• • ••• • •••• • •••••• • • • ••• • •. • programs Card 1 of 1 the programs [ o f mach i 1•112 " a71:-.:••5•E• -1'..117C11 Value returned: a return-delimited list of applications currently runnin2 on the same machine as HyperCard If you use the optional form of mach i rie ZIT.:••5•E :.1.!.1.0C•11 , you 2et a list of Apple event-aware p:i,rrams runnin 2 0 n a rernote machine. This function requires System 7 tr, TAT 0 1.1,1 (See Demo Script) End cif TO pie E,:* amp.' ce DOM° S t 711,1 Rola tad Tcpcs• Main Ti: FriC S ••,••••••• ran dom Card 1 of 1 the random of Value returned: a random inte2er between I and Random returns values for inte,c4ers up, to 2/.731 - 2. End cif TO pie I DOM° Script Tlps •r"••••?)... • WYVVY, : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : • : • : • : • : • : • : : • : • : • : • : • : : : : : : : : : : : : : : :0, : : : Find Ti: piC Main Ti: FriC S • : • : • : • : • : • : • : • • : • : • : • • : • : • : • : • : • : • : • : • : • • : • : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : • • • • • • • • • • • • • • • • • • • • • • • result Card 1 of 1 the resuLt In handlers., its usually b est to test a eommand TATit}t an expression such as Values returned: if the resuLt is not emptw then otheTJalueseaTa return keyword durin2 the execution of a messa That way. the handler do esn't rely on the specific value of a strin2. *empty if most comiyandssuPPPPA otherwise., a IYLessa,re strin2 Click Related Topics for n-iore information about the value returned by the resu it for each 12 0 rcayand. End cif TO pie E-..%:•ampices• DOM° S t 711,1 Roloted Tcpcs• Main Ti: piC S round Card 1 of 1 I-112 t- 0 d 0 f • Value returned: the inte2er nearest to Odd inte2ers plus eyaetly 0.5 mund up; even inte2ers (or 1::)) plus e>:actly 0.5 riptuld If is ne:Iratic.7e.. HyperCard internally ren-loves the nepative si2n, rounds its absolute value.. then put the ne2ative back on. End cif TO pi': El:•amplos• 711,1 Roloted Tcpcs• Main Ti: piC S savenRect Card 1 of 1 thP scr-eenRect If the c.q.d.T.AT.indqw appears on rnore than one mordton the screenRect returns Value returned: a :!'.-vq:c.,..67.rcz,::••• equal to the the dimensions of the screen that shows dimensions of the screen in pixels the most area fttim the card window. If there's more than one monitor. the screenRect returns the dimensions of the monitor displayin2 the current slack as offseth from the top-left conter of the sere en that conizins the menu bar. End cif TO pi': E,:*s.mplos• DOM° Script Tips 711,1 Rola tad Tcpcs• Main Ti: piC S seconds Card 1 of 1 the seconds the •=.pc-=. Value returned: an inte 2er equal IDD the nurnb er of seconds between rilidrdat Januar/ 1.. 1904., and the auTent time set in your computer End cif TO pie I DOM° S or/Jo t Tips 711,1 Roloted Tcpics :::::::::::::::::::::::::• 0% Find Ti: piC Main Ti: FriC S :::::::::::::::::::::::::::: • • • • • • • • • • • • • • • • • .• ••• •• • • • select e dB utto n Card 1 of 1 the se ec tedBu „orl o f If no butbn in the specified family is [ bac kg t' und I card ] fair, i y n tEr:41:.•-• 1-Li21-di2hted• se ec tedBu t ton returns empty. Value returned: the domain and ntunber e>an-tple, card but ton 31:1 Of the If the specified family doesn't exist you hi 2111i 2ht ed button in the specified button get an ertpr dialo 2 box. family on the current card or back2round If you don't speccard (Or cd) or background (Or bg Or bkgrid).• the farclily is assumed to be on the card layer. End cif TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: FriC S selectedChunk Card 1 of 1 the se ec tedChunk Value returned: a character chunl::_ e 7•pression that indicates the ran,re characters currently 1-d2h1i2hted If nothin2 is 11121-di2hted, the se L ec tedcmunk returns emp ty The churd::_ •pression returned has the followin:2: form: chor to o f 1...•5•E:.— End cif TO pie E,:•amplos• DOM° rp t Tlps 711,1 Roloted Tcpics Main Ti:' piC S selectedField Card 1 of 1 the setectedFieEd Value returned: a field expression that indicates the field in which a rar12e of characters is currently 1-d2h1i2hted. If nothin2 is hi211.1i2hted. it returns empty. The field ex:pression rettu-ned has one of the folloTATin2 forrriS: card fieLd n bkgnd fieEd v,There is the number of the field. End cif TO pie E,:•amplos• DOM° t Tips 711,1 Roloted Tcpcs• Main Ti:' FriC S selectedLine Card 1 of 2 the seLectedLine *for the setectedLine of iLF6.7/61c4 the seLectedLine of lizn,c,1,L,7' a line expression that indicates the the .7PLectedLine of 07.47,&SM lines of a k#,..?.ix.kin WhiC111 the characters are currently 1-d21-di2hted Values returned: *for the se Lected_ i ne of pc.pe,pRvetc. •for the selected_ ine, a line a line expression that evaluates to e>pression that indicates the line of a the line mu-fiber in a pDpupbutbn's field ':'r the Messa bo>:: in wl-dch a contents 1ndicatin2 the current ran2 e of characters is currently s election 1-d2h1i2hted It nothin2 is selected, the se Lected_ i ne returns empty. --- More --- E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• § Main Ti:' piC S selectedLine ' 1' Card 2 of 2 If a field isn't currently a list field but it Line • of (cQrdlbkgnd} fieLd n was in the past.. and a selection lud b e en Line / of (cordlbkgnd} button n made when it was a list field, the Line x to s." of (cardlbkgnd} fieLd se ectedL ire returns the n-Lost recent selection. where i is the line number and .••• is the ntunber of a popupbutbn or a field, and The line expression returned has the x to is a ran2e of lines in a kstlif14. fonns: End cif TO pie Tips REVorcedTcpcs Main Ti:' FriC S selectedLoc Card 1 of 1 the Se eC tedLOC Value returned: a pc.•,:,:••••5:f equal to the left and ID o tbm offsets of the ins e ttion point or the current selection in a field It returns emp ty if there is no selectiot-i or if the ins ettion Feint is it. the Messa End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti:' piC S ••,••••••• selectedText Card 1 of 1 the setectedText the seLectPdTP•t nf the '7PLPI2tPdTPXt nf on::47.LT.15ivt i.Talue returned: a st-it_12 equal to the ran2e of characte etuTently selected. If notl-Lin2 is 1-d21-di2hted, it returns empty. If a field isn't currently a list field but it was in the past and a selection had e en made when it was a list field, the se LectedText returns the n-Lost recent selection. End cif TO pie I DOM° •5cdpt Tips REVorcedTcpcs Main Ti:' piC S ••,••••••• s hitt K ey Card 1 of 1 the shiftKey Value returned: one cif the consiants up or d 1.1.1 n indica tin 2 TAThether the Shift key is up or doTATn End cif TO pie E,:•amplos• DOM° Script Tip E 711,1 Roloted Tcpcs• Main Ti: piC S sin Card 1 of 1 the Sin DI Value returned: a ntunber equal to the tri2onon-Letric sine of :!7)!.,7,-„,!:•:- expressed in rachans Note: There are 2 pi radiarts in 360 de2rees. End cif TO pie E,:•amplos• REVorcedTcpcs Main Ti: piC S ••,••••••• so un d Card 1 of 1 the SOUnIJ Value returned: a te:!,± strin2 equal to the name of the SOUnd reSOuree urr e nt_157 pia yin 2 (s ue h as "boi ng111:1 or the strin2 "d 0 ne " if no sound is urr ently pla yin 2. You use the sound function to synchnDnize sounds with Other actionS„ beca us e scripts eontinUe to run while sounds are p1ayi1L2. End cif TOpie E,:•amplos• Tip E 711,1 Roloted Tcpc Main TOpieS s grt Card 1 of 1 the sq r- t o f Value returned: a mu-fiber equal to the square root of If ne,rative., sqrt returns NI A NI which means ....not a mu-I-ben'. End cif TO pie E,:•atvp/o•E 711,1 Roloted Tcpcs• § 0, Find Ti: piC Main Ti:' FriC S stacks Card 1 of 1 the s tacks Value returned: a return-separated list of the full path names for all the open sizeks., in front4D-bac1: order End cif TO pie E,:•amplos• DOM° Script 711,1 Rola tad Tcpcs• Main Ti:' piC S stackS p ace Card 1 of 1 the stackSpace The mernoty in HyperCard's s k s t a ckSpa ce determines, for e>ample„ the number of times you can call a recursive handler. put the stackSpace into howNuch Value returned: art integer represenbn2 the free space.. in bytes.. in HyperCards mernOry S12121:7_ The rrte/TIOry that HyperCard can use is divided into two parts—the heap and the SIZCL Heapspace returns the an-tount of meirtory that's available in the heap pDitiort. StackSpace returns the amount that's available in the sizek portion. End cif TOpie E,:•amplos• Tip E REVorcedTcpcs Main Ti:' piCS stun Card 1 of 1 •1- - • • S M ••••• - Value returned: the stun of a comma- delimited list of items .•7/•,!?,74.....?:.f.t evaluates to a comma-delirrdted list of items., includin2 any coniainer holdin2 such a list. End cif Topic E,:•amplos• DOM° S t : • - .e? .? : : • Main Ti: piC S systemVersion Card 1 of 1 the s s t e m 1y1 ersion Value returned: a de:LI-nal st-il-L2 reprresentin2 the runnin2 T....rersion of s ys t e SO ftwa r e Use this function, for eyample, to deter-II-Line if a partiadar comn-Land or handler Tall run 1201TeCtly under the current version of the system software. End cif TOpie e i".••••••?3,.. • • E-..!,:•amplos• •••••••••••:•••••••••:.:::::::•,4 1.>/?•!•:- Main TOpiCS tan Card 1 of 1 the tan o •-• • -.•-• Value returned: a nturib e r equal to th e tri ro e 13.112 e fit of e >press ed in radians Note: There are 2 pi radiarts in 360 de2rees. End cif TO piC1 E,:•amplos• 711,1 Roloted Tcpcs• § 0, Find Ti:' piC Main Ti: FriC S target Card 1 of 1 the [adiec-tive] target ',kite: the abbrev i a ted target is the same as the target. Value returned: a te:!,± strin2 that identifies the that oril;_rinally receives a HyperTa11:7_ distin_ruishes between the mtssajige. s ent by HyperCard or by the target and target: the target always send keyword. If an obi ect does not have returns a strin2 that identifies an object, a name.. the target returns its ID. but the sin2le word target is a container. The adjectives o.J.Jrev.oted, 0 n g arid short return T..7ariolis forms of an If the target is a button or field., object's name as with the property the target refers to the contents of that name raek Related Topics for more button ':'r field. If not, target returns an information about name.) error. End cif TO pie E,:•amplos• DOM° Script 711,1 Rola tad Tcpcs• Main Ti:' piC S ticks Card 1 of 1 the ticks Value returned: an inte2er equal to the ntu-nber 0 f tic ks sine e the Macintosh was turned Cin resiatt ed. (Cine tick equals one-sixtieth of a second) End cif TO pie I DOM° S crpt s 711,1 Roloted Tcp.its 0% Find Ti: piC Main Ti:' FriC S ••••••••••••••••••••••••••••••••••••••••••••• ••,••••••• time Card 1 of 1 the [adiec-tivE] time t i me When HyperCard is rurinin2 under '7,,,qtem 7.1. the Inn,., abbre— and ohnrt Value returned: A text strin2 representin2 fo rMS a 2re e With the formats set in the the current time set in :p7our Nlacintnsh. in Date ,12z Time Control Panel. one of the followin2 time formats: The form the Engl. i sh time returns the the time 9:14 An time in the fonyi ..05,05• AM I PM fuD t i ) 9:14 All matter what lan21a 2e the system is the abbrev time 9:14 AM localized for and no matter what the the •=•hort t i me 9:14 AM settin2s are on the Date b: Tirrie the Long time 9:14:42 AM Panel. the EngLish time 9:14:42 AM End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti: FriC S tool Card 1 of 1 the tO0 Value returned: a text strin2 equal to the name of the currently chosen tDol (that is.. the !:c•:..1:::!:'.47.!55:6' (lack tc,a./.610,55,e fora list of all the trDol riaiales.) End cif TO pie E-..%:•ampices• TipE 711,1 Roloted Tcpcs• Main Ti:' piC S ••,••••••• tr un Card 1 of 1 the trunc o f Value returned: an inte 2er eclual to the inte 2er part of :!-.5.y!5.5.4,.:q.:!-•-••• Any fractional part is chsre2arded. re 2ardless of the number's 5i2n. Note: trunc returns correct values ordy for real mu-fibers in the rarL2e -2..147.• 483..648 thrott2h 2, I 47..483,647 (the ma 3 End cif TO pi': E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: FriC S value Card 1 of 1 the vaLue of Value returned: the value of the When the arzu-nent of %...atue is a e 7 There is no limit to the number of put value("HyperCard 2.2") characters that the va tue can have as its ar2urnent. yields HyperCard 2.2 End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti: piC S 'windows Card 1 of 1 1:1-112 i 1•113 S Value returned: a return-separated list of the names of all the windows (includin2 built-in palettes) in front-tD-back order If the ongll i ndowT i t is true., the wi ndows returns full path names for windows tl-ta t o niz in s ,21s End cif Ti: pie E,:* amp' ce DOM° S t rips •r"163,, • p .? , • '•••:. Main Ti:' FriC S ad dress Card 1 of 1 get the address yields HyperText:Quitte:HyperCard This read-ordy property tells you where on the AppleTalk netrATork you are, in the If you're runnin2 HyperCa fd n an fonn. C•CoNly ,0:..--os.7ra.m. If zr.:•••e unrtan-Led co mprut e r that's 's 11.0 t 0 n a is an asterisk 1)„ either your system is not network, yo ft e t on a network or the network has just one HwperCord SD if you're rurinin2 HyperCard on a This propetty requires S3,7stern 7. 0 0 r mpruter named Quille on a ZOne called later. HyperTe>t„ the siztement put the address End of TO pie e E,:•amplos• • • Main Ti: piC S •• •••• • • • autoHilite Card 1 of 1 set [the] autoHi Li te of but er.)•5• The autoH i Li te prOperty C1OrrespDru3s to tin 6-L..60-FaJ se the Auto Hilite check box in a Button Info dialo box. The autoHi Li te propel-17,1T sets or returns whether a button hi2h1i2hts aubmatically Automatic 1-Li21-di2hEn2 occurs if in resporise to a mouse:10km everit. au toH i Li te IS Set tO true. With check boxes and radio butbro„ au told i Li te deterrnines whether the butbn can chan2e frorn deselected b selected and vice versa. End cif TOpie e Examples. 711,1 Roloted Tcpcs• § Main Ti: piC S autoS elect Card 1 of 2 set [the] au toSe ec t of flEld Auton-Latie 1-d2hli2htin2 occurs if te-ven-Fal e,:t , I ockTex t , and dont-It-op are all set to true. The au toSe ec t property sets 'Dr returns whether lines in a 1,Deked field hi111i2ht Au t 1VE; e ec t is set to false when dontHrap autnmatically in response to a mouseDown is set tO false.; don tHrap is set to true event and to dra2,2in2 or shift-eli,2kin2. wheri autc,Se t is set to true. r,'Such fields are called Yst For au toSe Lu2ct affect more than one line in a loi2ked field, that field's The au toSe Lect property corresponds tO mu tt i p i ries property n-Lust also be se the Auto Select check box in a Field Info to truP. dial':' g b 3•:: --- More --- e 711,1 Roloted Tcpcs• Main Ti:' piC S atTloSelect (cont'f-1.) Card 2 of 2 Ti:' learn which lines are selected. 2et the se lectedL i ne 0 f field Ti:' learn the COntents of those lines.. 2et the se LectedText of flEid Ti:' FireS eleet use se ect Line [ to y [ of field End of TOpiC1 e •••••••••••• • •••••-:::...:?..4 711,1 Roloted Tcpcs• Main TOpiCS autoTab Card 1 of 1 set [the] autoTab cif iorjfig to The au toTab Fropert.rpr eorresrends to trven-F the Auto Tab check box in a Field Info dialo 2 box. The autoTab propertr,p, returns or sets whether HyperCard inserts a return eharaeter when the insertion point is on the last line of a field (au toTab is false) or moves the insertion point to the next edilzble field on the earlT•lau _o i_F4 trUe). NOte Auto 1zbbin2 do esn't work with senDllin2 fields. End cif TOpie e E,:•amplos• 711,1 Roloted Tcpcs• Main TOpiCS Min dTyping Card 1 of 1 set [the] b i ridTLip i rig tr,- itruECS-Fe711-7e The b Li ridTyp i ng 21oba1 property returns or sets whether you can type into the Messa b o>:: and s end messa 2es from it even when it isn't visible. HyperCard determines the default settin2 for b I i rufryp I rig at sizrtup (and when HyperCard resumes after bein2 suspended) from the ainckTypin option on the Preferences card of the HO rile slack. End of TO pie e E,:•atvpio•E 711,1 Roloted Tcpcs• Main Ti:' piC S bottom Card 1 of 1 the bottom of cal..:d You can't set the bo _ _ Mf 11 _the menu bar. .71m t [ the ] bottom f tee/e tcol• t n itE"7er• •=•Im t [ the ] bottom o f field -Fr, HyperCard determines the 1- _ _om .71m t [ the ] bottom o f eleca? t n el' itEy.76:e- of buttons,. fields, and HyperCard's ge t [the] bottom of menuBar built-in windows relative to the top-left corner of the current card. The bottom property returris or sets an inte 2er equal to item 4 of an element's HyperCard determines the 1- tt_om of the reclan21e. If you set the bottom of an card window relative to the tnp-left element it moves vertically; its size Corner of the screen with the menu bar. remains the same. T• can't set the bo t tom Of cards: US e the rect., he i gh and idth resize the cards in a slack. End cif TO pie e E,:* amp/ ce 711,1 Rola tad Tcpcs• Main Ti:' piC S b ottomRight Card 1 of 1 the bot tO Ridht of You can't set the bo t to mRight of cards: us e the red t, height. and d th et [the] bottomR ight of t,ttc properties to resize the cards in a sick. to pexq P t [ t h e ] bo t tomR i gh t 0 f field —1 HyperCard detern-Lines the bo t tomR ight to of buttons.. fiekis, and built-in T/iyin.L.ows get [the] bottomRight of menuBar relative to the top-left corner of the current card. It determines the The bo t to m R i gh t prO pert/ retWMS Or bottomR ight Cif the card Win& TAT reIttive sets a equal to iten-is 3 and 4 of to the top-left 12 0 rner an elements recian21e. If you set the of the screen with the menu bar. bo t to m R i gh t Of an element it inoves; the element's size remains the same. End cif TO pie e E-.•!,:* amp/ ce REVorcedTcpcs Main Ti:' piC S ••,••••••• brush Card 1 of 1 set [ the ] br us1-1 TATh.ere is a positive inte 2er in • • / \ the rar12e I thititi2h. 32. E • / I • • The brush property returns or set the current brush shape us ed by the , Brush tool. The value of the brus1-1 property P res3 and hold the mo u e over represents a bi-ush. shape frorn tile Brush thi: ill 1_13t. ration to 3ee the Shape 'laic, 2 boy:. The default bi-ush. is 8. b r h n u rn be r End of TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main TO piC S cantAb ort Card 1 of 1 se t [ the] can t Root- t o f tac:4 Wanking: Use ca tAbor t With eaution. to tre •'60.;••-•Fc7: Once can tAbor t is set t):, true, there's no way to halt an errant handler. Set nit con tAbor t property returns or sets can t bo r• t tO true, and then immediately whether users can type aE:-. (N-period) set it to false TAThen you no lon2er need it. to stnp any nu-nit-L.2 handlers. It cot-rest:ends to the Can't Abort cheek box in the Protect Sizek dialo b OX. Us e can tAbor Frr e ent us ens fmm eane elirt2 erlain eritical operations that TATotdd leave a sizek in a confus1n2 dan2erous End cif TO pie e i".••••••?3,.. E,:•amplos• •••• • •• • •• ••• • ,N; • p .? ir.••• • Main Ti:' piC S cantDelete Card 1 of 1 et [ the] can tDe [etc of card-•••••••••••—• The default T..Talue is fa [se (meanin2 tin frven-FaJ se that a card, back2nDund, or slack can et [ the] can tEle [etc of be deleted). t° et [ thP ] can tEle [etc of stack Note: Settin2 the con tDe [etc cif a slack t° to true doesn't prevent the user from deletin2 the slack by dra22it_12 it to the The can toe I e te property returns or sets Trash. whether a user can delete a specified card„ back2round„ or slack. It correspDnds to the Can't Delete check box in the Card Info„ Packi2mund Info„ and Protect Slack dia lo bo>::es End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti: piC S ••,••••••• cantM o dity Card 1 of 1 et [ the can tmod ifu Of VeL,T:03. The default T..Talue is fa [se (meanin2 tin truen-Faise that the card, back2rotuld„ or sizek can b e modified). 11-Le cantrlodi fy property returns or sets whether a sizek eanb e chan2ed in any way. It corresponds tiD the Can't Modify eh eek bOX in the Pro t ee t Suck lo 2 box. Settirt2 the can triad i fy of a sizek tO true selects both the can't modify Siaek cheek box and the Can't Delete Sizek cheek box in the Protect Suck dia bo>::. When can triad i fy is true, a radlock appears in the menu bar. End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• § Main Ti:' piC S ••,••••••• canWeek Card 1 of 1 set [tl-le] cantPeek of 45..t5.7!•,:i The default value is fa [se, mean1n2 tin ..ee.!!.q:(7:e./.:c• that you can peek at fields and buttons and use the - ShOtt2ists for -n-Le cantPeek property returns or sets ace essin2 (or p e e kin 2 at) s ripts whether us en can press X-C:pi-ion or N- Shift- Option to peek at the location of buttons and fields and use the Option shortcuts for ace ess_it-L,2 scripts. It i2Orresponds to the Can't Peek option in the Protect Slack dialo bo>::. End of TOpie e i".••••••?3,.. • E-.•%:•amplos• •••• • •• • •• ••• • p .? Main TOpiCS centered Card 1 of 1 set [the] centered to truEa-Fc711-7E• The centered property returns or sets whether HyperCard draws shapes fmm the center rather than from a corner. It 12 0 rre spo nds IDD the Centered corn/nand in the Options menu (which appears when yous elect a Paint tool). The centered pmperty affects the Line, Rec1.n2le„ Pounded Recizn:2:le„ and Oval tools. Its defaillt value is fa tse. End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• /Via It. Ti:' FriC S checkMark Card 1 of 1 se t [ the] cl-leckrlark o f tEo. o f t 0 L. IeL.;•-F The checkmar k property returns or set whether a check-mark character appears in front of a menu item. It uses the character. num ToChar 1:3 ), as the default check-mark character. lack Related Topics for information about the m a rk Char property. which lets you use characters other than the check mark. End cif TO pie E,:•amplos• DOM° Script 711,1 Rola tad Tcpics• Main Ti:' piC S conunan dChar Card 1 of 1 If more than one menu item use the same se t [ the] corn mandCl-lar o f .65•E•p51"...' itEo• command character, the menu item on o f Lt t 0 C:11%7.-••••••••-•-•,. the menu farther to the ri2ht 13.kes pre,: edenc e at co rn rn andChar FDDID erty returns r sets the character that you'd press with the N key as the keyboard shortcut, (co nu-nordy called the N-key equivalent) for a menu item. If the menu item has no N-key e quiva lent the property r e turns empty. Otherwise., it returns the character. End cif TO pie E,:•amplos• •••••:. Tip E 711,1 Roloted Tcpcs• § Main Ti: piC S cursor Card 1 of 1 se t [ the ] cursor to The built-in cursors are: ••• The cursor property sets the irna:2:e that 1 + I:L:3 I.• appears as the pointer on the screens I beam cross p I. us Ina tch 1 2 3 4 Note: cursor is a se t-ordy property. You cannot ge t the current value 0 f the cursor fron-L a script. •iltn) hand or row busw none HyperCard provides a number of built-in att'S 0 t'S td-Lat you can use. (HyperCard The busy cursor rotates an ei2htl-L of a autnnutically resets the cursor to the turn each tin-Le you call it. nyLa :2e for the current tDol on idle—when no other action is happenin:2) End cif TO pie E,:•amplos• DOM° S t •• • : • Main Ti: piC S deli uoraer Card 1 of 1 •r.int [the] debugger to .0kx!!co!,7.€?.::?.:Ma€• Because HyperCards debu22er is actually an „ez1-,eyn,Ilvq.5.gp:k4A4 0(1-ML:11).. The debugger property returns Or Sets you can replace it with your own or lite name of the current HyperTalk_ third-party debu22ers. debu22er. The default value of this property is sdr- i ptEd i tor.. the name If HyperCard can't find a debu22er with of HyperCards built-in editor and the nan-Le provided, it uses its built-in debu22er.i:The built-in editor and debu22er. debu22er are inte2rated.) lack Related Topics for more Lt-Lformation about debu22in2 a script. End cif TOpie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: piC S dialingThne Card 1 of 1 set [the] dial. i rig-1 i me to ne,5552-,ErCelTic:41-7 Note: rigT i me is not reset tp its default value at idle tin-Le. The dial. i rigT i me FrOpertri Set Or returns the trill len21-1-i of tirne tiek_s) HyperCard mairdains tl-Le value that you that HyperCard leaves the serial port set for this PrO p e rqr f0 t• tl-Le duration of open while dia1in2 a n-Loden-L. the HyperCard session. The 'default value for ..,e,0/2-/th IS 180.. where 60 tieks = 1 s eeond. End cif TO pie e 711,1 Roloted Tcpcs• § Main Ti:' piC S dialingVoltune Card 1 of 1 set [the] dial. i no1y10 ['Arne to itegEr• The diaLingly1oturne FrOpertri sell Or returns the 17okt/1-Le of the dialin2 tones 2enerated throu2h the computer speaker by the diat command. PualltatPq to an trite 2er in the To n e Ulm u 211 7. where 0 is extremely low but do es r !fit shut off the sound entirely. End cif TOpie e E,:•amplos• 711,1 Roloted Tcpcs• Ma in TOpiCS dontSearch Card 1 of 1 set [the] dontSeard-1 of field '7Pt [the] don tSearc1-1 of card to •vt.!:.:e!!E:if7.;:c7..i::„E set [the] don tSear ch of 21:4 •7565•c• to The dontSearch property returns or sets whether HyperCard's f i ecaranand will look for matches in a field card or bac1::2round. It eorrespDnds to the Don't Search cheek box in the Field Info, Card Info, and Eac1:14round Info dialo boxes End cif TO pie e E,:•amplos• •••• • 711,1 Roloted Tcpcs• Main Ti: pies do naVrap Card 1 of 1 •r•int [the] don tL•ir op of .;5,-.;!!:f.:).!:g.• Truncated viewable te >t isn't lost. If you .4%-• set the don tHrop tO true, the "n-dssin2" text appears in the field. The don thr op property returns or sets whether a field wraps tint that is lon2er This property is set to true when than the width of the field or instead au toSe Leo t is set to true; and it sets truncates the vieTATable te>t at the riat au toSe L t to false when it is set to false. e•2e Of the field. (In HyperTallc a return character determines a line.) This property corresponds to the Don't Wrap option in a Field Info dialo 2 box. End cif TOpie E,:•amplos• DOM° t 711,1 Roloted Tcpcs• Main Ti:' piC S dragSpeed Card 1 of 1 •=•et [the] dr agSPeed tc1 The drag!Speed FrOpertri returns or sets hip W marcrp, pixels per second the pointer will move when mardpulated by subs equent drag commands Ts e to dra 2 as fast as pDssble. The dragSpeed affects all of the paint tools except the Bucket and Text t (=In idle.. HyperCard resets the -1Lragpeei_ to O. End cif TO pie Ex•amplos• DOM° Script 711,1 Rola tad Tcpcs• Main Ti:' piC S e ditE kgn d Card 1 of 1 se t [the] ed i tBkond to itry,E7s-Fe711-76• The ed i tBkgrid FrOpertri retUrriS or sets the layer where new Faintin2 or new butbris and fields will appear—in the card layer or in the back2ritituld layer. It co rr e sro ndS tO the Ea ek 2ro und command in the Edit menu, and its available only when the 14s..Fr„..7.:7•.!:,•1 is Paintin Cr 13.1 nr hicrh P r The default settin2 is fa se, meanin2 that new ilyta 2es and Farts will appear on the card layer. End cif TO pie E-.•!,:* mpl DOM° S t 1.>/?•!•:- ,N; • p .? , Main Ti:' FriC S enabled Card 1 of 1 The enab Led property won't enable set [the] enabLed of.f.mElm6.....51v/tEm items in HyperCard's menus urdess te-ueene they're currently available to the user. set[the]enabLed of NtAv-, tn For e>an-tple„ the foLlo TATLft 2 code won't enable the Button Info comrnand unless a The enab Led ptperty returns or sets button is selected: whether a menu item menu„ or button is active ':'r inactive 1:1,din-tmed). Us en cannot set the enabLed of menultem 1 of choose din-In-Led elements. menu "Objects" to true •rott Set the enab Led cif a menu to false, The default slate is true. meanin2 that all iten-is on the menu b e M e inactive. the element is enabled. End of TO pie DOM° Script E,:•amplos• TipE REVorcedTcpcs § Ti:' FriC S e n v ir o run e nt Card 1 of 1 'let the environment This read-ordy property returns deve Lopment when the fully enabled version of HyperCard is runnin2 or p Layer when HyperC•ard Player or a standalone siacik is runnin2. 1••.A. standalone sizek is an application that you ereate by ehoosing 'Application from the pop-up File Type menu in the save a 7- py dial':' Crbo>::.) End cif TOpie e E,:•amplos• i".••••••?3,.. • Main Ti: piC S t amily Card 1 of 1 se t [ the] f am i o f to Card and button fan-Lilies are distinct; so where :•.',24,7g;:7• resolves to a value there ean b e a family 72 for card buttons between 0 and 15.. and (::1 means "no and anotl-Ler family 72 for baek2nDund family." buttons. This property sets or retrieves the button You can also assi2n a button to a fan-Lily fan-Lily for a 2i-cien button. by usin2 the Family pop-up menu in the button's Get Info 'laic, bo>::. Settin2 the hilite 0 f any button in a family tO true sets the hate of all otl-Ler same-family buttons tJD fa se The default f i y value for a new buttnn is 1::). End cif TO pie e E-..%:•ampices• 711,1 Roloted Tcpcs• Main Ti: FriC S tilled Card 1 of 1 •=•P t [ the] ii t Led to ...r,Lt..-.x!r.7:c•••-•?5711-76• The fitted property affects the Rec1.n21e.. Pounded Rec1zn21e„ The fitted property returns or sets Oval, Curie., Re 2ular Poly2ork. vi,Theiller HyperCard fills shapes TATith and Poly tO 0 IS the current pattern on the Patterns p41..,11!1! as you draw them. It corresponds to the Filled co/Ili-nand in the Options menu (TAThich appears when you select a Plaint tool). The default T..7a1ue is fi te. End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti:' piC S the ci Lin e II eight Card 1 of 1 set [the] f xedL i neHe i qht of .1.-.;..,!:g• Settin.2 the ii i neHe i ght Firoperty tO tr. t.-uee:7;-Fal fa Lse Sets the shod_ i nes prOperty to fa [se. Settin2 the f i xedL i neHe i ght to The f xedL i neHe i ght property returns true has fuD effect on the showL i nes. or sets whether a field has urdorm heil2ht or varies the line hei2ht of each acieorclin2 to lar2est font size that appears in the line. It correspDruis tri the Fi>::ed Line Height cheek box in a Field Info g box. End cif TO pie e El:•amplos• 711,1 Roloted Tcpcs• Main Ti:' FriC S freeSize Card 1 of 1 the freeSize of tac...4 The f r eeS i re property returns the an-Lount of free space.. in bytes.. in the specified siack. (Free space is created in a sizelc each tin-Le you add or delete an !*!1!•.,:!.1-, r 2ra 1:1162 Ti:' set the f reeS i re property to 1:::1.• ChOOSe fon-Tact fron-L the File menu 0 r use the con-Ln-Land dorlenu "Compact Stack" fron-L a handler 0 I' the Message box. End of TO pie E,:•amplos• DOM° Script 711,1 Rola tad Tcpcs• Main Ti:' FriC S grid Card 1 of 1 •=•et [ the] gr iii itruECS-Fe711-7e The grid property returns or sets whether HyperCard 120 riS trains the movement of many Paint tools to eiOlt-pixel intervals. It corresponds tO the Grid command in the Options menu (which appears TAThen )-, ottselect a Plaint tDoll). The default T..7a1tte is se End cif TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti:' FriC S ••,.• •• • height Card 1 of 1 •=•Pt [the] he i ght of 2-,enter.)•5• to III* ZLEY7Er• Settin2 hei2ht of a card resizes all the P [ the] he i ght of field to 1. 17 ZLE-7E••••-• cards in a sizek. HyperCard forces the et [the] he i ght of cano: to irtte 2er specifyin2 the hei21-tt to be et [the] he i ght of epindow? to III* tEy.76)- an even ntualber :;_rreater than 64 pr Main Ti: FriC S ••,••••••• hilite Card 1 of 1 set [the] hi Li te of If a button b elort_rs tp a „th-m.qy and its tin t.-uee:7;-FaJ se hi Li te property is set tD true from a script, the hiLi te property of each of The Ii j Li te property returns or sets the other buttins in the family is set to Tin-Led-Ler a button is hi4111i2I-Lted (shown in foLse. 1/17.7erse T•7ild e (Click Tips to see a list of synonyms you With check boxes and radio butbro„ earl use for hi Li te hiLi te determines whether the button is selected. End cif TO pie Examples. DOM° S t 711,1 Roloted Tcpcs• Main Ti: piC S icon Card 1 of 1 se t [ the ] icon of The ,;.7a1ue of the i con pipperty is an t inte 2er corresrendinp; the ID ntualb er se t [ the ] icon of of an available icon resource. If a button to has no icon, the i C ri FV:1 p e ity is O. For an icon to be displayed 0 n a buttnn. where is the name of an icon. its resoune raustbe available in the current slack.. 0 n e of the slacks currently The i don pToperty returns or sets the 3ein2 used the Home slack.. or icon displayed by a button. Settin2 it is the HyperCard itself. same as choosin2 an icon from the Button Info 'laic, bo>::. HyperCard sets the = _ CMI2 k the cn-ildfish. bowl function the resu Lt. tip "Con t fi rid I tJD see simple icon that i n if it can't find the icon ...... animations. (otherwise the resu 1.t is emp End of TO pie e E-..%:* mpl 711 Rola tad Tcpcs• Main Ti: piC S ID Card 1 of 1 the I El of .21u t The I 0 Of a sizrudalone application is it the ID Of fiEld creator code. the [ adiectiwe[ ID of ca..-d the I El of 4-..A:gg' All objects except sizcks have IDs You the I D 0 f can't chan2e the ID number of an object. the I D [of 1-114per-Cord [ windoTAT„ on M e the I El of If an object doesn't have a name.. The I 0 property returns the permanent HyperCard returns the ID instead. ID ntunb en of any button, field.. card„ back:;_rnound, window. 0 r menu in the The adjectives abbrev i a tell.. orig., elm-ent sizek. and shor t return 7•7anious forms 0 f a cards ID. (lack Den-to The I El of HyperCard is 1.4 I LD. End of TO pie Ex•amplos• DOM° t 711,1 Roloted Tcpcs• Main Ti: piC S ••,••••••• itemDeliiniter Card 1 of 1 set [the] itemDeLimiter to c:t.)F.:: The itemDeLimiter propertysetsor retrieves what character HyperCard uses to separate items in a list The 'default delimiter is comma. HyperCard resets i ternDe Li in i ter to the default delimiter at idle. This property has no effect on eon-in-La-delimited structures stteh as diJ te I terns., location icic).• rec1zn21es pc ti) End cif TOpie e ,sf.:.•;;•••.',?.P.;•?/2.1:?.?;• i".••••••?3,..,N; • R Main TOpiCS language Card 1 of 1 set [the] anquage to .!:-.f4-7.ex!rcf?!••!!:;77f To use other lan2ua 2es.. a script translator resource must exist in the current sizelc, where is a lart:2.1-t12e any sick later in the messa2e-passin2 suppprted by HyperCard order, or in 1-1:p,p er Card itself. The Language propet-ty returns or sets Contrast this property With the tl-te laru_rua 2e in which HyperCard script i rigi_Qhguage of which displays scripts. The 'default settin2 is describes an object's scriptin2 system. Eng Li sh.. arid its always available. End cif TO pie e .5..!,:•amplos• •••••.: '..:.•••••••• • • p .? Main Ti: FriC S left Card 1 of 1 the Left of C:1:71:d You can't set the Left of the menu bar. Pt [the] Left of teuteco• th ire4.6-7er• HyperCard determines the Left •=.17-.t [the] Left of fiEleto Of b tittO rifL fields, and HyperCard's •r.in [the] Left of ee?1,65L7i7ye to ir,'LE-7EN6- bttilt-iniViTifid0 TATs relative to the top-left get [the] Left of menuBar corner of the current card. The left property returns or sets an HyperCard determines the left of inte 2er equal tn item I of an objects the card Wind° W relative to the top-left recizn21e• If you set the Left of an corner of the screen with the menu bar. object, it moves horizontally. The size of the object remains the same. You can't set the Left of cards: use the rect., he and dth Froperties resize the cards in a slack. End cif TO pie E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: FriC S ••,••••••• lineSize Card 1 of 1 set [the] LineSize to This property affects the Line.. Rec1zrL21e„ Rounded Recian2le, Oval. Curve, Re 2ular TAThere pos. I nteger is 1.. 2, 3, 4, 6, nr 8. Po1y2on„ and Poly2pn t k The Li neS i ze property returns or sets the thickness., in pixels.. 0 f lines drawn by the Plaint tools. It cot-rest:anis to the line 1 size you select in tl-Le Lit-Le Size dialo bo>::. (The Line Size 'laic, bo>:: appears when N. yott 12 h1:11:1 s e Line Size frcirn the Optic, f Press ;riui hOld the mouse over this n-Lertu.) ill ust rat ion to see the Ii ne 12e3. The default value is 1. End of TO pie e Ex•amplos• 711,1 Roloted Tcpcs• /Via It. Ti: FriC S lo catio n Card 1 of 1 set [the] Loc o f be; e to,5- f HyperCard determines the location •=•Pt [the] Loc 0 f 6.1 d t 0 Fefe e of buttons, fields, and HyperCard's .7Pt [the] too to TATindoTATs relative to the .=•17-• t [the] L 0 C of E:).•• i:LE)-)•5):71.4•••115•10i-ch? top-left corner of the current card. to ee: For a wLndov,,T displayin2 a slack, The Location (or I. oc'.,1 property retutTis HyperCard determines the location of the or sets the center point of a button or field card Wind0 w relative to the tnp-left and the top-left corner of a window. corner of the screen with the menu bar. Settin2 the location of button, field, or Window MO ves it to the new location. HyperCard adjusts the horizontal Offset of the card window tO the closest multiple of 16 to the number specified. End cif TO pie e E,:* ample s• 711,1 Roloted Tcpcs• Main TO S lockErrorDialogs Card 1 of 1 set [the] I. oc kErrorDiaL OQS tO -1* When this property is set tO true.. tnien-Fc7./ HyperCard, on encounterin2 an error„ does not display an error dialo 2 box.; The Er ror El i a Logs property returns instead, it sends the messa errorD i a L Og or sets whether HyperCard 0 n er:e•-•1:7:e•-:1•1671:7gETE:).••t tO the current card. encounterin2 an error presents an error dial:, 2 box. co rtiairts tht t e :•••••t_ f the ermr dialo 2 bOX. This poperty 'defaults to false at idle time„ meanin2 that error (=halo 2s usually appear. End of TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti:' Fils C S ••,••••••• lo ckM essages Card 1 of 1 set [the] ockriessaces to ...itvf07;!...e..?!.-7E• Settin2 ocktlessages tri true is us eftd TAThen yo 11 want to 20 to a 12 ard to retrieve The Lockliessages FrOperty returns or or save _it-don-nation., but you don't want sets whether HyperCard sends '2 e ria in to slay there. (The harpdler will run faster messa 2es autDmatically. with tockriessoges set to true.) The messa2es affected are c oseCard., c toseBockground, c toseS tack., openCord., The defatdt settin2 is false. meanin2 that openBackground., openS tack., resumeS tack, HyperCard does send the messa 2es. and suspendS tack HyperCard sets ockriessages tD false on idle. End cit Top, E,:•amplos• DOM° Script 711,1 Rola tad Tcpcs• Main Ti: FriC S lockRecent Card 1 of 1 set [the] ockRec en t to ...z.LrX..7:•..7?5?..?!:.-.7.• Settin2 L'DckRecent to true speeds up scripts that go tn cards. The LockRecent FrOperty returns or sets whether HyperCard 'displays HyperCard sets [fickRecerit to false miniature pictures for the last 42 cards 0 /1 idle. visited by the user (or a handler.) in the Recent card 'laic' (Lock A ecen t does not affect the trail of cards you can Crri ba01:7 The default setting is false.. ri-Leanin2 Hyper Card do es display miniature pictures of the cards visited. End cit Topr e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: piC S lo ckS oven Card 1 of 1 set [the] ockScreen to truECS-Fe711-7e••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••Settin2 ockScreen to true speeds up scripts that ,2c, tn cards momenizrily The L OCkScr•een property returns or set before returnin2 to the soul): e card. ,ATheth.er HyperCard updates the sere er1 (HyperCard runs faster TAThen it doesn't when you :2:c, to anOther card. You can have tO redraw the screen.) use to,: kscreen tO Fife ent the user from seein2 cards as a handler :;_rp es to them. The default s et-6112 is false. H:rprperfard sets ockScreen tri false on idle. End fit TOpIP e E,:•amplos• •••••••••••:•••••••••:::::,:,...4 711,1 Roloted Tcpcs• Main TOpiCS lo ckText Card 1 of 1 set [the] ockTex t of .1..;-!!:.:;,!:.q• When a field is locked, it can receive tin ..eeLO:f.e..!:c• the system messages mouseDown.. mouseDoub Lel= i ck, mouseSt i [Down., arid The LockText property returns or sets mouseUp When the user clicks it. whether the user can edit the text within a specified field. It C'Orrespords Before a field can act as a sfft, its to the Lock Text cheek box in a Field Info LOCP:Te.xl: property lyiustbe set to true. dia102 box. The default T..7alue is false I:in-Leaning the field is urdocked). End cit Trip112 e E-.•%:•amplos• •••••:. •„:::••••• 711,1 Roloted Tcpcs• Main Ti:' pics lo ngWin downtles Card 1 of 1 set the L ondll i ndowT i For e>ample, compare the fo 110 Win 2 trATO to ey-eiE.F.c7/.E commands: The torigH i ridciviT i t tes returns or sets show window "Home" vi,Theth.er HyperCard 'displays the full path show window "My HD:HyperCa-d:Home" name of a slack in the title bar of all windows that conia S13.12173 Its 'default The first TATorks ordy when the value is false. icing1,1 ndowT i t Les is false, the second only when its true. raLeck the value of the 'WARNING: OD nu-I-Lands or pitiperties 0 rigkl i ndowT i t Les before you use such that reference slack windows by name commands or properties., or force it to be won't TATork ono e •:!, set the false in your slack (which lakes away the ongil indowTit Les tO true because the feature). name be:on-Les the full rath name of a slack. End Ot TOpIP E,:•amplos• DOM° Script REVorcedTcpcs Main Ti: FriC S m ar k C h ar Card 1 of 1 set [the] marktbar of Ar,E)L51,1tEff, of The default character used to marl: 7_ menu tin c•11-,c7.- items is the check mark„ a character equal to nurnTochar ( 1 :3 ) 11-Le markChar prOpert57 returns or sets the It prints in the radea 2o font: vi character used tr, mark a menu item. If the item has no mark, the markChar returns empty. Other-Ms e„ it returns the character. Settin2 the mar kChar of a menu item a character also n-Lar1:7s the item„ that is„ sets its c h eckmark rciperty to true End cif TO pie E,:•amplos• DOM° t 711,1 Roloted Tcpcs• Main Ti: piC S marke d Card 1 of 1 •r•et [the] marked of cnrd t n t.ruee:7;-Fa The marked property returns or sets whether a card is marked. It corre- sponds to the Card Marked check box in a Card Info 'laic, 2 box. You can operate on the set of marked cards with eon-al-Lands such as pr i nt, go„ show, and sor t. End of TOpie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: piC S menuMessage Card 1 of 1 set [the] menurlessage of ..r;P:;:ei.;!!:.;:?••••55..• Hyperfards default menu items have no of ..57.E.'1V 1:0 associated inessa 2es sent to the current " card unless they have been e>plicitly set with this FDDperty. The menurlessage prOperty returns or sets the rrLessae sent the current card A doMenu handler can override a when the user chooses a menu item from menurlessage. a menu. The menurlessage FrOljertyrettirnS empty if the menu item has no associated rriessa End of TO pie E,:•amplos• Tps• 711,1 Roloted Tcpcs• /Via It. Ti: piC S messageWatcher Card 1 of 1 set [the] message•atcher Cack Tips for information about the ..-Eceue-cee properties of the messa 2e TATa h e r The message•atcher property returns or set the name of the etqm.zisr-,maz4 (or XCMD1) that displaT,rs the Mesa ,re Watcher TIATind0 TAT for tracin2 scripts. The name of HyperCard's messa 2e watcher is riessaigew,Jtcher. Third- party develo p e mi2ht supply other messa 2e watchers that you can instill int:, HyperCard. End cif TOpie E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: piC S multiple Card 1 of 1 set [the] mu t ipLe to truEa-Fc711-7e The mu tt i p te prciperty affects the Line.. Rec1.n21e„ Rounded Rec1zn21e„ Oval, and The muttipte property returns or sets Re dar Po1y2on tools. Its default value is vi,Theth.er HyperCard draws multiple false. trna :2:es when the user (or a handler) drallr,s with a Pairit tool. It corres pOrp±: to the Draw Multiple command in the Options menu (TATI-Lich appears when you select a Paint tool). The mut ti Space prOperty affects the ntunber of multiple shapes drawn. End cif TO pie E,:•amplos• DOM° Script 711,1 Rola tad Tcpcs• Main Ti: FriC S nudtipleLines Card 1 of 1 _ set [the] mu [tip i nes o fieldMatipLeLines appears as the "Multiple tin Lt.-yen-Fa Lines'. option in the Field Info dialo boy:, where it is disabled if au toSe Lect is set to The muLtipLeLines property returns or false. sets whether a user can eytend the rarL2e of 1-d 21-Lli 21-tt e d lines in a .01st. jtM To learn TAThich lines are selected. 2et the seLectedLine of fifi,V When the muLti pLeLirie 15 true.JiLe user can extend 1-d21-I2hted lines either by To learn the contents of those lines, 2et shift-elieldn2 any Feint b efore or after the the seLectPdTPxt of p.E../.d ins ertion point in a field or by dra 22in2 throu2h text. To preselect lines„ use seLect Line x [to y] of fif.V EndcifTOpie e E-..%:•ampices• REVorcedTcpcs Main Ti:' piC S ratdtiS p ace Card 1 of 1 set [the] mut. t i Space tc1pcntr The mu t i Space property affects the Ree1n21.e.. Pounded Pei:Ian:2:1e.. wilere is a mu-fiber fi)Dm Oval, and Re 21—t•17 ,.1o.y2oni tools. 1 100. default T.Talue is I. The mu t space property returns or sets lite minimum amount of space.. 21„..:7;.!;:ls.• between the edges of multiple shapes drawn when the muLtipte I:Tippet-1:y is true End cif TOpie E,:•amplos• DOM° t 711,1 Roloted Tcpcs• Main TOpiCS ••,••••••• name Card 1 of 2 the [adiec-tive] name of c.1..L..iec.t the Long name of Hwercard returns the the [ long] name 0 f HuiperCard full path to HyperCard: set [the] name of obiect to teRve myElisk:Desktop Folder:HyperCard set [the] name of [.pe.5.eiltem of] Folder:HyperCard to text get [the] [English] name of You can us e the adjective Eng ish to [z.e.Niftem of] .63.6).5.b. determine the names of menus and menu items if you're us1n2 a localized ,;.7enion of The name property returns or sets the HyperCard: name of an Object. menu item. or menu. If the element doesn't have a name., the if the English name of menultem 5 name returns the ID of the obi ect instead. ot menu "Edit" is "Paste"... -- More -- E,:•ampices• DOM° S t REVorcedTcpcs Main Ti:' piC S name (120f-it'd) Card 2 of 2 The adjectives abbrev i ated., ong, and shor t t• etm-L various forms of an objects name (click Demo S2ript to see e>amples.). Note: the abbrev i ated name is the same as the name. End cif TOpie e 711,1 Roloted Tcpcs• • • • • • • • • • • • q. Find TOpie Main TOpiCS ••••••••• " • •••" •••• •••" •••• •••" •••• •••" •••• •••" •••• •••" •••• •••" ••••••• " •••• •••" •••" •• munb er ( pro p erty) Card 1 of 2 the nUM b Eq- 0 f To chan2e the numb er 0 f a button or the nuimber 0 f flEid field, select it and choose Send Fat-I:her the number o f Ca—d and Brin2 Cos er from the Cbjects menu., the number o f 41-Ag!::5:d r chan2e its par triumber prOperty. the nuimber 0 f minghw The nturib er of a Trch-td0 w reflects its front The number property returns the number to back order (sin-Lilar to the numb er of a of a butbn„ field, card., bac1::2nDund, or ttit0 n or field). You can chan2e a window. (You cannot se t a nturb er.) TATindow's nuirb en by 1)1'h-1.24_12; it to the The nturb er of a button or field fmnt (for e>ample, by clickin2 it or by determines whether its on tpp of other ift 2 the show comma fp:D.. 0 r by buttnns and fields within the same layer cciverin2 it with 0 th e r windws. iback2round or card) that conizins it. lard objects are always 0 n tor, of biac12round objects. --- More --- E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti:' piC S munber (property) (cortf:d) Card 2 of 2 The mu-fiber of a card is it position TATithin a slack. The ntu-nber of a back:;_rrciund is the order in which the back2round was created. Ti:' chan2e the nurnber of a card or back,,;_rroand, you must use the sor t command or cut cards and paste them intD different pDsitioris within the slack. End cif TO pie e ,sf:.);',.:,??•;•?/21:?•!:• • •••••-:::...:?..4 711,1 Roloted Tcpcs• Main Ti: FriC S /nun b er F o rm at Card 1 of 1 se t [ the ] numberForma t to I Ts e to it 1-iate where you want trailin2 cli2its to appear if where is a T% nurnber for-taut. the:rp, luve a ,;.7alue other than zero. TI-it number For ma t Fr° pe 1'17 returns or HyperCard set the default narnber set the precision TATith. which the results of fonmat to no .######H on idle. mathen-Latical operations are 'displayed in fields and the Messap:e box. The Important: numberForma t lakes effect followin:2 symbols specitp, the numb er ordy when you perform a mathemat- forinat ical operation 0 n a ntu-nb et'. TS e one zero for each di2it you want to appear. i_ise a period to indicate the pDsition of the decimal point. if any. End cif TO pie E,:•amplos• 711,1 Roloted Tcpcs• Main Ti:' FriC S owner Card 1 of 1 qe t [ the ] [ Lona I shor t ] owner o f owner of returns nbl::_is-rrud" plus the qe t the owner o f fa:.fzintel leaf name of the backoun,. This read-only pmperty tells you the The forin. returns HyperCard if name cd the bacr,rouild to w1-6211 a it's a slack or built-in window., or the specified card b elon, or it tells you the name of an XCMD if it's an external ereat_or of a window. vvindcaffl. Long owner o f .c:qq' returns the full path ran-Le of the baek2mund. Shor t owner o f returns the short ran-Le of the back:;_rround. End cif TO pie e E,:•amplos• i".••••••?3,.. •• .07? Main Ti: FriC S p art N iunh er Card 1 of 1 t [ the] par- triumber f tO tE For e>an-tple.. the Order of buttons and fields on a card is as follows: vohere ...!:::!•.5.:..F.L.qgq.:!•.:• is i.tt tile ran2e 1 thrott2,h lite stun of buttons and fields in the button 1 current card or bacIrrourid button 2 field 1 The par triumber property retrieves or field 2 set the ordinal position of a button or button 3 field (that is.. of a Fait amori2 the total ntunber of all buttons and fields within The par triurnber of field 1 is 3. the same domain (card or back2rotuld). atary_rin2 a part's par triumber rnoves it closer to or farther away from the front. End cif TO pie E-..%:•ampices• 711,1 Roloted Tcpcs• Main Ti:' FriC S pattern Card 1 of 1 set [the] pattern to ,c,-..y...7.;.:2..z.?y,7q?:•-•• Wass111111 • where is an inte 2er in the EhnimillE1 ran2e I thmu211 11115256iii The pattern pmperty returns or set the mitourn current pattern used to fill shapes MEM! or to paint with the Brush tool. REINMig. : TT If you edit One of the patteiyis, HyperCard saves the new pattern Fi re 3 3 a rid hi) Id the rno use b Litt.° n with the sick. over a pattern to 3ee it3 number. End of TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: piC S polySides Card 1 of 1 se t [the] po 145 i des to ,c2..y.,.7z7..:!!::•2.:(17;!:: If you s et po i des tO a nurnb er lower tha n 3 (o th e r tha n o r hi 211 e r tha n Q. it where is 1:::1 or a rittrnb a uto ma tie a r e e t:, 3 o r 5 0. 3 to .50. The po yS i des property returns or sets the number of sides of a po1y2on created by the Re :2•ular Po1y2On tool. Set po LiS i des tO CI to draw a ein-21e. can als0 S eleet One of sr.:: siandard pci1y2:111S by choOSin2 I:icily:Iron Sides from the Options menu...) End cif TOpie E,:•atvpies• DOM° Script 711,1 Rola tad Tcpcs• § Main TOpiCS ••,••••••• povverKeys Card 1 of 1 se t [ the ] powerKeus to vi:Lrx.,,r.7:c•-.F.e..?!.'4-.7f The powe•Keys property returns or sets whether the you can use keyboard shortuts for paintin2 actions. HyperCard idetennirtes the 'default settin2 for power•:::eys at sizttip (and when HyperCard resiArnes after b eit12 suspended) ft'fi /1-1. option on the Preferences card of the HO rne sizek. End cif TO pie E,:•amplos• 711,1 Roloted Tcpcs• Main Ti:' piC S printMargins Card 1 of 1 set [the] or i ritMarq iris to :•::::c.:S..57.:a7..;!f The pr i ritllarq iris FrOperty returns or sets the value of the default mar,,in s pa eini2: us ed by the pr I n t command. The default value is '3,3,171,171. End cif TO pie e E,:•atvp/o•E 711,1 Roloted Tcpcs• Main Ti: piC S print T extAlign Card 1 of 1 sPt the printTextALion to W.I.ggV The printTextALign property returns or sets the value of the default ali2tu-nent us ed by the Fr nt conu-nand. The default value is Left. The pr I n tTextA Li gn property does not affect printin2 of report items. End cif TO pie e E,:•atvp/o•E REVorcedTcpcs Main Ti:' piC S printTextFont Card 1 of 1 set the printTextFont to f.c.f • If the report item is 2enerated from any other 1-1:p,perTalk expression, The pr i ntTex tFon t property returns or HyperCard uses the value of sets the value of the default text font used pr i n tTex tFont. by the pr i nt eornmand. The default value is Geneva. In either ease.. the user ':an override the default font by selectin2 When you print a report. HyperCard a font in the Item Info cha1o2box of determines the default font for a report the report item. item as follows: • If the report item is the text of a card or back)_rmund field.. HyperCard uses the text font of the field. End cif TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: piC S printrextHeight Card 1 of 1 set the pr i ntTextHe i qh t • If the report item is the text of a card t1:1 0 r back2rroand field. HyperCard us es the text hei.:2;ht of the field. The pr i ntTextHe i ght property returns or sets the value of the 'default text hei2ht • If the repprt item is 2enerated from (or line spacincr) us ed by the print any other HyperTalk expression, command. The 'default value _ HyperCard uses the value of :3 pr i ntiextHe i ght. When you print a report. HyperCard In either case., the user can override the determines the default text hei2ht for default hei2ht by selectin2 a hei2ht in the a report item as follows: Item Info dialo 2 box of the report item. End cif TO pie e E,:•atvp/o•E 711,1 Roloted Tcpcs• Main Ti: FriC S p ri nt TextSize Card 1 of 1 sPt the printTextSize to • If the report item is ',;zenerated from any other 1-1:p,perTalk expression, The pr i ntTextS i ze property returns or HyperCard uses the ,•.7a1ue of the sets the T•yalue of the default text size (or printTextSize. ppint size) us ed by the pir nt eon-mat-A The default T..7a1ue is 10. In either ease, the user ':an override the default size by se1ectin2 a size in the When you print a report.. HyperCard Item Ir.& dialo box of the rep:ill: item. 'determines the default text size for a report item as follows: • If the report item is the text of a card or back_rmund field.. HyperCard uses the text size of the field. End cif TO pie e E,:•amplos• REVorcedTcpcs Main Ti:' FriC S printTextStyle Card 1 of 1 set the printTextStqLe • If the report item is the text of a card t ff.)4::.at.q.kfk.!...t 0 r back2roand field. HyperCard us es the text style of the field. The pr i ritTextSty Le property returns or sets the value of the default te>t style • If the repDrt item is 2enerated from us ed by the pr nt command when you any other HyperTalk expression, print an expression. The default value is HyperCard uses the value of the pLain. printTextStyLe. When you print a report. HyperCard In either case., the user can override determines the default te>t style for a the default style by selectin2 a report item as follows: style in the It ern Info dialo bo>:: of the report item. End cif TO pie e E,:•atvp/o•E 711,1 Roloted Tcpcs• Main Ti:' piC S rectangle Card 1 of 1 [the] r t o f 211 e trol• to r 'EC* 1:7665v7 E• HyperCard determines the rec tang L e [the] rect cf tri Of }DUI:tins.. fields, cards, and its built-in [the] rec t o f car-d to rg-ct1 e windows relative to the top-left corner of [the] rect o • t,,!!!!:..,•617?)!!• to .w..,,!:f• the current card. HyperCard determines get [ the] rect of menuBar the rec tong Le of the card window relative to the top-left corner of the The re: tang e property returns or sets screen with the menu bar. the rec1anu1ar coordinates of buttons.. fields, cards, and windows, and it returns Note: You can't set the rec t of an the coordinates of the menu bar. Setting, mac tic e card window or of the menu bar. the re:Ian:2;1e of a card chan2es the size of all the cards in a sizek; 5ettin2 the recian2le of the ciArckyin,j9N resizes the window., not the card. End cif TO pie E,:•amplos• DOM° Script 711,1 Rola tad Tcpcs• Main Ti:' FriC S rep ortTemplates Card 1 of 1 the reportTempLates of The reportTempLates property returns a return-separated list of the names of report templates in the specified sick. End cif TO pie e E,:•atvp/o•E 711,1 Roloted Tcpcs• Main Ti:' piC S right Card 1 of 1 the right of You can't set the r i gh t of the menu bar. [the] r I qh t o f to HyperCard 'determines the r i gh t [the] right of (iEldfo 1-1-cLE-7e - Of b tittO rifL fields, arid HyperCard's [the] right of AY/nig:L-4e? t 0 tEy.76,6- bttilt-iri1;AlindOTATs relative to the tpp-left [the] right of menuBar corner of the current card. The r I gh t property returns or sets HyperCard 'determines the right of an inte 2er equal to item 3 of an element's the card window relative to the top-left recizn21e. If you set the ri2ht of an object corner of the screen with the menu bar. it moves horizonially, the object's size remains the same. i• can't set the r i gh t of cards: use the reo t.. he i gh Or d th properties to resize the cards in a sizek. End cif TO pie E,:•amplos• DOM° Script 711,1 Roloted Tcpcs• § Main Ti:' FriC S ••,••••••• script Card 1 of 1 set [the] scr ipt of Ct.' E'C' t 0 tE::y• The scr i pt property returns or sets a text strin2: equal tr, the izgrvipt of tile specified object in the current sizek or in the sizek script of another slack. When you set the scr i pt property With the set COmmand, you replace e>:istin2 script entirely. End cif TOpie E,:•amplos• DOM° Script 711,1 Rola tad Tcpcs• Main TOpiCS saiptE ditor Card 1 of 1 set [the] scriptEditor Beca us e Hyp er rd's script editor is th r.EsrvrzEName actually an .2,1-„en1,11.).2.5.g.g.L4,n4 you can replace it with your own or TI-itscr i ptEd i tor property returns third-party script editnirs. or sets the narne of tile current script editor. If HyperCard can't find a script editnr with the specified name.. it uses its built-in The• _ default value of this properly script editor. i ;cr i p tEd i tor., the name of HyperCard 's built-in editor and debu e r. cch e editnr and debu22er are intel:,,rated.1) End cif TO pie e E,:•amplos• REVorcedTcpcs § Main Ti: piC S salpfingLanguage Card 1 of 1 set [the] scriotingLanquale The messa 2e bo>:: and each individual [of cbiece ] to iawuaceName object can all respond to different scr1ptin2 systems. vollere ./0.,51,7eiage.0.6.,•E• is H:p7perTalk or tile name of any (=ISA:compliant seriptirt2 You can also set the sor i pt i rugLaruguage system such as Apple '32ript. pttiperty for an olDj ect by choosin2 fttim the 3criptin2 Lart2ua 2e ppp-up /a-term at The scr i pt ingLanguage property sets 0 the t_ipp of each object's script editor retrieves the seriptin2 system of the window. object or ("when yoli don't use of 021/ EC t 1:1 of the messa 2e box. The default icw5geic7ge..'Ya.7;•e is HyperTalk. La.,3,7mgc.76,,,,amE must he present in the computer's system resour,Ps. Erud cif TO pie e E,:•atvp/o•E REVorcedTcpcs Main Ti: FriC S saiptTextFont Card 1 of 1 set [the] scr i ptTextFont tn The scr i ptTextFont property returns or sets the font used to display scripts , tt_ne script editor' 14Tind0 TATS HYP errand uses rl onaco as the default font. End cif TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti:' FriC S saiptTextSize Card 1 of 1 set [the] cri ptTextS ze 1:1:1 The scr i p tTex tS i re property returns or sets the size of font used to display scripts in all the script editor windows. HyperCard uses g as the default size. End cif TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: FriC S scroll Card 1 of 1 set [the] scroLL of .(1Eldto inee-7Er- For fields.. HyperCard pins the scro EL to set the scrott of [the] card window a numb er b etwe en 11 and the maxirntun to value for the field. For semilirE2 fields., the scro I. FDDrierty For the the scrip t t returns or sets which lines of text property returns or sets a poirEt that currently appear (as indicated by the specifies the current horizontal arid scroll bar). The q•c.7.q.:••••,:• represents the vertical offsets of the pDrtion of the card ntunber of pixels that have =Lied above currently visible in the card w_irudow. the top Of the field's recizrE21e. For It affects the card irriafr Ordy when the e>:ample, the number of lines =lied size of the window is smaller than the size in card field 1 equals the scroLL of card of the card. fieLd 1 div the textHeight of card fieLd 1. End cif TOpie Ex•amplos• DOM° Script rips REVorcedTcpcs Main TOpiCS ••,••••••• sharedHilite Card 1 of 1 set [the] sharedHi Li te of bertercel• Set sharedHi i te to false if you want the tin t.-uee:7;-Fa hi Li te prOpetty for the back2round button mainlined independently for wilere is a back:;_rrotuld button each ear& only. For e>ample, you mi2ht have one cheek_ The sharedHi Li te property returns or Lox button in the Liacki2npurid for sets whether a b.4.q1,7,:r ;imr,L4.b,uttipp shares marl:in:2. and urLmarldn2 cards. You its h i Li te pnpperty with every card in would set its sharedHi Li te tO false so the backi2round• The default value for that its 1-d2h1i2htin2 can b e different on new buttons is true. each card. End cif TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: piC S sharedTed Card 1 of 1 set [the] sharedTex t of fl d Set shared-re X t to true if you want the t ID te•-•IVE•0;•-•Fc7 same text to appear on eaeh card of the back);_rtound. To enter text into a where is a bac k tind held 0 rdy. back2round field with shareoText set to true.. ehoose Eaek;_rround fro In the Edit The sharedTex t property returns or set menu„ and type in the field. Iou ean add whether a 1;942;:our.4..fiF,:4 displays the shared text on1T,- T7rdi're..? - - in the same text on every card of the back crtound laT,Pr. biac12round. The default value for new fields is false, meanin2 the text in the field HyperCard do es rot discard either eanbe different on eaeh card. card-speeifie text or shared text—it will display the appropriate text when you set the shar edTex t tO true or false. End cif TO pie e rw1•3,.. E,:* ample s• •••• • •• • •• ••• • 1.>/?•!•:- ,N; • p .? Main Ti: FriC S showlines Card 1 of 1 set [the] showL i nes of field Se ttin2 the showL i nes 1:11•01Dett.rp, to true te-ven-Faie sets the f i xedL i neHe i ght property to true. Settin2 the showL i rues tO false The showL i nes property returns or sets has fuD effeet on the f i xedL i neHe i ght. whether the text bas elines of a field appear. It con'esponds to the Show Lines Note: The showL i nes property has rt0 eheek bo>:: in a Field Ir.& lo box. effect for serollin2 fields. The default TJalue is false (rneanin2 that the baselines are invisble.). End cif TOpie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti: piC S showName Card 1 of 1 se t [ the] houtia me o f be" e eccel• t.-ve0;-Fal nit sho 1.1.1 No me property returns or sets whether HyperCard displays the name of a butto n (if the button ha sOne) within the b utbD n's ree n e It co rr e s Fonds to the Show Name cheek box in a Button Info dial:, Cr b o End cif TO pie E,:•amplos• DOM° Script 711,1 Rola tad Tcpcs• Main Ti: piC S S h0 Pkt Card 1 of 1 se t [ the] howP ict of cord -, ViThen a card p.cttire or ti.a.c!JS-.„VR14-.Pj tr. :is hidden and you tty use a • set [the] showP i ct of 11-a! Paint tDol on it 0 r paste a picture onto it, a to ...e.!::::•!!!6:0::::!cg.i.E• dialo 2 box appears asldn2 if you want make the picture visible. lac1:1i-ii2 The shou.,P i t property returns or set shows the picture, elickin2 the C'arte el whether Hyper Card ship vkis any 2ra s button cane els the aetion. or paint text fo ra ea rd and b a c17)2round. The default 7.7a1ue is true, meanin2 that all If you draw on a hidden prieture ftom 2ra phie s and paint appear. a handler, you do not 2et the (=halo b 0 3<.. and whatever you draw will appear after you set showP i t to true. End of TO pie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti:' piC S size Card 1 of 1 the size of The s i ze property returns the size of lite specified slack in bytes. The s i ze property can't b e chan2ed with the set con-imand. Its chan2ed ordy by addin2 and dele1-4-12 objects arid 1:,rraphics fttim a slack. You must compact the slack tp recover the space occupied by the deleted objects arid 2raphics. End cif TOpie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti: piC S stacksInUse Card 1 of 1 the •r•tack:r•I niSrAm Note: You can't compact a slack thatbein2 used. The stacks I n USE. FirlD petty returns a return-separated list of slacks that have been inserted into the messa2e-passin2 path T..;ria the s tar t us i rig COrnrnand. Each slack appears in t_he Order it will rec. eive messa 2es The s tacks I nUse cordzins the full path names of the slacks bein2 used. HyperCard can use up to 16 slacks. End cif TOpie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main TOFilsCS ••,••••••• style Card 1 of 1 •=.et [the] the stu le of teLe.L.S.,,I.7.?:.• A button ':an have one of the foliar/cif-1.2 t1:1 styles: transparent.. onor. rec tang .=• [ t h e ] the sti4 Le of roundRec t.. check.Boxj p p p, t 0 f d;:-T• default, shadow, standard.. or rodioButton. The sty le property returns or set the style 0 f butbn or field. It eorrespDnds tD A field ':an have one of the followin2 the items in the Style pop-up menu in a styles: transparent, conar.Aue„ rec tong le.. Button Inf 0 0 f a Field Info dialo 21)0 7•:: shadow.. Of scrolling. End of TO pie e E-.•!,:•amplces• REVorcedTcpcs /via It. Ti:' FriC S susp en de d Card 1 of 1 the suspended HyperCard ,rives time to MultiFinder The suspended property returns whether (arud thus to other pm 2rrams) as follows: HyperCard is currently runnin2 in the back2round under MultiFinder® 0 r under • After it executes each HyperTalk_ System TX. You can switch to another siatement in a handler prci,rrarrt while a handler is runnincr• and • ).,•11Thertever it rotates the busy cursor scripts will continue to run in the (darin e o mra . s 0 /lift Cr back2round and printincr) • D1rin2 the ex:ecution of the Us e the suspended I:Tippet-1=5r in a bilt.-45, show dards command and the to alter the handler's behavior if its i t command runnin2 in the backi2round—for example.. tO avoid idisplayin 2 ask. or answer dialog boxes. ad of TO pie E,:•amplos• 711,1 Roloted Tcpcs• Main Ti:' FriC S t extAll gn Card 1 of 1 [the] tex tA Li gn to You can set the tex tA i gn for radio [the] tex tA Li gn of buttons and check boxes. but the text 1:1:1 always 'displays ali2ned Left. [the] tex tA Li gn of aii.7nment You can't set the te::.::tAl i gn for a chunk of text. The tex tA Li gn pt-operty returns or sets the way Paint text, text in a field„ or a button name ali_rns within its rec1.n21e. It can alin Left.. r i qht. or center The default value is Left for fields and paint text. and cen ter for buttons. End cif TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti:' piC S teXtAITOWS Card 1 of 1 se t [ the ] t ex t Ar r o en!r7l •E• Tkeilhen the tex tArrows property is true, the arrow keys rnoT,7e the text inset-Ilion The t ex t Fir r ows property returns or point around in a field that you're editin2 sets whether the arm W. keys rft0 e the or in the Messa 2e box, if you're not insertion Feint in a field or move you editincr, they n-to e you throu2h cards. throu2h. HyperCard deterrrtines the default s etlin2 When the tex tArr s FTO ett.rp, is false.. for tex tArrows at sizrtup (and when the Fi2ht Arrow and Left Arrow keys HyperCard resunles after b ein2 always lzke you to the next and previous suspended) from the cards in the slack., and the Up Arrow and option on the Preferences card of the Down Arrow keys take you forward and Home sizek. backward throu2h the cards you' e already viewed. End cif TO pie e Ex•amplos• 711,1 Roloted Tcpcs• Main Ti:' FriC S textFont Card 1 of 1 set [the] textFont to teRve The default value is Geneva for fields., .=.Pt [the] textFont of [c./ye,yi.k of] Paint text„ and the Messa2e box; the fieidfn te:,4 'default value is i cago for buttons. •=.17-.t [the] textFont of button to teRve .=.Pt [the] textFont of the message box-, Note: if a churd::_ of a field cordains a mi>ture 0 f fonts., HyperCard returns to ..e..cyt mixed when you ask for the textFonts where t is the name of a font available fmm the cim'ent slock. The textFont property returns or sets the current font of th e Paint Text tDol„ text in a field., a button name, or the Messa 2e box. End cif TO pie E..!,:•amplos• REVorcedTcpcs Main Ti: FriC S textH eight Card 1 of 1 et [the] te>::tHe i ql-it to c.:5_.7!,..Y.fgf.?:::' You can't set the the te>::tHe i qht to a •7 Pt [the] te>::tHe i ol-it of value less than the texts i ze. 1:1:1 The textHe iof_ property affects a field The teYtHe i ght property returns or only when the field's f i •edL i neHe i ght sets the space in piyels between the Fritiperty is true. baselines of Paint tel4 or ten4 in fields tHe light doesn't apply to buttons because butto ':an n display ordy n e of ten4 ) The default T..7alue is the ';.;ralue of the texts i ze property plus 0 n e - third of that TTallte End cif TO pie E,:•amplos• 1 711,1 Roloted Tcpcs• Main Ti:' FriC S textSize Card 1 of 1 set [the] textS i ze to c17;!!...,•••••S.f.g.?.: Note: if a 'hi in}: of a field cordains a '7P [ t he ] textS i ze of [",:;N:•2r. n miyture of sizes.. HyperCard returns field tn m i xed when you ask for the te::.::tS i set [the] text5 i ze of bent er.)•5• to set [the] textSize of the message boxn t1:1 The texts i ze propel-17,p, returns or sets the size.. in pri;.7:43„ of the font for Paint text., text in a field, a button name, 0 r the Messa bo>::. The default value is 12. End cif TO pie E,:•amplos• 711,1 Roloted Tcpcs• Main Ti: FriC S ••,••••••• textStyle Card 1 of 1 the tex tS tu Le to The style can b e a sin2le text style or [the] textStu Le of [0..eM: of ] a comma-separated list of styles. The available styles are 1p ai n• I -Ic„ if I i [the] textStu Le of k.W...eyv under Li ne„ out L i ne„ shadow, condense.. tn 4e, extend., and group. 170 see 2roup text, set the textStu Le of :7qr.y/f?T issue the 1-1-I_ a_ of-1 S I- gr oups .) cif 55:6:!•1P: to Sf:.),•::Mt.W: set [the] textStu Le of The default teyt style is pLai n. the message box to Note: if a 'hi in}: of a field contins a The te)::tSty Le property returns or set miyture 0 f styles, HyperCard returns the styles in which Paint text, field text, m i xed when you ask for the textSty Le. button nan-Les, menu items, or text in the Messa 2e box appear. End of TO pie E,:•amplos• 1 rips 711,1 Roloted Tcpcs• Main Ti:' piC S titleWi dth Card 1 of 1 You can ak„,0 c.nan2e the space allocated to set [the] ti tLeWidth of the title by dra.22in2 the left side of the to button's content area with the Button to01 Or by chan2in2 the Title Width s ettin2 in the Butto rt. Info dia10:2: box. The tittellidth property retrieves or sets the width in eJs of a pop-up butbn's title area. Cate pDp-up button's name appears as the menu title to the left of the collaps ed button.) Coins Dime t i dth 5et to 42 End cif Topic e i".••••••?3,.. E,:•amplos• ,N; • § § Main Ti:' pies top Card 1 of 1 the top of You can't set the _op t -1:LL the menu bar. [the] top of 211,• e toe". t r, • tec7E:.•-• HyperCard determines the top of [the] top of •-••tE-7E,•-• buttons, fields, and Hyperfards [the] top f eiy necyp t 0 ..,•••5• itEy.76,6- windows relative to the top-left corner of [the] top of menuBar the current card. The top /Dm/Deity returns or sets an HyperCard detern-Lines the top of the inte 2er equal to item 2 of an elements card window relative to the tDp-left recizn21e. If you set the top of an object. it corner of the screen with the menu bar. moves T..7ei1-ically.; the object's size remains the same. You can't set the top of cards: use the rect., he i ght.. and 0.1 i dth Fro/Derldes to resize the cards in a slack. End cif TO pie e E-..%:* ample s• REVorcedTcpcs Main Ti:' piC S to p Left Card 1 of 1 the topLeft of card You can't set the topLeft of the menu bar. .7Pt [the] topLeft of tveen to pc...... e. .=....t [the] topLeft of 11E1c:to------point HyperCard determines the topLeft . . •7et [the] f_opLeft ofepyp5L-klye? to po.i.,5•_____. e of buttons.. fields, and HyperCard's get [the] topLeft of menuBar built-in windows relative to the top-left corner of the current card. The topLeft property returns or sets a pcit equal tr, items I and 2 of an HyperCard determines the topLeft Of elements recizn21e. If you set the the card TATindo Tic r e tiv e to the p- e ft topLeft of an object, it moves, the corner of the screen with the menu bar. objects size rerrtains the same. You can't set the topLeft of cards: use the rpct„ he i ght„ and dth properties resize the cards in a sic}:. End cif TO pie e E,:•amplos• 711,1 Roloted Tcpcs• Main Ti:' piC S tracenday Card 1 of 1 the traceDeLaul to eefk?..t.:: Tallet'e speCifies ticks. The traceDe Lay property returns or set the number of ticks HyperCard pauses b etATe en each slaten-tent as it traces a 1-4ndlfr„ while in the debu22er. Its default value is 1::). End cif TOpie e E,:•amplos• REVorcedTcpcs Main Ti:' FriC S userLevel Card 1 of 1 set [the] userLeve to Feca-7.1nitEy76:e-•-•-•••••••-•-•••-•-•-•-• HyperCard deternlines the default settin2 • fOr userLeve I from the Preferences card V4There IS 1.. 2, 3, 4, or 5. of the Home sizek at siartup arid when HyperCard resumes after I) ein2 The userLeve t property returns or sets suspended. the user le,Jel as follows: 1 7.• = = F,•!?,.1.rattry1.9. 4 = = End cif TOpie E,:•amplos• DOM° Script rips 711,1 Rola tad Tcpcs• Find Ti: piC Main Ti:' piC S userM o dity Card 1 of 1 set [the] userMod i fLi to truee•_75-Fe711-7E• The userrlod i fy is Set tO false when the user chan2es slacks or quits HyperCard. The user Hod i fy FrOperty returns or sets vi,Theth.er the user can ten-tporaritp, t:p7pe Nute. userrlod i ty has to effect Liti an into fields. use the Paint t k and move urdocked slack. r delete ect in a lnri:Pd. slark HyperCard discards any chan2es made by the user or a handler when it leaves the card, a1thou2h a handler can record the chan2es and save them t):, another slack or file. End cif TOpie e E-..%:•ampices• •••••:. 711,1 Roloted Tcpcs• Main Ti: piC S variableINTatcher Card 1 of 1 set [the] %...ar jab eWa tcher To chan2e the value of a variable using to r.Eceue-celame Hyper Cards Variable Watcher, click to select a variable. Its value appears in the The war lab el./a tcher property returns bottom panel. Edit the value„ and press or sets the name of the e:.,,t_en-gl cp3N-1-Apd Enter save it. r M ) that displays the Ta nab e Wa te h e r TIATInd0 TAT for ins p e e tin 2 the values Third-party developers can supply other of local and variable watchers that you can ins b. II int] 2Iob a 1 Ty-a nab e s I-17p e r Card. The name of Hyp rfards variable Click Tips for information ab 0 Ut the watcher is iyiar i ab eLla tcher pitipetties 0 f the Variable TIATatcher. End cif TO pie E,:•amplos• rips 711,1 Roloted Tcpcs• Main Ti: FriC S version Card 1 of 2 the vers i on [of HuperCard xx The major revision ntu-nber the Long ...•ers i on [of HuperCard uu The rniruDr revision nurnber the ../ers iOn Of stack zz The software site., where 80 = final TI-it %.,ersi on property returns lite 60 =bta ve I'S ion ntu-nb er 0 f the HyperCard 40 = alpha application that is cuff endy rurinin2. You 20 = development can't set the i On. rr The release ntu-nber The Long version returns an 8-di21t For e>ample, 022015044 is version 2.2 number in tile fonyt bet. release 44.. and 14-2-214H141414 is version as follows: 2.2 final. --- More --- rvoo, • E,:•ampices• DOM° S t WYVVY, Main Ti: piC S ••,.• •• • velsion (cont d) Card 2 of 2 The •„, ers i on of e turns a • Item 4 is the version that has n-Lost coffin-La-separated list of five numbers recently chan2ed the slack. in the ron-nat of Macintosh version resour12 es: • Item 5 is the rittrrib e r of seconds fmrci 12:00 midni2ht 1/11/1)4 to the last time • Item 1 is the version of HyperCard that the sick was chan2ed. that created the slack. • Item 2 is the version that last compacted the slack. • Item 3 is the oldest version tO charL2e the slack since the last Compact Slack. End cif TO pie e • •• ••• • • ••• • p : • e Main Ti:' FriC S visible Card 1 of 1 •r. t [the] visibLe of buten...5. Settin2 the %.? isibte of a window to true t° makes it the front-I-Lost •=•Im [the] visibLe of JciEld t° With external TATindo-ws„ an e37::te•rnal„ •r.in [the] visibte of '.3.9P-R-.1,41.4 r .external fijni:tji:iri must first to .f:J.::::7:e./47f create a window b efore the isib le will '71m t [the] %.eisibLe of 6::v. itEM7 l-101CM —1 work on it. Settin2 the i isib Le of a to k-vec...:Faise window tO trtte (showin2 it) will not SP t [the] visibLe of menuBar create the windi:uw. uimi1arly. settin2 the to 6 -eieanc7IEE visibLe of a window to false a-ddin2 doesn't remove it ftpm the it ToV t The visibLe property returns or sets (from memory); use the Lose whether a button.. field.. windoW, or the cornmand to dispose of a window. menu bar is T• iisble on tl---te screen. EndcifTOpie Ex•amplos• DOM° Script 711,1 Roloted Tcpcs• Main Ti: FriC S wi deM ar gins Card 1 of 1 set [the] derloro iris o f tin t.-veea TI-it derlor ns FrOrierty returns or sets whether HyperCard adds extra space between the ed2es of a field and its text (to make it easier to read). It correspDnds to the Wide Mar2ins check box in a Field Info dial° 2 box. The default value is false. End cif TOpie E,:•amplos• DOM° S t 711,1 Roloted Tcpcs• Main Ti:' piC S wi dt h Card 1 of 1 set [the] width of bertero-5- to •=•Pt [the] width of e E. Id t ve Note: HyperCard restricts the width of a Pt [the] w idth of cang• tE-7E,- card tp 32-pixe1 increments be2innin2 et [the] width of epli5-dow to integer fiD M 64„ the smallest width. For e>ample, get [the] width of menuBar 5ettin2 the width of a card to 420 restdts in a width of 416. The dth property returns or set an inte 2er equal to the TATidth in of the HyperCard nlainiains the location (center specified object or w_it-tdow. Settin2 the cciordinate) of the object.. expandin2 0 r width of a button, field.. cir card window 5hrirddri.2 it o both resizes it. sides everdy. Settin2 the width of a card resizes the cards in a slack. End cif TO pie e if..%:•amplos• 711,1 Roloted Topics Main Ti: FriC S zoomed Card 1 of 1 get [ the ] 0 med f ming'om is any window wit}t a zoom box. set [ the 0 0 med 0 f mief.dom , is straddling tWO dispLiys, to 6.-eien.-:Faie setting the zoomed tO true °Fier LS to its full size and 111 enters it on the TO/hen the zoomed IS true, IS display holding more than half of the full sized and centered on the current windoTAT's image. display. The zoomed becomes false when the user drail.rs the window from its C:lickini2: the zoorri. box to 221es the ori2ina1 position and" or resizes it. zccirried b etrae en true and false. Erud cif TO pi': i".••••••?3,.. E,:•amplos• DOM° S t 1.>/?•!•:- ,N; • § § WYVVY Main Ti: piC S Arithmetic operators Card 1 of 1 Operators lack_ an operator for a description of it. (lack Tips for rnor e information about operator Pr e e ne e div o d End cif TO pie Tips 711,1 Roloted Tcpics § 0, Find Ti: pie Main Ti:' piC S • • • •• • • • • Comparison operators Card 1 of 1 Operators lac, I:7_ an operator for a description of it. s t (lack Tips for more information about operator Pr e e e e :::• <=, >= , 2 t a i ris is in i s t i s i thi ri i s t t1-1 End cif TO pie Tlps 711,1 Roloted Tcpics § 0, Find Ti: pie Main Ti: FriC S Logical operators Card 1 of 1 Operators lack_ art operator for a description of it. no t 11 d (lack Tips for rnore infonnation about operator or Pr e e ne e aud cif TO pie Tips 711,1 Roloted Tcpics § 0, Find Ti: pie Main Ti:' FriC S String operators Card 1 of 1 Operators lack_ an operator for a description of it. (.1The1:: Tips for /yore information about operator Pr e edene e End cif TO pie Tips 711,1 Roloted Tcpics § 0, Find Ti: pie Main Ti: piC S Type and odstence operators Card 1 of 1 Operators lack_ art operator for a description of it. is a, is an there is a, there is an (lack Tips for rnore infonnation about operator there is no precedence) there is not a aud of TO pi': 711,1 Roloted Tcpcs• § 0, Find Ti: pie Main Ti: FriC S Constants Card 1 of 1 Constants " lack_ a emslant for a description of it. coLon 12 commq El down emptw fqLse formFeed LineFeed p i quote return spqce tot, true ,(7:- - End cif TO pie e "16 R § W : : : : : : : : : : : : : : : : : : : : : : : : : : • • • '•••,. • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • q. Find Ti: FriC Main Ti:' FriC S •••••••• ••• ••• ••• ••• ••• ••• ••• ••• ••• ••• ••• ••• ••• •••••• ••• ••• ••• •• ...• • • Find Topic To find topics related to a subject.. type one or rruDre words into the bO>:: and click Find. Or click one of the 'Sample Subjects. Subject: markchar 1Find 1 Sample Subjects: Topics found: I all topics markChar new features I•:-.•.'4-3 Go Pack_ Related Topics Topics related to: scriptText FOrtt script rack a related topic to 2o to it. ,IscriptEditor Related topics that you've already S riptT e Siz e visited appear with a Nr Set the font and size of a script ,r1.7 Rettu-ri to "scriptTe>t Font' Overview of Help Where am I? 'You're currently in the Hyp erTalk Ref erence s k. This s e 17_ d e s e s 1-15,pe rTallc. Hyp e r yds s ript What c:an I do? lari2ua 2e. By TATritin2 your own scripts.. yo lA ha 1;1 e ECItte h more control over HyperCard than is available usin2 just Where can I go? the menu commands. You can make a slack do what you want it to do. If you're neww you shotdd 2,D thn:111211 the third chapter of the Hypeifizid Re fa' IE72 1,1c-a2ua i for s can e Ip 2 LriirLrr practice. 0% Find Ti: pie IGD Pack Overview of Help Where am I? Besides us1n2 the Main Topic's card to locate topic's.. you ':an: What can I do? • caiek the Find Topic butbn at the botbin of every eard Where can I go? to 11=11:11:1 for topics rnatehin2 TATords that you enter. • Ciek the Examples.. Dento Scripts.. and Tip s butto at the botto In 0 f a topic. card to see more information. lack Related Topics tO jttnipto 0 th e r tO pries in this siaek related to the one you're 0 11 • cai,21:7_ a.e.tiyev.t e 7,:t with a thie :;_rra y und e rlin e tD see p- up, d e ris This irte lud es H.57p e rTa11:7_ pla ld ers s ....1 s h as 0% Find Ti: pie IGD Ea,21,7_ Overview of Help Where am I? HyperCard has three Help slacks. You can move between then-L by choosin:2: the one TO 11 want frorn What c:an I do? the Help menu: Where can I go? • The HyperCard Help slack describ es how to bmwse thipu411 and author HyperCard slacks. • This slack. the 14perTalk Reference slack. describes HyperTalk.. the lanLua :2:e you use to write scripts. • The Help Extras slack contains 21ossary items, tips.. and tvDubleshootin2 inforn-Lation us ed by this slack_ and by the HyperCard Help slack. 0% Find Ti: piC IGD Pack