3.16.2. Настройка линейки (toolbar)

TBAddButtons( buttons, imgindexes ) - добавляет кнопки в линейку аналогично тому, как это делается в конструкторе линейки. Существует возможность добавлять кнопки несколькими различными вызовами этого метода и метода TBInsertButtons;

TBInsertButtons( i, bitmap, imgindexes ) - вставляет указанные кнопки в позицию i;

TBDeleteButton( btnID ) - удаляет кнопку (по ее числовому "идентификатору");

TBDeleteBtnByIdx( i ) - удаляет кнопку по индексу;

Clear - удаляет все созданные кнопки с линейки;

TBSetTooltips( btnID, tooltips ) - задает всплывающий текст подсказок для кнопок начиная с btnID;

TBBtnImgWidth - ширина пиктограммы для кнопки в (первом) изображении, добавляемом в методе TBAddBitmap. Чтобы данное свойство можно было использовать, в конструкторе линейки в качестве параметра bitmap следует передать число 0, а изображение добавить уже после изменения значения данного свойства, методом TBAddBitmap. Данное свойство не следует использовать, если используются стандартные изображения хотя бы для части кнопок (в этом случае значки всегда квадратные, размером 16х16 или 32х32 пикселей);

TBAddBitmap( bitmap ) - добавляет точечное изображение к линии пиктограмм для кнопок инструментальной линейки. При первом добавлении, если свойство TBBtnImgWidth не изменялось, в качестве ширины каждой пиктограммы используется высота всего изображения. При последующих добавлениях ширину значков уже нельзя изменить, и если параметры новых изображений (высота) отличаются, все равно используется высота первого добавленного (этим методом, или в конструкторе линейки) точечного изображения.

К

роме того, данный метод может использоваться для "добавления" системных изображений для линеек, при использовании зарезервированных числовых значений в параметре bitmap (-1 - стандартные маленькие значки 16х16, -2 - стандартные большие значки 32х32, -5 и -6 - стандартные маленькие и большие значки "просмотра", -9 и -10 - стандартные маленькие и большие значки "истории").

Использование системных изображений выгодно сказывается на размере приложения, т.к. картинки берутся из системных ресурсов, и не хранятся в исполнимом модуле, затрачивая по 1 К байту (минимум) на каждую кнопку.

TBAssignEvents( btnID, events ) - назначает отдельные события кнопкам линейки, начиная с кнопки, идентифицируемой числовым дескриптором btnID;

TBResetImgIdx( btnID, i ) - "сбрасывает" индексы значков для i кнопок, начиная с заданной btnID;

TBItem2Index( btnID ) - возвращает индекс кнопки по ее числовому дескриптору;

TBIndex2Item( i ) - возвращает дескриптор кнопки по ее индексу;

TBConvertIdxArray2ID( idxVars ) - "конвертирует" индексы в идентификаторы для указанного набора числовых переменных. Следует первоначально присвоить этим переменным индексы кнопок, и после вызова TBConvertIdxArray2ID все эти переменные могут использоваться в качестве индексов для обращения к кнопкам. Данный метод позволяет совместить удобство использования символических имен в качестве индексов кнопок, при обращении к ним из программного кода, с возможностью динамически менять состав линейки. В случае, если кнопки вставляются или удаляются, то полученное таким способом соответствие символических имен кнопок их дескрипторам не нарушается.