ArcGIS Engine Developer Guide

C++ APPLICATION PROGRAMMING INTERFACE
void GiveGraphic(Graphic* graphic);
Graphic* TakeGraphic(int itemNum);
Use function overloading when a particular operation works with different
argument types:
void Append(const CString& text);
void Append(int number);
Argument names
Use descriptive argument names in function declarations. The argument name
should clearly indicate what purpose the argument serves:
bool Send(int messageID, const char* address, const char* message);
Debugging tips in Developer Studio
Visual C++ comes with a feature-rich debugger. These tips will help you get the
most from your debugging session.
Backing up after failure
When a function call has failed and you’d like to know why (by stepping into
it), you don’t have to restart the application. Use the Set Next Statement
command to reposition the program cursor back to the statement that failed
(right-click the statement to bring up the debugging context menu). Then, just
step into the function.
Edit and Continue
Visual Studio 6 allows changes to source code to be made during a debugging
session. The changes can be recompiled and incorporated into the executing code
without stopping the debugger. There are some limitations to the type of changes
that can be made; in this case the debug session must be restarted. This feature is
enabled by default; the settings are available in Settings of the project menu.
Click the C/C++ tab and click General from the Category dialog box. In the
Debug info dialog box, click Program Database for Edit and Continue.
Unicode string display
Set your debugger options to display Unicode strings (click the Tools menu,
click Options, click Debug, then check the Display Unicode Strings check box).
Variable value display
Pause the cursor over a variable name in the source code to see its current
value. If it is a structure, click it and bring up the QuickWatch dialog box (click
the Eyeglasses button or press Shift+F9) or drag and drop it into the Watch
window.
202 • ArcGIS Engine Developer Guide