_Property
Ключевое слово _property служит для объявления свойств и спецификации их атрибутов. Синтаксис:
property тип свойства имя = { список атрибутов свойства };
Спецификации атрибутов имеют вид атрибут [= значение] и отделяются друг от друга запятыми. Возможны следующие атрибуты:
read = поле \ get-функция
write = поле \ set-функция
stored = true | false | поле get-функция
index = целая константа
default = значение
nodefault
Для атрибутов read/write может указываться либо ассоциированное со свойством поле (тогда говорят о прямом доступе к свойству), либо имя метода доступа. Если спецификатор write опущен, то свойство можно только читать. Можно, конечно, объявить и свойство только для записи, но трудно придумать случай, когда это имело бы смысл.
Обычным является объявление прямого доступа для чтения и set-функции — для записи:
_property bool Started = {read=FStarted, write=SetStarted};
Атрибут index специфицирует целое число, которое должно передаваться в качестве единственного аргумента get-функции (обычно последняя параметров не имеет) и первого аргумента set-функции (которая обычно имеет один параметр — значение для свойства):
private:
int FCoords [4];
int _fastcall GetCoords(int Index) {
return FCoords[Index];
void _fastcall SetCoords (int Index, int value) FCoords[Index] = value;
}
public:
_property int Left = {read=GetCoords,
write=SetCoords, index=0};
_property int Top = (read=GetCoords,
write=SetCoords, index=l);
_property int Right = (read=GetCoords,
write=SetCoords, index=2} ;
_property int Bottom = {read=GetCoords,
write=SetCoords, index=3};
Атрибуты stored, default и nodefault yназываются спецификаторами хранения
Они не влияют на поведение программы и специфицируются обычно только для опубликованных свойств. В частности, они определяют. будет ли значение свойства сохраняться в файле формы. Если атрибут stored равен true и значение свойства отлично от указанного в атрибуте default, значение свойства сохраняется, в противном случае — нет. Если спецификатор stored опущен, для него принимается значение true.
Атрибут default позволяет указать для свойства значение по умолчанию
_property int TickRate = { read=FTickRate,
write=SetTlcKRate, default=10 );
Значение по умолчанию, заданное атрибутом default, относится только к значению свойства, отображаемому инспектором объектов и не присваивается свойству автоматически при запуске программы. Это значение нужно явно присвоить в конструкторе компонента.
Атрибут nodefault отменяет унаследованное значение свойства по умолчанию.
Атрибуты default и nodefault поддерживаются только для целых типов, перечислений и множеств (класс Set библиотеки VCL).
В C++Builder приняты определенные соглашения об именах свойств, их полей и методов доступа. Этим соглашениям, в частности, следует ClassExplorer при автоматическом генерировании кода для свойств. Если имя свойства, скажем, PropName, то именем поля будет FPropName, именем get-функции GetPropName и именем set-функции — SetPropName.
Опубликование унаследованных свойств
Базовый класс создаваемого компонента может объявлять некоторое свойство как открытое или защищенное. В производном классе компонента можно переобъявить такое свойство:
Кроме того, при переобъявлении свойства в производном классе можно указать новое значение по умолчанию или, специфицировав nodefault, отменить унаследованное значение, не задавая нового.
При переобъявлении свойства указывается только его имя и, возможно, спецификаторы хранения, например:
_published:
_property OldProp = {nodefault};
