docs/tech/tn0007.txt

   1 Using and modifying the BC++ IDE files
   2 ======================================
   3
   4 Readme for wxWindows 2.0 Ide-files
   5 First release Feb. 1999, detlev@reymann-online.de
   6
   7 1. What you can do with the BC++ IDE files
   8 2. Where to install the files
   9 3. How to modify them for your own needs
  10 4. How to create IDE files for your own wxWindows-programs
  11
  12 1. What you can do with the IDE files
  13 =====================================
  14
  15 There are two IDE files. src\bc32.ide should help you to
  16 create the wxWindows libraries from within the Ide of Borland's
  17 C++, v. 5.x. Note that this doesn't include debugging code: you
  18 need to change the settings if you wish to include debug
  19 information. Previously, bc32d.ide was supplied with debug
  20 settings, but this proved to time-consuming to maintain.
  21
  22 2. Where to install the files
  23 =============================
  24
  25 You should copy the files for the libraries into the
  26 src-directory of your wxWindows-Installation (e.g. C:\wxwin\src).
  27 And the other file for the samples should be copied into the
  28 samples-directory (e.g. C:\wxwin\samples).
  29
  30 (If installing from setup.exe or wx2..._bc.zip the files
  31 will be installed into the appropriate directories
  32 automatically).
  33
  34 3. How to modify them for your own needs
  35 ========================================
  36
  37 If your wxWindows-Installation resides on the same drive as your
  38 Borland-Compiler and additionally the Borland-Installation is
  39 the default (e.g. C:\BC5) then there should be no need to change
  40 anything. Otherwise please change the path from within the ide
  41 (Options->project->directories). Because we use the
  42 $inherit-macro (Julian found the trick), this should work.
  43
  44 To add a new sample to samples\bc32.ide, follow these steps:
  45
  46 1. Choose Project->New target... and type in e.g.
  47    samples\newsample. Press OK.
  48 2. Static, no OWL, MFC or class libraries. Check Multithread
  49    on. Press OK.
  50 3. Right-click on the new node, choose Add node... and add
  51    ..\lib\wx32.lib and ..\lib\xpm.lib. Add any other source
  52    files you require.
  53 4. Right-click on the new node, choose Edit Local Options.. and
  54    add in Directories, specify the following:
  55
  56    Include: $inherit;.\newsample
  57    Library: $inherit;
  58    Source:  .\newsample
  59    Intermediate: .\newsample
  60    Final: .\newsample
  61
  62 4. How to create IDE files for your own wxWindows-programs
  63 ==========================================================
  64
  65 If you want to create an IDE file for your own wxWindows program,
  66 please follow these steps.
  67
  68 1. Create a new project from the menu file->new->project.
  69 2. Deactivate all the standard-options, the only three things
  70    that should be activated are "static" for the libraries,
  71    the checkbox OLE (you can leave this checkbox unchecked,
  72    but then you have to add the library \bc5\lib\ole2w32.lib
  73    to your project), and the Multithread checkbox.
  74 3. Add the include-path of wxWindows to the include-path in the
  75    options-dialog (options->project->directories->include). The
  76    result should be something like:
  77    path_of_my_program;\bc5\include;\wxwin2\include;
  78 4. Add the libraries to the project. Open the project-view and
  79    activate your program. Then right-click and choose "add" and
  80    select the wxWindows library (e.g. \wxwin\lib\wx32.lib). Also
  81    add the xpm library.
  82