5.1. Структура головного файла проекта

Головной файл проекта содержит главную функцию WinMain, кото­рая выполняется в начале работы программы. Следует иметь в виду, что программист, как правило, не вносит никаких изменений в головной файл проекта.

Чтобы увидеть код головного файла проекта, надо в ИСР С++ Builder 5 выполнить команду Project/ViewSourse , воспользовавшись поло­сой главного меню, и файл появится в окне Редактора кода. Типичный файл головного проекта для операционных систем Windows показан на рис. 11; стандартное расширение головного файла проекта - *.срр.

Project1. cpp 15.04.03 10.59.16

1: // Головной файл проекта

2:

3: //--------------------------------------------------------------------------------------------------------------------------

4: // директивы препроцессора

5: #include <vcl.h>

6: #pragma hdrstop

7: // макросы, подключающие файлы ресурсов и форм

8: USERES(“Project1.res”);

9: USEFORM(“Unit1.cpp”, Form1);

10: //--------------------------------------------------------------------------------------------------------------------------

11: // главная функция

12: WINAPI WinMin(HINSTANCE, HINSTANCE, LPSTR, int)

13: {

14: try

15: {

16: Application->Initialize();

17: Application->CreateFrom(__classid(TForm1), &Form1);

18: Application->Run();

19: }

20: catch (Exception &exception)

21: {

22: Application->ShowException(&exception);

23: }

24: return 0;

25: }

26: //--------------------------------------------------------------------------------------------------------------------------

Рис.11

Начинается файл головного проекта строками, первый символ кото­рых #. С этого символа начинаются директивы препроцессора. Например, директива # include <vcl.h> подключает библиотеку визуальных компо­нентов.

После директив препроцессора в файле размещены предложения макросов USERES и USEFORM подключающие к проекту файлы ресур­сов и форм.

Далее расположена главная функция программы WinMain. За заго­ловком функции следует её тело, заключённое в фигурные скобки. Первый выполняемый оператор тела функции - Application->Initialize - инициа­лизирует компоненты данного приложения. Следующий оператор - Application —> CreateForm() - создаёт компоненты, расположенные на Форме (включая саму форму). Далее выполняется оператор – Application->Run(). После выполнения этого оператора программа ждёт соответствующих со­бытий, которые управляют её ходом, т.е. происходит включение програм­мы на выполнение.

Перечисленные операторы заключены в блок try (попытка выпол­нить), после которого следует блок catch (защёлка). Эта структура связана с обработкой так называемых исключений - аварийных ситуаций при ра­боте программы. Если аварийная ситуация возникает, то выполняются операторы в блоке catch.

Последним оператором тела функции WinMain является оператор return 0 (возврат), завершающий проект с кодом завершения 0.

Все описанные выше операторы головного файла проекта заносятся в него автоматически в процессе проектирования приложения. Имя голов­ному файлу проекта С++ Builder 5 дает по умолчанию: для первого проек­та - "Project1 .срр", для второго - "Project2.срр" и т. д.