TweetFollow Us on Twitter

Newton Q&A final rev

Newton Q & A: Ask the Llama

Q I'm trying to remove indexes that I've added to the names soup. But the code to do it is kind of ugly. First I have to go through all the indexes to see if my index is in the soup. Then if I find the index, I can remove it. Is there an easier way?

A Yes, there's an easier way. Remember that a call to RemoveIndex will throw an exception if it's passed an invalid index. You can wrap your code in an exception handler and prevent the invalid index exception from leaving your code:

ExceptionBasedRemoveIndex := func(theSlotsym, theSoupName) begin local theSoup; foreach store in GetStores() do begin theSoup := store:GetSoup(theSoupName); if theSoup then try theSoup:removeIndex(theSlotsym); onexception |evt.ex.fr.store| do if CurrentException().error <> -48013 then ReThrow(); end; end

This function will remove a particular index (specified by theSlotsym) from a particular soup (specified by theSoupName) on all currently mounted stores. If the index exists, it will be removed; otherwise, the exception thrown for trying to remove an invalid index will be caught and ignored. If a different exception occurs, it will be rethrown so that other exception handlers or the system can deal with the exception.

Q I'm writing a utility that is an auto part. My utility needs preferences, but there's no application to add preferences to. Where should I put my preferences?

A The guidelines for preferences are simple: * For any addition that has an icon in the extras drawer, the preferences should be part of that application. Use the info button to access them. * For something that has no icon in the extras drawer, add your preferences to the system preferences roll.

See the sample "Preefer Madness" on this issue's CD for more information.

Q When text gets pasted into my paragraph view, that text is highlighted. I want to be able to detect when this happens and then be able to unselect the text. How do I do that? 

A When the text gets added, the viewChangedScript will get called with the slot parameter set to 'text. You can use the SetHilite message to unhighlight the text. However, the viewChangedScript will get called before the underlying implementation of the paragraph view has been changed. This means you need to call SetHilite in a deferred action.

Q I'm writing a specialized application for a corporate customer. One of the requirements is that the application launch when the Newton is turned on (a "turnkey" application). Is there a way to do this with the Newton? 

A You can use the installScript of your application to add a deferred action that opens your application:

constant kAppSymbol := '|autoLaunch:PIEDTS|; installScript := func(partFrame) begin AddDeferredAction(func() GetRoot().(kAppSymbol):Open(), []); end;

This will launch your application whenever the Newton is restarted or a card containing your application is inserted. Note that if the application is closed before the Newton is restarted again, the application will not relaunch. Nor will the user be prevented from accessing other features of the Newton such as Names, Dates, or Extras Drawer; that's a much harder problem.

Q I've been trying to use the protoRoll and protoRollItem to create a roll browser of my own. Everything works fine until I scroll. For a couple of these items I need to tap the down arrow twice for it to go to the next roll item. I see the scrolling view effect, but it just scrolls to itself.

The height slot in each of the roll items has the same value as the height in their viewBounds slot. If I move the roll items around when they're added to the protoRoll (dynamically from my own protos), they work fine. How can I fix this? 

A The problem is that one of the protoRollItems in the items array is larger than the protoRoll. If you make the roll browser larger than the largest roll item, all will work fine; otherwise, you have to scroll the roll item twice to move to the next roll item.

Also, since you imply that the entire large roll item is visible, I assume that the protoRoll has vClipping turned off. If you'd had clipping on, you would probably have noticed that the individual roll item was too large.

Q I'm having some problems with margins when I'm faxing. A fax without a cover page has different margins than a printed page. The actual viewBounds is the same, but the margins of the fax are different from the viewBounds.

Also, a fax with a cover page has even different margins. The viewBounds is different, too (20 pixels shorter in height), but that's OK. The problem is that the actual margins when faxed are different from those specified by the viewBounds slot. Is this a known problem? 

A Faxes with a cover page have a header line at the top of the fax which takes up those mysterious 20 pixels. In fact, it might be a bug that faxes without a cover page omit this header, but perhaps the only bug is not documenting that protoPrintFormat (which provides the cover page) also adds that header.

The way to find the correct page bounds is to set the viewBounds of your base print view to that of the parent. The base print view is usually a clView that is a child of a print layout. You can use the following code in the viewSetupFormScript of your base print view to set your bounds to those of your parent: viewBounds := :Parent():LocalBox();

Q I've got an auto part that installs a template for the formulas roll. On the roll item I've got a protoLabelInputLine for data entry, and a button that I want to use to clear the input line. My buttonClickScript is very simple:

buttonClickScript := func() begin SetValue(myInputLine.entryLine, 'text, ""); end;

The first time the button is tapped, the input line gets cleared OK; after that it never seems to work, no matter how I code it. Can you help? 

A This is a very subtle problem. The answer will be revealed in stages, so that you too can experience the "Aha!"

Observation 1: When you edit the text in any clParagraphView, no new strings are generated. The existing string is destructively modified (excluding the usual _proto copying, of course).

Observation 2: During the compile cycle, the Newton Toolkit will turn all your strings into constants. Contrast this to using braces to construct a frame. As an illustration, assume you have these three methods:

Method1 := func() begin return {slot1: "also string"}; end;

Method2 := func() begin return '{slot2: "also also string"}; end;

Method3 := func() begin return "a string"; end;

The braces specify a frame constructor. Each time you call Method1 it will return a reference to a newly allocated frame, though not different contents. For example, when the following is executed

myVar := call Method1() with ();

here's what you get in memory:

[IMAGE Newton_Q&A_final_html1.GIF]

On the other hand, Method2 quotes the frame, which makes it a quoted constant. In other words, each time you call Method2 it will return a reference to the same frame. And Method3 does something else altogether: In the Newton Toolkit, a string is treated like a quoted frame (or array). It's a constant object, so each time you call Method3 it will return a reference to the same string. Note that this means that in both Method1 and Method2 the slot in each frame will reference the same string. Diagrams that show what happens in memory when each of these three methods is executed are provided on this issue's CD along with this Q & A column.

Observation 3: When you call SetValue, you're actually copying the reference to the empty string from your buttonClickScript into the text slot of the entry line. You might think this would cause an error, because the string constant can't be modified. But clParagraphViews are smart: if the string can't be modified (that is, if it's read-only), a copy is made.

Observation 4: I checked in the inspector, and your buttonClickScript is not read- only. This means that the string constant "" in that script is also not read-only.

Observation 5: To prevent the grip of death on a card, you would need to call EnsureInternal on your formula roll entry. This effectively makes a copy of the entire template, including constants, in the NewtonScript heap. The following illustration contrasts a Clone with a DeepClone (which is what EnsureInternal uses). Note that the DeepClone creates a new read/write copy of the string.
















Conclusion: You press the Clear Data button once. This sets the reference of the input line string to point to the string constant in your buttonClickScript. Since the string constant is no longer read-only, changing the input line string destructively modifies the string constant. You may think that this would lead to a bus error or worse, but thanks to NewtonScript, it works as it should. The next time you press the Clear Data button, the input line string reference gets replaced with a reference to the now modified string constant.

[IMAGE Newton_Q_A_final_html2.GIF]

The solution is to change the SetValue call to

SetValue(dataItem.entryLine, 'text, Clone(""));

This will make a copy of the string constant and return a reference to the copy.

Q Just recently I came into possession of a sword. It was handed to me by a lady in a lake whose arm was clad in the finest shimmering samite. I figure with this sign of divine providence I should be able to wield supreme executive power. What do you think? 

A Fortunately, strange women in ponds have not been used as the basis for a system of government since the Dark Ages. These days supreme executive power derives from a mandate from the masses, not from a farcical aquatic ceremony. If I claimed to be President just because some aquatic gymnast threw a sword at me, I'd be locked up for sure.

The llama is the unofficial mascot of the Developer Technical Support group in Apple's Personal Interactive Electronics (PIE) division. Send your Newton-related questions to NewtonMail DRLLAMA or AppleLink DR.LLAMA. The first time we use a question from you, we'll send you a T-shirt. *

Thanks to Don Gummow and our Newton Partners for the questions used in this column, and to jXopher Bell, Bob Ebert, Mike Engber, Kent Sandvik, Jim Schram, and Maurice Sharp for the answers.

*Have more questions? Need more answers? Take a look at PIE Developer Info on AppleLink. *

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Sound Studio 4.8.11 - Robust audio recor...
Sound Studio lets you easily record and professionally edit audio on your Mac. Easily rip vinyls and digitize cassette tapes, or record lectures and voice memos. Prepare for live shows with live... Read more
BetterTouchTool 2.291 - Customize Multi-...
BetterTouchTool adds many new, fully customizable gestures to the Magic Mouse, Multi-Touch MacBook trackpad, and Magic Trackpad. These gestures are customizable: Magic Mouse: Pinch in / out (zoom... Read more
Carbon Copy Cloner 4.1.18 - Easy-to-use...
Carbon Copy Cloner backups are better than ordinary backups. Suppose the unthinkable happens while you're under deadline to finish a project: your Mac is unresponsive and all you hear is an ominous,... Read more
Hopper Disassembler 4.2.14- - Binary dis...
Hopper Disassembler is a binary disassembler, decompiler, and debugger for 32- and 64-bit executables. It will let you disassemble any binary you want, and provide you all the information about its... Read more
VOX 2.8.30 - Music player that supports...
VOX just sounds better! The beauty is in its simplicity, yet behind the minimal exterior lies a powerful music player with a ton of features and support for all audio formats you should ever need.... Read more
Default Folder X 5.1.6b3 - Enhances Open...
Default Folder X attaches a toolbar to the right side of the Open and Save dialogs in any OS X-native application. The toolbar gives you fast access to various folders and commands. You just click on... Read more
CleanMyMac 3.8.6 - $39.95
CleanMyMac makes space for the things you love. Sporting a range of ingenious new features, CleanMyMac lets you safely and intelligently scan and clean your entire system, delete large, unused files... Read more
Postbox 5.0.17 - Powerful and flexible e...
Postbox is a new email application that helps you organize your work life and get stuff done. It has all the elegance and simplicity of Apple Mail, but with more power and flexibility to manage even... Read more
Amazon Chime 4.6.5852 - Amazon-based com...
Amazon Chime is a communications service that transforms online meetings with a secure, easy-to-use application that you can trust. Amazon Chime works seamlessly across your devices so that you can... Read more
coconutBattery 3.6.3 - Displays info abo...
With coconutBattery you're always aware of your current battery health. It shows you live information about your battery such as how often it was charged and how is the current maximum capacity in... Read more

The best 2v2 card combos in Clash Royale
2v2 is making it's grand return toClash Royalequite soon. 2v2 has quickly become one of the game's most popular gameplay modes, though they still have yet to make it a permanent fixture in the game. 2v2 is exciting and adds some new flavor to... | Read more »
The best games we played this week - Aug...
Another busy week has come to a close. We played a lot of excellent games this week and now it's time to look back and reflect on some our favorites. Here are our picks for the week of August 18. [Read more] | Read more »
War Wings beginner's guide - how to...
War Wings is the newest project from well-established game maker Miniclip. It's a World War II aerial dogfighting game with loads of different airplane models to unlock and battle. The game offers plenty of single player and multiplayer action. We... | Read more »
How to win every 2v2 battle in Clash Roy...
2v2 is coming back to Clash Royale in a big way. Although it's only been available for temporary periods of time, 2v2 has seen a hugely positive fan response, with players clamoring for more team-based gameplay. Soon we'll get yet another taste of... | Read more »
Roll to Win with Game of Dice’s new upda...
Joycity’s hit Game of Dice gets a big new update this week, introducing new maps, mechanics, and even costumes. The update sets players loose on an exciting new map, The Cursed Tower, that allows folks to use special Runes mid-match. If you feel... | Read more »
Bottom of the 9th (Games)
Bottom of the 9th 1.0.1 Device: iOS iPhone Category: Games Price: $4.99, Version: 1.0.1 (iTunes) Description: Play the most exciting moment of baseball in this fast-paced dice and card game! | Read more »
The best apps for viewing the solar ecli...
If you somehow missed the news, many parts of the United States will be witness to a total solar eclipse on August 21 for the first time in over 90 years. It'll be possible to see the eclipse in at least some capacity throughout the continental U... | Read more »
The 5 best mobile survival games
Games like ARK: Survival Evolved and Conan Exiles have taken the world of gaming by storm. The market is now flooded with hardcore survival games that send players off into the game's world with nothing but maybe the clothes on their back. Never... | Read more »
Portal Walk (Games)
Portal Walk 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Portal Walk is adventure and relaxing platform game about Eugene. Eugene stuck between worlds and trying to find way back home.... | Read more »
Technobabylon (Games)
Technobabylon 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: City of Newton, 2087. Genetic engineering is the norm, the addictive Trance has replaced almost any need for human interaction,... | Read more »

Price Scanner via MacPrices.net

Weekend sale: 13-inch MacBook Pros for up to...
Amazon has new 2017 13″ MacBook Pros on sale today for up to $200 off MSRP, each including free shipping: – 13″ 3.1GHz/256GB Space Gray MacBook Pro (MPXV2LL/A): $1599.99 $200 off MSRP – 13″ 3.1GHz/... Read more
Back To School With The Edge Desk All-in-one...
Back to school is just around the corner, and the ergonomically correct Edge Desk all-in-one portable kneeling desk is ideal for students living in dorms and small apartments, Edge Desk features:... Read more
Norton Core Secure Wi-Fi Router Now Available...
First introduced at the 2017 Consumer Electronics Show (CES), Norton Core, a secure, high-performance Wi-Fi router, fundamentally changed the concept of Wi-Fi routers by making security the primary... Read more
ViewSonic Adds New 27-inch 4K UHD Monitor to...
ViewSonic Corp. has introduced the VP2785-4K, a 27-inch 4K UHD (3840×2160) monitor that delivers precise and consistent color representation and performance to ensure incredible image quality. Built... Read more
Apple now offering Certified Refurbished 2017...
Apple is now offering Certified Refurbished 2017 27″ iMacs for up to $350 off original MSRP. Apple’s one-year warranty is standard, and shipping is free. The following models are available: – 27″ 3.... Read more
13-inch 2.3GHz MacBook Pros on sale for $100...
Amazon has the new 2017 13″ 2.3GHz MacBook Pros on sale today for $100 off MSRP, each including free shipping: – 13″ 2.3GHz/128GB Space Gray MacBook Pro (MPXQ2LL/A): $1199.99 $100 off MSRP – 13″ 2.... Read more
Clearance 2016 13-inch MacBook Airs available...
B&H Photo has clearance 2016 13″ MacBook Airs available for up to $200 off original MSRP. Shipping is free, and B&H charges NY & NJ sales tax only: – 13″ 1.6GHz/128GB MacBook Air (MMGF2LL... Read more
Clearance 21-inch and 27-inch iMacs available...
B&H Photo has clearance 21″ and 27″ Apple iMacs available for up to $500 off original MSRP, each including free shipping plus NY & NJ sales tax only: – 27″ 3.3GHz iMac 5K: $1799 $500 off... Read more
New iOS 11 Productivity Features Welcome But...
The iOS community is in late summer holding mode awaiting the September arrival of the iPhone 8 and iOS 11. iOS 11 public betas have been available for months — number six was released this week —... Read more
Samsung Electronics Launches New Portable SSD...
Samsung Electronics America, Inc. has announced the launch of Samsung Portable SSD T5 – its newest portable solid state drive (PSSD) that raises the bar for the performance of external memory... Read more

Jobs Board

*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Development Operations and Site Reliability E...
Development Operations and Site Reliability Engineer, Apple Payment Gateway Job Number: 57572631 Santa Clara Valley, California, United States Posted: Jul. 27, 2017 Read more
Frameworks Engineering Manager, *Apple* Wat...
Frameworks Engineering Manager, Apple Watch Job Number: 41632321 Santa Clara Valley, California, United States Posted: Jun. 15, 2017 Weekly Hours: 40.00 Job Summary Read more
Development Operations and Site Reliability E...
Development Operations and Site Reliability Engineer, Apple Payment Gateway Job Number: 57572631 Santa Clara Valley, California, United States Posted: Jul. 27, 2017 Read more
Frameworks Engineering Manager, *Apple* Wat...
Frameworks Engineering Manager, Apple Watch Job Number: 41632321 Santa Clara Valley, California, United States Posted: Jun. 15, 2017 Weekly Hours: 40.00 Job Summary Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.