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

Latest Forum Discussions

See All

Soft Drummer (Music)
Soft Drummer 1.0 Device: iOS Universal Category: Music Price: $14.99, Version: 1.0 (iTunes) Description: Soft Drummer is the closest thing to a pro session subtle drummer in your pocket. Easy to use and fast, it's much more than a... | Read more »
Is GO Gear the Pokemon GO map app you...
Now that we've settled into something of a Pokemon GO status quo, the number one desire of most players can best be summed out by modifying a quote from Rod Tidwell of Jerry Maguire: "Show me the Pokemon!" [Read more] | Read more »
Rodeo Stampede update: Mountains, new an...
The Savannah and Jungle were just the beginning in Rodeo Stampede. Get ready to head for the Mountains. I think I heard that in a beer ad once. [Read more] | Read more »
COSMOS RINGS (Games)
COSMOS RINGS 1.0.0 Device: iOS iPhone Category: Games Price: $5.99, Version: 1.0.0 (iTunes) Description: This game cannot be played without the Apple Watch.Released anniversary sale until August 31,2016 PST! A tragic tale of time's... | Read more »
How to get started selling on Mercari
As far as ecommerce has come over the last decade or so, there's still a tremendous opportunity to make it easier for people to buy and sell goods. That's especially true when it comes to shopping apps, which should only continue to increase in... | Read more »
Human Anatomy Atlas 2017 Edition - Compl...
Human Anatomy Atlas 2017 Edition - Complete 3D Human Body 1.0.24 Device: iOS iPhone Category: Medical Price: $24.99, Version: 1.0.24 (iTunes) Description: | Read more »
Heroes of Normandie (Games)
Heroes of Normandie 1.5 Device: iOS Universal Category: Games Price: $14.99, Version: 1.5 (iTunes) Description: The game does not support iPhone 4s and below | Read more »
Why you should never power up Pokemon in...
There's no question that candy is dandy in Pokemon GO. You need big quantities of it to evolve your Pokemon, and when combined with stardust, it can be used to power up your favorite pocket monsters as well, making them more formidable for the gym... | Read more »
Webzen launches 3D MMORPG MU Origin on i...
Mu Origin is featured time and time again at the very top of App Stores in China, and within the top five worldwide top-grossing charts on Google Play.Its popularity in Korea and China, featuring more than 120 registered players in China and 6... | Read more »
Severed (Games)
Severed 1.0 Device: iOS Universal Category: Games Price: $5.99, Version: 1.0 (iTunes) Description: LAUNCH DISCOUNT ON NOW!! ENDS AUGUST 4! ==== Take control of a one-armed warrior named Sasha, wielding a living sword on her journey... | Read more »

Price Scanner via MacPrices.net

9-inch 32GB Space Gray iPad Pro on sale for $...
B&H Photo has the 9″ 32GB WiFi Space Gray Apple iPad Pro on sale for $50 off MSRP including free shipping. B&H charges sales tax in NY only: - 9″ Space Gray 32GB WiFi iPad Pro: $549 $50 off... Read more
15-inch Retina MacBook Pros on sale for up to...
B&H Photo has 15″ Retina MacBook Pros on sale for up to $200 off MSRP. Shipping is free, and B&H charges NY tax only: - 15″ 2.2GHz Retina MacBook Pro: $1849 $150 off MSRP - 15″ 2.5GHz Retina... Read more
Second-Quarter Tablet Shipments Fell 4.8% –...
The latest report from the global market research firm TrendForce finds that worldwide tablet shipments for this second quarter totaled 33.54 million units, representing a quarterly drop of 4.8% and... Read more
Global Smartphone Sales Volumes Mark Second S...
According to preliminary results from the International Data Corporation (IDC) Worldwide Quarterly Mobile Phone Tracker, vendors shipped a total of 343.3 million smartphones worldwide in the second... Read more
Apple TVs on sale for $20-$40 off MSRP
Best Buy has 32GB and 64GB Apple TVs on sale for $20-$40 off MSRP on their online store. Choose free shipping or free local store pickup (if available). Sale prices for online orders only, in-store... Read more
Mac minis on sale for $50-$100 off MSRP
B&H Photo has Mac minis on sale for $50 off MSRP including free shipping plus NY sales tax only: - 1.4GHz Mac mini: $449 $50 off MSRP - 2.6GHz Mac mini: $649 $50 off MSRP - 2.8GHz Mac mini: $949... Read more
Clearance 2015 13-inch MacBook Airs available...
B&H Photo has clearance 2015 13″ MacBook Airs available for $300 off original MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 1.6GHz/4GB/128GB MacBook Air (MJVE2LL/A): $799... Read more
Apple certified refurbished iPad mini 4s avai...
Apple has certified refurbished iPad mini 4s now available for up to $120 off the cost of new models. An Apple one-year warranty is included with each iPad, and shipping is free. The following models... Read more
Notebook Makers In No Rush To Adopt USB-C – R...
Digitimes’ Cage Chao and Joseph Tsai note that while the USB Type-C interface is enjoying growing popularity among smartphones and tablet makers, notebook and all-in-one (AIO) PC vendors (other than... Read more
iMacs on sale for up to $250 off MSRP
B&H Photo has 21″ and 27″ Apple iMacs on sale for up to $250 off MSRP including free shipping plus NY sales tax only: - 27″ 3.3GHz iMac 5K: $2049 $250 off MSRP - 27″ 3.2GHz/1TB Fusion iMac 5K: $... Read more

Jobs Board

*Apple* Retail - Bilingual - Multiple Positi...
…speaking a plus Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the Read more
Simply Mac *Apple* Specialist- Repair Techn...
…The Technician is a master at working with our customers to diagnose and repair Apple devices in a manner that exceeds the expectations set forth by Apple Read more
*Apple* Mobile Master - Best Buy (United Sta...
What does a Best Buy Apple Mobile Master do? At Best Buy, our mission is to leverage the unique talents and passions of our employees to inspire, delight, and enrich Read more
Best Buy *Apple* Computing Master - Best Bu...
What does a Best Buy Apple Computing Master do? At Best Buy our mission is to leverage the unique talents and passions of our employees to inspire, delight, and Read more
*Apple* Valley, CA School Speech Therapy Ope...
Apple Valley, CA School Speech Therapy Openings + Job Location: Apple Valley, CA + Category: Schools - SLP - CFY + Apply Now! + Back to Results Speech Language Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.