TweetFollow Us on Twitter

Apr 96 Top 10
Volume Number:12
Issue Number:4
Column Tag:Symantec Top 10

Symantec Top 10

By Andy McFarland, Symantec Technical Support

Note: Source code files accompanying article are located on MacTech CD-ROM or source code disks.

Q: I have written a constructor for my CPanorama derived class so I can pass some specific initial values, but now all the parts of the object I specified in the Visual Architect are coming up NULL or garbage. What’s going on?

A: When it comes time to instantiate a class created in Visual Architect, a TCL macro new_by_name is used. It calls a (default) constructor if you have written one, or simply an implied (default-default) constructor if you have not. In either case, the information you specified in the VA is read in from the resource file with GetFrom() after all the constructors in the inheritance chain for your class have been called.

VA can call only default constructors. This includes constructors with no parameters and those for which all the parameters have default values. If you write a constructor that requires that at least one value be passed, you will be creating an object separate from the one VA is going to create. You may still initialize non-TCL members which may have been added to your VA-generated class either in the body of a default constructor or as parameters with default values.

Override GetFrom() if you need to use information from the VA resource file in your intitialization. For instance, a Rect frameRect might be used to save you from having to use the LongToQDRect() macro in toolbox calls that require a Rect. It is perfectly valid (and may be simpler) to put all of your construction/initialization code into GetFrom(), and not write a constructor at all.

Q: VA conveniently creates Save and SaveAs file menu items. What do I actually have to do to save my document to a file?

A: CDocument has a data member itsFile, a CFile*, which will point to whatever species of CFile you actually create, such as CDatafile, CResFile or CPictFile, etc.

The Save As menu item is connected to CDocument:: DoSaveFileAs(). PickFileName() is called from there, which puts up a StandardPutFile() dialog to retrieve the vitals of the file-to-be in an SFReply record.

Finally, DoSaveFileAs() passes the SFReply record to DoSaveAs(), which is what you need to overide in your document class, i.e. in CMain. At this point you need to allocate space for itsFile if you haven’t already.

Now just use all the nifty methods inherited from CFile, CDataFile and perhaps CPictFile to do things like creating, opening, closing, reading and writing to the file and changing its name. For simple file I/O, you may never have to call a File Manager routine directly.

Q: I’m trying to use the TCL macro new_by_name() with a VA-generated class, but it’s not working. What’s up?

A: At the beginning of the file you will see TCL_DEFINE_CLASS_M1(Cfoo,x_Cbar). This is the macro that makes the class an RTTI class (type “Run-Time Type Identification” into THINK Reference for a full explanation.) VA defaults to the M1 suffix, which must be changed to D1 if new_by_name() is to be used. Note that most people will rarely, if ever, need to use new_by_name() instead of TCL_NEW().

Q: Is it possible to create and use a routine descriptor for a member function? When I do so, the arguments are assigned in the wrong order.

A: No. There are various problems involved. There are some implied parameters to member functions, like the this pointer (a pointer to the object). Further, the parameters are passed in a different order (Pascal style) but stack cleanup is done C-style.

Q: I’m getting error -1708, “Couldn’t complete the last command because the AppleEvent was not handled”, when trying to build a library.

A: This usually results from the ToolServer not being installed properly. Check to be sure there is an alias for ToolServer in the (Tools) folder. Also, be sure to rename the alias as “ToolServer”. You may also need to copy the Toolserver folder from the CD, Apple Software:Tools: Toolserver1.1.1, to your hard drive.

Q: How do I get the Standard Console to accept single keystrokes without a Carriage Return?

A: Use the csetmode() function.


#include <stdlib.h> // For Constant EXIT_SUCCESS

#include <iostream.h> // For C++ I/O, cin and cout

//#include <stdio.h> // If you use straight C I/O

#include <console.h> // For cgetmode

main()

{

char c;

printf( "Type a character: ");

csetmode(C_CBREAK,stdin); // Allow single key inputs

c = getchar();

printf( "\nYou typed: '%c'", c, "\n" );

return 0;

}


Q: When I bring my SPM project up to date, a Build Errors window shows up but is empty. What’s going on?

A: Your code is probably generating compiler warnings that you aren’t seeing because the Build Errors window is set to hide them. Click on the Show Warnings button.

Q: Can I use exception handling without the TCL?

A: To use exception handling without the Think Class Library, you must include BRLib and Exceptions.cp in your project. Also, you must compile with the directive:


#define NO_TCL


The four macros used to make exception handling work correctly are:


AUTO_DESTRUCT_OBJECT

TCL_NEW

TCL_END_CONSTRUCTOR

TCL_START_DESTRUCTOR


The macro AUTO_DESTRUCT_OBJECT will guarantee that the destructor is called for an automatic object on the stack. A destructor will work only on a completely constructed object. TCL_END_CONSTRUCTOR helps the compiler to determine the complete construction of an object.

See the example below to see how the macros are used.


class funClass TCL_AUTO_DESTRUCT_OBJECT //macro in class header

{

public:

funClass() { // no arg constructor

cout << "In constructor." << endl;

char * myStr = new char[64]; // allocate memory

TCL_END_CONSTRUCTOR // End of the constructor

}

virtual ~funClass() { // virtual destructor

TCL_START_DESTRUCTOR // Beginning of the destructor

cout << "In destructor." < <endl;

delete [] myStr; // deallocate memory

}

};


Q: Okay. I’ve done everything I’m supposed to do to use exception handling without the TCL, but I get a bunch of link errors when I try to use TCL_NEW.

A: Rebuild BR_Lib.o with

 
  #define TCL_UNSAFE_ALLOCATION.

Q: Why does writing a text handle using CSaver cause garbage in the stream when I read it in?

A: When you create an arbitrary length handle and then fill only part of it, the whole handle length is written (and then read) and so you end up with garbage. To get CSaver to work correctly with handles, you need either to create a handle the right size to begin with, or to resize it when assigning the text to it. As an example we will stream out a CEditText object.

Within the myContents.cp file:

    

// Don’t bother allocating space for the handle.


In GetFrom(), stream in the text:


stream >> myMainText;


In PutTo(), stream out the handle and kill it:


stream << myMainText;

DisposHandle(myMainText);


In CMain.cp::WindowToContents, construct the handle, and fill it:


long len = fMain_Pano3->GetLength(); // get the length we want

itsContents->myMainText = NewHandleCanFail( len );

BlockMove( *fMain_Pano3->GetTextHandle(),

itsContents->myMainText, len );


Special thanks to Michael Hopkins, Craig Conner, Glenn Austin, Scott Morison, and Mark Baldwin.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Monolingual 1.6.4 - Remove unwanted OS X...
Monolingual is a program for removing unnecesary language resources from OS X, in order to reclaim several hundred megabytes of disk space. If you use your computer in only one (human) language, you... Read more
CleanApp 5.0 - Application deinstaller a...
CleanApp is an application deinstaller and archiver.... Your hard drive gets fuller day by day, but do you know why? CleanApp 5 provides you with insights how to reclaim disk space. There are... Read more
Fantastical 2.0 - Create calendar events...
Fantastical is the Mac calendar you'll actually enjoy using. Creating an event with Fantastical is quick, easy, and fun: Open Fantastical with a single click or keystroke Type in your event details... Read more
Cocktail 8.2 - General maintenance and o...
Cocktail is a general purpose utility for OS X that lets you clean, repair and optimize your Mac. It is a powerful digital toolset that helps hundreds of thousands of Mac users around the world get... Read more
Direct Mail 4.0.4 - Create and send grea...
Direct Mail is an easy-to-use, fully-featured email marketing app purpose-built for OS X. It lets you create and send great looking email campaigns. Start your newsletter by selecting from a gallery... Read more
jAlbum Pro 12.6 - Organize your digital...
jAlbum Pro has all the features you love in jAlbum, but comes with a commercial license. With jAlbum, you can create gorgeous custom photo galleries for the Web without writing a line of code!... Read more
jAlbum 12.6 - Create custom photo galler...
With jAlbum, you can create gorgeous custom photo galleries for the Web without writing a line of code! Beginner-friendly, with pro results Simply drag and drop photos into groups, choose a design... Read more
Lyn 1.5.9 - Lightweight image browser an...
Lyn is a lightweight and fast image browser and viewer designed for photographers, graphic artists and Web designers. Featuring an extremely versatile and aesthetically pleasing interface, it... Read more
Sublime Text 3080 - Sophisticated text e...
Sublime Text is a sophisticated text editor for code, markup, and prose. You'll love the slick user interface, extraordinary features, and amazing performance. Goto Anything. Use Goto Anything to... Read more
WALTR 1.0.11 - Drag-and-drop any media f...
WALTR is designed to make it easy to upload and convert any music or video file to an iPad or iPhone format for native playback. It supports a huge variety of media file types, including MP3, MP4,... Read more

Bio Inc's New Expansion is Infectin...
Bio Inc., by DryGin Studios, is the real time strategy game where you infect a human body with the worst virus your evil brain can design. Recently, the game was updated to add a whole lot of new features. Now you can play the new “Lethal”... | Read more »
The Monocular Minion is Here! Despicable...
Despicable Me: Minion Rush, by Gameloft, is introducing a new runner to the mix in their latest update. Now you can play as Carl, the prankster minion. Carl has a few new abilities to play with, including running at a higher speed from the start.... | Read more »
Dungeon of Madness (Games)
Dungeon of Madness 1.0.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0.0 (iTunes) Description: Dungeon of Madness is an action game where you rotate tiles to create our own route. Help the hero by connecting the... | Read more »
Filters for iPhone (Photography)
Filters for iPhone 1.0 Device: iOS iPhone Category: Photography Price: $.99, Version: 1.0 (iTunes) Description: | Read more »
Jump'N'Shoot Attack (Games)
Jump'N'Shoot Attack 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: A mobile game for gamers! Join Louise Lightfoot, the legendary "Master of Jumping and Shooting", on her mission to save... | Read more »
Space Bounties Inc. (Games)
Space Bounties Inc. 1.4 Device: iOS Universal Category: Games Price: $1.99, Version: 1.4 (iTunes) Description: SuperGameDroid: 4/5 "Satisfying futuristic RPG combat, high replay value, and a heavy dose of nostalgia make Space... | Read more »
Gamebook: Pocket RPG (Games)
Gamebook: Pocket RPG 1.0.11 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0.11 (iTunes) Description: Walk into the Land of Lanthir Lamath ruled by wicked skeletons and fight for your life in a thrilling adventure.... | Read more »
Kids Can Mix, Match, and Catch with Tata...
Tatadada MixMatch, by Tatadada Ltd, is a mobile version of the classic game of mix & match. The game uses brightly colored creatures to train your children's pattern matching skills and hand-eye coordination. It's aimed at children around age 5... | Read more »
The Trace: Murder Mystery Game (Games)
The Trace: Murder Mystery Game 1.2.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.2.0 (iTunes) Description: | Read more »
This Week at 148Apps: March 16-20, 2015
Spring Roars In At 148Apps How do you know what apps are worth your time and money? Just look to the review team at 148Apps. We sort through the chaos and find the apps you're looking for. The ones we love become Editor’s Choice, standing out above... | Read more »

Price Scanner via MacPrices.net

Logitech Says MX Master Is Its Most Advanced...
Logitech’s new MX Master Wireless Mouse incorporates the best of Logitech’s many computer mouse innovations into a striking hand-sculpted design. The company claims that the MX Master creates a new... Read more
Save up to $300 on a new Mac, $30 on an iPad,...
Purchase a new Mac or iPad at The Apple Store for Education and take up to $300 off MSRP. All teachers, students, and staff of any educational institution qualify for the discount. Shipping is free,... Read more
Apple refurbished 2014 MacBook Airs available...
The Apple Store lowered prices on Apple Certified Refurbished 2014 MacBook Airs recently, with models now available starting at $679. An Apple one-year warranty is included with each MacBook, and... Read more
Mac Notebook Evolution; A Desktop Replacement...
More often than not right from the beginning, Apple’s Macs have tended to skew toward small. The original Macs were called “compacts,”, and notwithstanding a few exceptions like the honking Big Mac... Read more
13-inch 1.4GHz/128GB MacBook Air (Apple refur...
The Apple Store has Apple Certified Refurbished 2014 13″ 1.4GHz/128GB MacBook Airs available for $759 including free shipping plus Apple’s standard one-year warranty. Their price is $240 off original... Read more
YEP! Alternative Browser for iOS Now Supports...
Pfaeffikon, Switzerland based Power App AG has announced the release of an update to their Yep! Web Browser (v1.3.0) for iOS8 iPhone and iPad. Yep! hit the App Store shortly after the release of iOS... Read more
15-inch Retina MacBook Pros on sale for up to...
B&H Photo has the new 2014 15″ Retina MacBook Pros on sale for up to $250 off MSRP for a limited time. Shipping is free, and B&H charges NY sales tax only: - 15″ 2.2GHz Retina MacBook Pro: $... Read more
Clearance 13-inch Retina MacBook Pros availab...
B&H Photo has leftover 2014 13″ Retina MacBook Pros on sale for up to $250 off original MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 2.6GHz/128GB Retina MacBook Pro: $1098... Read more
Clearance 2014 MacBook Airs on sale for up to...
B&H Photo has MacBook Airs on sale for up to $180 off original MSRP. Shipping is free, and B&H charges NY sales tax only: - 11″ 128GB MacBook Air: $789.99 110 off original MSRP - 11″ 256GB... Read more
Apple refurbished Time Capsules available for...
The Apple Store has certified refurbished Time Capsules available for $100 off MSRP. Apple’s one-year warranty is included with each Time Capsule, and shipping is free: - 2TB Time Capsule: $199, $100... Read more

Jobs Board

*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
*Apple* Retail - Multiple Positions (US) - A...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
*Apple* Retail - Multiple Positions (US) - D...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Systems Engineer - Pre Sales, Educat...
…is responsible for proactively providing technical expertise to drive sales of Apple solutions into assigned accounts. The SE architects, validates, and assists in Read more
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
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.