1<html><head>
2	<title>Metakit sample code - DisCat</title>
3</head><body bgcolor=white>
4
5<font face=Helvetica size=3>
6
7<!--begin-->
8<h2><img src="e4app.gif" alt="App Icon" border=0 align=left>
9Metakit sample code - DisCat</h2><br clear=left>
10
11<p>This application is a good starting point to learn about Metakit. </p>
12
13<p><b>What it does</b>: DisCat is a very simple disk catalog application.
14It recursively scans a directory tree on your hard disk and creates a data
15file with information about all files and subdirectories it finds during
16that scan. The total number of directories scanned is reported on the screen.
17</p>
18
19<p><b>What it illustrates</b>: This sample program shows how to set up
20a simple MFC-based application which uses Metakit. The source code of this
21application can be compiled for 32-bit Windows as well as for 16-bit Windows
22targets. DisCat has no practical use, other than to generate a not-quite-trivial
23datafile using the Metakit library. </p>
24
25<p><b>How to use it</b>: When you launch DISCAT.EXE (or the 16-bit version,
26which is called DISCAT16.EXE), you will see a dialog box with an edit box
27where you can enter a path name. After pressing the &quot;Scan&quot; button,
28the selected directory and all of its subdirectories will be traversed.
29Then you are asked to choose a name for the datafile which is to be used
30for storing the results. Apart from seeing confirmation in the form of
31a directory count, this application is rather boring... </p>
32
33<p><b>Known problems</b>: None, but you need to make sure that your system
34meets the requirements of either DISCAT.EXE or DISCAT16.EXE. </p>
35
36<p>The DISCAT.EXE application is a 32-bit application which requires Windows
3795 (or Windows NT, or Win32s, but neither of those two has been tried).
38In addition, you need to have two of the DLLs which come with Microsoft
39Visual C++ version 4.2: MFC42.DLL and MSVCRT.DLL (these contain the MFC
40library, and the runtime library, respectively). </p>
41
42<p>Alternately, you can use DISCAT16.EXE, which runs on either Windows
4395 or Windows 3.1(1). This application requires the file MFC250.DLL in
44the system directory (usually C:\WINDOWS\SYSTEM) to start properly. </p>
45
46<p>These DLL requirements are caused by the fact that the sample programs
47and the Metakit libraries are distributed in the smallest possible format,
48which happens to be as MFC extension DLLs. As a result, you need to supply
49the MFC libraries yourself. Considering the fact that Metakit is currently
50only useful in combination with MFC, this should not be a problem. </p>
51
52<p><b>Files in EXAMPLES\DISCAT</b>: </p>
53
54<p>CATALOG.H, CATALOG.CPP - Creates a disk catalog object using Metakit
55
56<br>DISCAT.H, DISCAT.CPP - Main MFC application code 
57<br>DISCAT.MAK, DISCAT.MDP - MSVC 4.2 project makefiles for Win32 
58<br>DISCAT.DEF, DISCAT.RC - Linker definitions, Application resources 
59<br>DISCAT16.MAK - MSVC 1.52 project makefile for Win16 
60<br>RESOURCE.H - Resource symbol definitions 
61<br>STDAFX.H, STDAFX.CPP - Used for precompiled headers 
62<br>RES\*.* - Application resources </p>
63<!--end-->
64
65<center><p><hr size=1>
66||
67&nbsp; <a href="index.html" target="_top">Roadmap</a>
68&nbsp; <a href="classes.html">Class Index</a>
69&nbsp; <a href="samples.html">Sample Index</a>
70&nbsp; ||
71&nbsp; <a href="intro.html">Introduction</a>
72&nbsp; <a href="tips.html">Tips and Tricks</a>
73&nbsp; || 
74
75</center>
76</font>
77
78</body></html>
79