[wxWidgets.git] / docs / msw / bc_ide.txt

Readme for wxWindows 2.0 Ide-files
First release Feb. 1999, detlev@reymann-online.de

1. What you can do with this ide-files
2. Where to install the files
3. How to modify them for your own needs
4. How to create ide-files for your own wxWindows-programs

1. What you can do with this ide-files
======================================
There are three ide-files. One ide-file should help you to create the wxWindows libraries from within the Ide of Borlands C++, v. 5.x. The second is called bc32d.ide and produces the debug-version of the wxWindows-library.
If you want to produce the debugging-version, using the special ide-file bc32d.ide you have to create a seperate subdirectory \WXWIN_PATH\src\debug.
The last one should help you to create most of the samples of wxWindows.

2. Where to install the files
=============================
You should copy the files for the libraries into the src-directory of your wxWindows-Installation (e.g. C:\wxwin\src).
And the other file for the samples should be copied into the samples-directory (e.g. C:\wxwin\samples).

3. How to modify them for your own needs
========================================
If your wxWindows-Installation resides on the same drive as your Borland-Compiler and additionally the Borland-Installation is the default (e.g. C:\BC5) then there should be no need to change anything.
Otherwise please change the path from within the ide (Options->project->directories). Because we use the $inherit-makro (Julian foung the trick), this should do the trick.

4. How to create ide-files for your own wxWindows-programs
==========================================================
I think you are familiar with the necessary options for your own programm. So I will only describe what is neccessary to link yout programm with the wxWindows-library. If you want to create a ide-file for your own wxWindows-program, create a new project from the menu file->new->project. Deactivate all the standard-options, the only two thing that should be aktivated is "static" for the libraries, if you want to use the library produced with the library-ide and the checkbox OLE (You can leave this checkbox unchecked, but then you have to add the library \bc5\lib\ole2w32.lib to your project). You have to add the include-path of wxWindows to the include-path in the options-dialog (options->project->directories->include). The result should be something like:
path_of_my_program;\bc5\include;\wxwin2\include;
Then you have to add the libraries to the project.
Open the project-view and activate your programm. Then right-click and choose "add" and select the wxWindows-library (e.g. \wxwin\lib\wx32.lib).
Commit	Line	Data
b8ecf3e9	1	Readme for wxWindows 2.0 Ide-files
33b64e6f	2	First release Feb. 1999, detlev@reymann-online.de
b8ecf3e9	3
33b64e6f	4	1. What you can do with this ide-files
b8ecf3e9 JS	5	2. Where to install the files
b8ecf3e9 JS	6	3. How to modify them for your own needs
33b64e6f	7	4. How to create ide-files for your own wxWindows-programs
b8ecf3e9	8
33b64e6f	9	1. What you can do with this ide-files
b8ecf3e9	10	======================================
33b64e6f JS	11	There are three ide-files. One ide-file should help you to create the wxWindows libraries from within the Ide of Borlands C++, v. 5.x. The second is called bc32d.ide and produces the debug-version of the wxWindows-library.
	12	If you want to produce the debugging-version, using the special ide-file bc32d.ide you have to create a seperate subdirectory \WXWIN_PATH\src\debug.
	13	The last one should help you to create most of the samples of wxWindows.
b8ecf3e9 JS	14
	15	2. Where to install the files
	16	=============================
33b64e6f JS	17	You should copy the files for the libraries into the src-directory of your wxWindows-Installation (e.g. C:\wxwin\src).
33b64e6f JS	18	And the other file for the samples should be copied into the samples-directory (e.g. C:\wxwin\samples).
b8ecf3e9 JS	19
	20	3. How to modify them for your own needs
	21	========================================
33b64e6f JS	22	If your wxWindows-Installation resides on the same drive as your Borland-Compiler and additionally the Borland-Installation is the default (e.g. C:\BC5) then there should be no need to change anything.
33b64e6f JS	23	Otherwise please change the path from within the ide (Options->project->directories). Because we use the $inherit-makro (Julian foung the trick), this should do the trick.
b8ecf3e9	24
33b64e6f	25	4. How to create ide-files for your own wxWindows-programs
b8ecf3e9	26	==========================================================
33b64e6f JS	27	I think you are familiar with the necessary options for your own programm. So I will only describe what is neccessary to link yout programm with the wxWindows-library. If you want to create a ide-file for your own wxWindows-program, create a new project from the menu file->new->project. Deactivate all the standard-options, the only two thing that should be aktivated is "static" for the libraries, if you want to use the library produced with the library-ide and the checkbox OLE (You can leave this checkbox unchecked, but then you have to add the library \bc5\lib\ole2w32.lib to your project). You have to add the include-path of wxWindows to the include-path in the options-dialog (options->project->directories->include). The result should be something like:
	28	path_of_my_program;\bc5\include;\wxwin2\include;
	29	Then you have to add the libraries to the project.
	30	Open the project-view and activate your programm. Then right-click and choose "add" and select the wxWindows-library (e.g. \wxwin\lib\wx32.lib).