Of the three remaining buttons, Help will evoke the browser with this help, Cancel will cancel the process, and OK will start the process.

After clicking the OK button, check the line of text at the bottom of the screen. If there is a problem, it will be identified there.

When the process is complete, the link table will be brought up in ArcView. It will be linked to the point/line and polygon tables.

Return to Table of Contents

Run from Avenue Script

Included with the OverlapPoly installation are two additional scripts. OverlapPoly.Run takes four or five parameters and calls the DLL. OverlapPoly.Sample provides a sample script that will evoke OverlapPoly.Run.

To call OverlapPoly directly from your Avenue script, open a script and choose Script > Load System Script. From the dialogue, scroll down to OverlapPoly.Sample, choose it and click OK. The sample code will be loaded into the open script. The meaning and format of the parameters is described in the script.

Alternately, choose OverlapPoly.Run to get details on running the required DLL's directly.

Note there is an additional boolean parameter. If it is set true, the program will run without user interaction. In this mode, the dialog will be presented to monitor progress, but the user will not be able to modify anything unless the parameters will not work, such as a file not being available.

Return to Table of Contents

Run from C++

To run OverlapPoly directly from C++, ensure that ssi08.dll and EvokeBrowser.dll are within your path and include the following code:

HINSTANCE hDllEvokeBrowser = NULL;
hDllEvokeBrowser = LoadLibrary("c:\\Esri\\Av_gis30\\Arcview\\Bin32\\EvokeBrowser.DLL");
if (!hDllEvokeBrowser) {
    AfxMessageBox("Could not Load EvokeBrowser");
    return 0;
}
typedef DWORD (CALLBACK *DWLPSSD)(LPSTR, LPSTR, LPSTR, LPSTR, LPSTR, BOOL);
HINSTANCE hDll = NULL;
DWLPSSD lpProc = NULL;
hDll = LoadLibrary("c:\\Esri\\Av_gis30\\Arcview\\Bin32\\OverlapPoly.DLL");
if (hDll) {
    lpProc = (DWLPSSD)GetProcAddress(hDll, "OverlapPoly");
} else {
    AfxMessageBox("Could not Load Library");
    return 0;
}
if (!lpProc) {
    AfxMessageBox("GetProcAddress Failed");
    FreeLibrary (hDll);
    return 0;
}
char * pzFeatureFile[_MAX_PATH];
char * pzPolygonFile[_MAX_PATH];
char * pzTable[_MAX_PATH];
char * pzAttributes[6*MaxAttributeNameLength+7];
// Set the file and attribute values
int nReturn = (*lpProc)("c:\Esri\gis_30\ArcView\Help\OverlapPoly.htm",
                                pzFeatureFile,
                                pzPolygonFile,
                                pzTable,
                                pzAttributes,
                                false);
FreeLibrary (hDll);
if (nReturn) AfxMessageBox("Run successful");
else AfxMessageBox("Run failed");
return nReturn;

The middle 4 parameters are used to return the values actually chosen by the user. The first three should thus be allocated sufficient room to hold the longest path length. The fourth needs to hold 6 attributes plus 7 punctuation marks.

The values of the parameters can be set to blank or given values. The format for the shape files, that is pzFeatureFile and pzPolygonFile, is

(path\\file1.shp)[(path\\file2.shp)...]