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

Smultron 9.4.2 - Easy-to-use, powerful t...
Smultron 9 is an elegant and powerful text editor that is easy to use. Use it to create or edit any text document. Everything from a web page, a note or a script to any single piece of text or code.... Read more
Typinator 7.3 - Speedy and reliable text...
Typinator turbo-charges your typing productivity. Type a little. Typinator does the rest. We've all faced projects that require repetitive typing tasks. With Typinator, you can store commonly used... Read more
coconutBattery 3.6.4 - 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
iShowU Instant 1.2.0 - Full-featured scr...
iShowU Instant gives you real-time screen recording like you've never seen before! It is the fastest, most feature-filled real-time screen capture tool from shinywhitebox yet. All of the features you... Read more
TrailRunner 3.8.1840 - Route planning fo...
TrailRunner is the perfect companion for runners, bikers, hikers, and all people wandering under the sky. Plan routes on a geographical map. Import GPS or workout recordings and journalize your... Read more
NetShade 7.1 - Browse privately using an...
NetShade is an anonymous proxy and VPN app+service for Mac. Unblock your Internet through NetShade's high-speed proxy and VPN servers spanning seven countries. NetShade masks your IP address as you... Read more
1Password 6.8.2 - Powerful password mana...
1Password is a password manager that uniquely brings you both security and convenience. It is the only program that provides anti-phishing protection and goes beyond password management by adding Web... Read more
ClamXav 2.15.1 - Virus checker based on...
ClamXav is a popular virus checker for OS X. I have been working on ClamXav for more than 10 years now, and over those years, I have invested a huge amount of my own time and energy into bringing... Read more
NetShade 7.1 - Browse privately using an...
NetShade is an anonymous proxy and VPN app+service for Mac. Unblock your Internet through NetShade's high-speed proxy and VPN servers spanning seven countries. NetShade masks your IP address as you... Read more
1Password 6.8.2 - Powerful password mana...
1Password is a password manager that uniquely brings you both security and convenience. It is the only program that provides anti-phishing protection and goes beyond password management by adding Web... Read more

Thimbleweed Park (Games)
Thimbleweed Park 1.0.0 Device: iOS Universal Category: Games Price: $9.99, Version: 1.0.0 (iTunes) Description: A brand new adventure game from Ron Gilbert and Gary Winnick, creators of the classics Monkey Island and Maniac Mansion!... | Read more »
The best simulation games on mobile
There's nothing like a good sim -- from the seemingly ridiculous to the incredibly mundane, you can be there's a simulation game out there for your every whim. [Read more] | Read more »
INKS guide - how to create works of pinb...
INKS puts a clever new spin on everyone's favorite classic arcade game, pinball. The core mechanics are the same -- keep a little ball pinging around the board for as long as possible without letting it fall into the precarious holes in the board.... | Read more »
Warbands: Bushido (Games)
Warbands: Bushido 1.0 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0 (iTunes) Description: Warbands:Bushido is a miniatures board game with cards, miniatures, dice and beautiful terrains to fight on, with both... | Read more »
The best mobile games like Divinity: Ori...
Divinity: Original Sin 2 launched this week to the excitement of RPG fans everywhere. The game, which derives a lot of of its story and mechanics from old-school isometric RPGs and Dungeons & Dragons, has unseated PlayerUnknown's... | Read more »
Iron Marines guide - beginner tips and t...
Iron Marines is a brilliant RTS title that feels a bit like Starcraft. It's got a sci-fi setting and some of the most spectacular strategy mechanics we've seen in mobile games to date. With that said, the RTS genre can be a bit tricky to break... | Read more »
The best new games we played this week -...
The work week can be tough, but on the bright side, it's almost overandthere are bunches of brand new games to try out this weekend. This week definitely makes up for last week's sleepiness ten-fold. We've got one of the finest RTS game on mobile... | Read more »
Through the Ages (Games)
Through the Ages 1.0.60 Device: iOS Universal Category: Games Price: $9.99, Version: 1.0.60 (iTunes) Description: The offical adaptation of Vlaada Chvátil’s strategy classic, the second best board game ever by Board Game Geek website... | Read more »
The best RTS games like Iron Marines
Iron Marines launched today, and it's definitely taking the mobile gaming world by storm. In fact, our reviews editor Campbell says it's "quite possibly the best real-time strategy game on the App Store." If you're looking for more real-time... | Read more »
Uri: The Sprout of Lotus Creek (Games)
Uri: The Sprout of Lotus Creek 1.0.5 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0.5 (iTunes) Description: Published by Fantastic Games IntroductionDesigned by DreamTree Games(An indie games studio in Malaysia ) | Read more »

Price Scanner via MacPrices.net

QuickerTek Announces Solar PV Chargers for US...
Wichita, Kansas based QuickerTek has announced its new 30 Watt and 60 Watt USB Type-C Solar Juicz Chargers. These solar panels are the only products of their kind, featuring the USB 3.1 adapter cable... Read more
Apple refurbished 128GB iPhone 6s and 6s Plus...
Apple has Certified Refurbished 128GB iPhone 6s and 6s Plus’ available for up to $100 off the price of new models. Space Gray, Silver, Gold, and Rose Gold models are available. Each phone comes... Read more
13-inch 2.3GHz Silver MacBook Pros on sale fo...
B&H Photo has 2017 13″ 2.3GHz Silver MacBook Pros in stock today and on sale for $100 off MSRP, each including free shipping plus NY & NJ sales tax only: – 13-inch 2.3GHz/128GB Silver... Read more
12-inch 64GB iPad Pros available for $749, $5...
MacMall has 12″ 64GB iPad Pros on sale for $749 including free shipping. Their price is $50 off MSRP. Read more
Sunday deal: 10-inch 256GB iPad Pros for $699...
MacMall has 10.5″ 256GB WiFi iPad Pros on sale today for $699 including free shipping. That’s $100 off MSRP. Read more
2017 12-inch 1.2GHz Retina MacBooks on sale f...
Amazon has 2017 12″ 1.2GHz Retina MacBooks on sale for $100 off MSRP. Shipping is free: 12″ 1.2GHz Space Gray MacBook: $1199 $100 off MSRP 12″ 1.2GHz Silver MacBook: $1199 $100 off MSRP 12″ 1.2GHz... Read more
Apple Certified Refurbished 21-inch and 27-in...
Apple is now offering a full line of Certified Refurbished 2017 21″ and 27″ iMacs. Models start at $1019 and range up to $350 off original MSRP. Apple’s one-year warranty is standard, and shipping is... Read more
Apple now offering Certified Refurbished 2017...
Apple is now offering Certified Refurbished 2017 12″ Retina MacBooks for up to $240 off the cost of new models. Apple will include a standard one-year warranty with each MacBook, and shipping is free... Read more
Steve Jobs’ Democratization Of The Smartphone...
Can it be only ten years since Steve Jobs introduced the world to the iPhone and changed everything? Jobs and Apple didn’t invent the smartphone. IBM designed a primitive one called SIMON in 1992,... Read more
Save up to $200 on 2017 Apple iMacs
B&H Photo has 2017 21-inch and 27-inch iMacs in stock and on sale for $100-$200 off MSRP including free shipping. B&H charges sales tax in NY & NJ only: – 27″ 3.8GHz iMac (MNED2LL/A): $... Read more

Jobs Board

*Apple* Solutions Consultant - Apple Inc. (U...
…about helping others on a team while also delighting customers? As an Apple Solutions Consultant (ASC), you will discover customers needs and help connect them Read more
Software/Data Engineer, *Apple* Media Produ...
Job Summary Apple Media Products is the team behind the App Store, Apple Music, iTunes, and many other high profile products on iPhone, Mac and AppleTV. Our Data Read more
SW Engineer , *Apple* Media - Apple Inc. (U...
Job Summary Our team is responsible for exposing Apple Media content and services to the world, and building the infrastructure for next generation internal and Read more
*Apple* Data Center Site Selection and Strat...
Job Summary As Apple 's products and services scale the globe, the Data Center Affairs team works behind the scenes to secure infrastructure for Apple 's data Read more
*Apple* Professional Learning Specialist - A...
Job Summary The Apple Professional Learning Specialist is a full-time position for one year with Apple in the Yuma, AZ area. This position requires a high Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.