docs/msw/bc_ide.txt

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