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

Cocktail 8.4 - 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
PDFKey Pro 4.3 - Edit and print password...
PDFKey Pro can unlock PDF documents protected for printing and copying when you've forgotten your password. It can now also protect your PDF files with a password to prevent unauthorized access and/... Read more
Kodi 15.0.beta1 - Powerful media center...
Kodi (was XBMC) is an award-winning free and open-source (GPL) software media player and entertainment hub that can be installed on Linux, OS X, Windows, iOS, and Android, featuring a 10-foot user... Read more
DiskCatalogMaker 6.4.12 - Catalog your d...
DiskCatalogMaker is a simple disk management tool which catalogs disks. Simple, light-weight, and fast. Finder-like intuitive look and feel. Super-fast search algorithm. Can compress catalog data... Read more
Macs Fan Control 1.3.0.0 - Monitor and c...
Macs Fan Control allows you to monitor and control almost any aspect of your computer's fans, with support for controlling fan speed, temperature sensors pane, menu-bar icon, and autostart with... Read more
Lyn 1.5.11 - Lightweight image browser a...
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
NeoOffice 2014.11 - Mac-tailored, OpenOf...
NeoOffice is a complete office suite for OS X. With NeoOffice, users can view, edit, and save OpenOffice documents, PDF files, and most Microsoft Word, Excel, and PowerPoint documents. NeoOffice 3.x... Read more
LaunchBar 6.4 - Powerful file/URL/email...
LaunchBar is an award-winning productivity utility that offers an amazingly intuitive and efficient way to search and access any kind of information stored on your computer or on the Web. It provides... Read more
Remotix 3.1.4 - Access all your computer...
Remotix is a fast and powerful application to easily access multiple Macs (and PCs) from your own Mac. Features Complete Apple Screen Sharing support - including Mac OS X login, clipboard... Read more
DesktopLyrics 2.6.6 - Displays current i...
DesktopLyrics is an application that displays the lyrics of the song currently playing in "iTunes" right on your desktop. The lyrics for the song have to be set in iTunes; DesktopLyrics does nothing... Read more

What the Apple Watch Gets Right, and Wha...
| Read more »
Celebrate PAC-MAN's 35th Birthday W...
BANDAI NAMCO Entertainment America is celebrating PAC-MAN's 35th anniversary by releasing updates for PAC-MAN and PAC-MAN Lite for iOS. [Read more] | Read more »
Strike Wing Episode 2 has Landed on the...
Strike Wing: Raptor Rising is an exciting space combat simulator by Crescent Moon Games, which was recently updated to continue the story with Episode 2. [Read more] | Read more »
This Week at 148Apps: May 18-22, 2015
May Days 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 the... | Read more »
Biz Builder Delux (Games)
Biz Builder Delux 1.0.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0.0 (iTunes) Description: Ah, there's nothing like the rhythmic bustle of a burgeoning business burg... especially when you're the one building it... | Read more »
Auroch Digital is Bringing Back Games Wo...
| Read more »
Blades of Brim is a New Endless Runner f...
SYBO Games, the minds behind the ever-popular Subway Surfers, have announced their latest project: Blades of Brim. [Read more] | Read more »
Carbo - Handwriting in the Digital Age...
Carbo - Handwriting in the Digital Age 1.0 Device: iOS Universal Category: Productivity Price: $3.99, Version: 1.0 (iTunes) Description: | Read more »
Draggy Dead (Games)
Draggy Dead 1.1 Device: iOS Universal Category: Games Price: $.99, Version: 1.1 (iTunes) Description: Ditch your dead end job and take up a rewarding career in Grave Robbing today!Guide the recently deceased to a fun filled life of... | Read more »
Bad Dinos (Games)
Bad Dinos 1.0.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0.0 (iTunes) Description: | Read more »

Price Scanner via MacPrices.net

New 13-inch 2.9GHz Retina MacBook Pro on sale...
B&H Photo has the 13″ 2.9GHz/512GB Retina MacBook Pro on sale for $1699.99 including free shipping plus NY tax only. Their price is $100 off MSRP, and it’s the lowest price for this model from... Read more
12-inch MacBook stock status for Monday, May...
The new 12″ Retina MacBooks are still on backorder at The Apple Store with a 3-5 week waiting period. However, a few models are in stock today at Apple resellers. Stock is limited, so act now if you’... Read more
New 27-inch 3.3GHz 5K iMac in stock with free...
Adorama has the new 27″ 3.3GHz 5K iMac in stock today for $1999 including free shipping plus NY & NJ sales tax only. Adorama will include a free copy of Apple’s 3-year AppleCare Protection Plan. Read more
Memorial Day Weekend Sale: New 27-inch 3.3GHz...
Best Buy has the new 27″ 3.3GHz 5K iMac on sale for $1899.99 this weekend. Choose free shipping or free local store pickup (if available). Sale price for online orders only, in-store prices may vary... Read more
OtterBox Maximizes Portability, Productivity...
From the kitchen recipe book to the boarsroom presentation, the OtterBox Agility Tablet System turns tablets into one of the most versatile pieces of handheld technology available. Available now, the... Read more
Launch of New Car App Gallery and Open Develo...
Automatic, a company on a mission to bring the power of the Internet into every car, has announced the launch of the Automatic App Gallery, an app store for nearly every car or truck on the road... Read more
Memorial Day Weekend Sale: 13-inch 1.6GHz Mac...
Best Buy has the new 13″ 1.6GHz/128GB MacBook Air on sale for $849 on their online store this weekend. Choose free shipping or free local store pickup (if available). Sale price for online orders... Read more
Memorial Day Weekend Sale: 27-inch 3.5GHz 5K...
Best Buy has the 27″ 3.5GHz 5K iMac on sale for $2099.99 this weekend. Choose free shipping or free local store pickup (if available). Sale price for online orders only, in-store prices may vary.... Read more
Sale! 16GB iPad mini 3 for $349, save $50
B&H Photo has the 16GB iPad mini 3 WiFi on sale for $349 including free shipping plus NY sales tax only. Their price is $50 off MSRP, and it’s the lowest price available for this model. Read more
Price drop on 2014 15-inch Retina MacBook Pro...
B&H Photo has dropped prices on 2014 15″ Retina MacBook Pros by $200. Shipping is free, and B&H charges NY sales tax only: - 15″ 2.2GHz Retina MacBook Pro: $1799.99 save $200 - 15″ 2.5GHz... Read more

Jobs Board

Architect / Senior Software Engineer, *Apple...
Changing the world is all in a day039s work at Apple . If you love innovation, here039s your chance to make a career of it. You039ll work hard. But the job comes with Read more
*Apple* Pay Support Readiness Project Manage...
Changing the world is all in a day039s work at Apple . If you love innovation, here039s your chance to make a career of it. You039ll work hard. But the job comes with Read more
Hardware Design Validation Engineer - *Apple...
**Job Summary** The Apple Watch team is looking for a Hardware Design Validation Engineer. This person will be part of the Apple Watch hardware team with Read more
Sr. Payment Program Manager, *Apple* Pay -...
**Job Summary** Apple Pay is an exciting environment and a…devices in a simple, private and secure way. The Apple Pay Team is looking for an experienced Senior Read more
Project Manager / Business Analyst, WW *Appl...
…a senior project manager / business analyst to work within our Worldwide Apple Fulfillment Operations and the Business Process Re-engineering team. This role will work Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.