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

VLC Media Player 2.2.0 - Popular multime...
VLC Media Player is a highly portable multimedia player for various audio and video formats (MPEG-1, MPEG-2, MPEG-4, DivX, MP3, OGG, ...) as well as DVDs, VCDs, and various streaming protocols. It... Read more
Sound Studio 4.7.8 - Robust audio record...
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
LibreOffice 4.4.1.2 - Free, open-source...
LibreOffice is an office suite (word processor, spreadsheet, presentations, drawing tool) compatible with other major office suites. The Document Foundation is coordinating development and... Read more
Freeway Pro 7.0.3 - Drag-and-drop Web de...
Freeway Pro lets you build websites with speed and precision... without writing a line of code! With its user-oriented drag-and-drop interface, Freeway Pro helps you piece together the website of... Read more
Cloud 3.3.0 - File sharing from your men...
Cloud is simple file sharing for the Mac. Drag a file from your Mac to the CloudApp icon in the menubar and we take care of the rest. A link to the file will automatically be copied to your clipboard... Read more
Cyberduck 4.6.5 - FTP and SFTP browser....
Cyberduck is a robust FTP/FTP-TLS/SFTP browser for the Mac whose lack of visual clutter and cleverly intuitive features make it easy to use. Support for external editors and system technologies such... Read more
Firefox 36.0 - Fast, safe Web browser. (...
Firefox for Mac offers a fast, safe Web browsing experience. Browse quickly, securely, and effortlessly. With its industry-leading features, Firefox is the choice of Web development professionals and... Read more
Thunderbird 31.5.0 - Email client from M...
As of July 2012, Thunderbird has transitioned to a new governance model, with new features being developed by the broader free software and open source community, and security fixes and improvements... Read more
VOX 2.4 - Music player that supports man...
VoxIt just sounds better! The beauty is in its simplicity, yet behind the minimal exterior lies a powerful music player with a ton of features & support for all audio formats you should ever need... Read more
A Better Finder Rename 9.46 - File, phot...
A Better Finder Rename is the most complete renaming solution available on the market today. That's why, since 1996, tens of thousands of hobbyists, professionals and businesses depend on A Better... Read more

Get The Whole Story – Lone Wolf Complete...
Get The Whole Story – Lone Wolf Complete is Now Available and On Sale Posted by Jessica Fisher on February 27th, 2015 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Check Out the Trailer for the Upcoming F...
Check Out the Trailer for the Upcoming FINAL FANTASY: Record Keeper Posted by Jessica Fisher on February 26th, 2015 [ permalink ] DeNA and Square Enix have announced that | Read more »
Legacy Quest is an Upcoming Rouge-like T...
Legacy Quest is an Upcoming Rouge-like That’ll Kill the Whole Family Posted by Jessica Fisher on February 26th, 2015 [ permalink ] Nexon Co. | Read more »
Grudgeball: Enter the Chaosphere Review
Grudgeball: Enter the Chaosphere Review By Jordan Minor on February 26th, 2015 Our Rating: :: MUSCLE MENUniversal App - Designed for iPhone and iPad Regular Show gets an above average game.   | Read more »
Action RPG League of Angels – Fire Raide...
Gaia is being invaded by the Devil Prince and the demonic Devil Army at his disposal, and it’s up to you and your avatar to defeat him in League of Angels – Fire Raiders. Raise a mighty army from hundreds of recruitable angel heroes and take the... | Read more »
Burn Rubber on the Ice With a New Cars:...
Burn Rubber on the Ice With a New Cars: Fast as Lightning Update Posted by Jessica Fisher on February 26th, 2015 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
AdVenture Capitalist Review
AdVenture Capitalist Review By Jordan Minor on February 26th, 2015 Our Rating: :: DAS KAPITALUniversal App - Designed for iPhone and iPad An inadvertent Marxist manifesto.   | Read more »
Monster vs Sheep Review
Monster vs Sheep Review By Jennifer Allen on February 25th, 2015 Our Rating: :: SAMEY FUNUniversal App - Designed for iPhone and iPad What Monster vs Sheep lacks in variety it makes up for with stress relieving fun. At least, for a... | Read more »
Is Your Face Ready for the New Outwitter...
Is Your Face Ready for the New Outwitters 2.0 Trailer? Posted by Jessica Fisher on February 25th, 2015 [ permalink ] One Man Left Studios has announced that their turn-based strategy game, | Read more »
HowToFormat Review
HowToFormat Review By Jennifer Allen on February 25th, 2015 Our Rating: :: USEFUL TIPSiPhone App - Designed for the iPhone, compatible with the iPad Making a presentation and want to get it just right? HowToFormat teaches you how... | Read more »

Price Scanner via MacPrices.net

Apple restocks refurbished Mac minis for up t...
The Apple Store has restocked Apple Certified Refurbished 2014 Mac minis, with models available starting at $419. Apple’s one-year warranty is included with each mini, and shipping is free: - 1.4GHz... Read more
Save up to $50 on iPad Air 2s, NY tax only, f...
 B&H Photo has iPad Air 2s on sale for $50 off MSRP including free shipping plus NY sales tax only: - 16GB iPad Air 2 WiFi: $469.99 $30 off - 64GB iPad Air 2 WiFi: $549 $50 off - 128GB iPad Air 2... Read more
16GB iPad Air 2 on sale for $447, save $52
Walmart has the 16GB iPad Air 2 WiFi on sale for $446.99 on their online store for a limited time. Choose free shipping or free local store pickup (if available). Sale price for online orders only,... Read more
iMacs on sale for up to $205 off MSRP
B&H Photo has 21″ and 27″ iMacs on sale for up to $205 off MSRP including free shipping plus NY sales tax only: - 21″ 1.4GHz iMac: $1029 $70 off - 21″ 2.7GHz iMac: $1199 $100 off - 21″ 2.9GHz... Read more
Apple Takes 89 Percent Share of Global Smartp...
According to the latest research from Strategy Analytics, global smartphone operating profit reached US$21 billion in Q4 2014. The Android operating system captured a record-low 11 percent global... Read more
New Travel Health App “My Travel Health” iOS...
Rochester, Minnesota based Travel Health and Wellness LLC has announced that its new iOS app help safeguard the user’s health when traveling abroad — “My Travel Health” is now available on the Apple... Read more
Sale! MacBook Airs for up to $115 off MSRP
B&H Photo has MacBook Airs on sale for up to $100 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 11″ 128GB MacBook Air: $799 100 off MSRP - 11″ 256GB MacBook Air: $999 $100... Read more
15-inch 2.0GHz Retina MacBook Pro (refurbishe...
The Apple Store has Apple Certified Refurbished previous-generation 15″ 2.0GHz Retina MacBook Pros available for $1489 including free shipping plus Apple’s standard one-year warranty. Their price is... Read more
Wither The iPad mini? End Of The Road Imminen...
AppleDailyReport’s Dennis Sellers predicts that the iPad mini is going to be left to wither on the vine, as it were, and then just allowed to fade away — a casualty of the IPhone 6 Plus and other... Read more
Android and iOS Duopoly Owns 96.3% of Smartph...
IDC reports that Android and iOS inched closer to total domination of the worldwide smartphone market in both the fourth quarter (4Q14) and the calendar year 2014 (CY14). According to data from the... Read more

Jobs Board

Sr. Technical Services Consultant, *Apple*...
**Job Summary** Apple Professional Services (APS) has an opening for a senior technical position that contributes to Apple 's efforts for strategic and transactional Read more
Event Director, *Apple* Retail Marketing -...
…This senior level position is responsible for leading and imagining the Apple Retail Team's global engagement strategy and team. Delivering an overarching brand Read more
*Apple* Pay - Site Reliability Engineer - Ap...
**Job Summary** Imagine what you could do here. At Apple , great ideas have a way of becoming great products, services, and customer experiences very quickly. Bring Read more
*Apple* Solutions Consultant - Retail Sales...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
*Apple* Solutions Consultant - Retail Sales...
**Job Summary** As an Apple Solutions Consultant (ASC) you are the link between our customers and our products. Your role is to drive the Apple business in a retail Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.