6.7.4 Регистрация компоненты

Перед тем как ваша компонента сможет работать на стадии проектирования приложения, C++Builder должен зарегистрировать ее. При регистрации становится известным положение новой компоненты в Палитре компонент C++Builder.

Регистрация компоненты - это простой процесс, который информирует C++Builder о том, какая компонента добавляется к VCL и на какой вкладке Палитры она должна появиться.

Чтобы зарегистрировать компоненту:

1. Добавьте функцию Register к файлу МуСотр.срр, заключив ее имя в пространство имен (заметьте, что название пространства имен начинается с заглавной буквы, а все остальные буквы - прописные).

2. В теле функции Register объявите массив типа TComponentClass, в который введите регистрируемую компоненту.

3. В теле функции Register вызовите функцию RegisterComponents стремя параметрами: название вкладки Палитры компонент, массив компонентных классов и размер компонентных классов.

namespace Mycomp {

void _fastcall Register()

{

TComponentClass classes[1] = {_claesid(TMyComponent)};

RegisterComponents("Samples", classes, 0) ;

) }

Листинг 6.13. Регистрация компоненты.

Листинг 6.13 представляет включение в файл МуСотр.срр кода для регистрации компоненты TMyComponent на вкладке Samples Палитры компонент.

Когда компонента зарегистрирована, вы можете испытать и инсталлировать ее на Палитру, завершая тем самым процесс разработки новой компоненты.

6.7.5 Отладка неинсталлированной компоненты

Вам следует испытать поведение созданной компоненты при выполнении программы до ее инсталляция на Палитру. По существу, вам придется смоделировать те действия, которые производит C++Builder, когда пользователь перемещает компоненту из Палитры на форму. Этот процесс требует выполнения следующих шагов:

1. Включите файл модуля MyComp.h вашей компоненты в заголовочный файл некоторой формы.

2. Добавьте объектный член данных, представляющий испытываемую компоненту, в конец секции public объявлений класса формы, вне области объявлений, которые делает C++Builder.

3. Подсоедините обработчик к событию OnCreate формы.

4. Вызовите конструктор компонентного объекта (компонента отвечает за самоуничтожение, когда наступит время) из обработчика этого события, передав ему параметр, указывающий на владельца компоненты. Обычно параметром служит указатель this на объект, который содержит этот метод. В нашем примере параметр this ссылается на форму.

5. Сразу же за вызовом конструктора установите свойство Parent - родителя компоненты, обычно представляющего собой форму, группирующую рамку или панель инструментов. Обычно значением этого свойства является указатель this. Внимание: Если ваша компонента не является элементом управления, т.е. вы

не наследовали ее от TControl, пропустите этот шаг.

6. Инициируйте значения других свойств компоненты.

Предположим, вы собираетесь испытать компоненту TMyComponent в модуле с именем МуСотр. Создайте новый проект, а затем следуйте перечисленным шагам процесса подготовки модуля формы. Листинг 6.14 содержит законченный образец текста модуля формы отлаживаемой компоненты.

#ifndef TestFormH

#define TestFormH

//---_-_______-_-__-________-_-_._-_____________-_-___-_-_

ttinclude <Classes.hpp>

#include <Controls.hpp> ftinclude <StdCtrls.hpp>

#include <Forms.hpp>

#include "MyComp.h" // 1. //----—---——----—-----—-----—---—_--____-_----------

class TFormI : public Tform {

publ i shed:

private:

public:

TMyComponent* MyComponentI; // 2,

virtual _fastcall TFormI (TComponent* Owner); •// 3,

};

//----—--—---—------—-—-———---—--——-—------——--

extern TFormI *Forml;

//_--__--______----—-----—---------------------—--------

#endif

// Это файл MyComp.cpp модуля формы:

#include <vcl.h>

#pragma hdrstop

#include "TestForm.h" //——-----——-——--—------—-—--——---—--—----—--—--

ftpragma resource "*.dfm"

TFormI *Forml;

//---------—--—-------------------—---—--------------—

_fastcall TFormI::TFormI(TComponent* Owner) : TForm(Owner)

{

MyComponentI = new TMyComponent(this); // 4. MyComponent->Parent = this; // 5. MyComponentl->Left = 12; // 6.

}

Листинг 6.14. Текст модуля формы новой компоненты.