JS+
Усиленный язык сценариев для Windows
с возможностью встраивания
в ваши приложения
О языке JS+ Справочник Скачать JS+ DLL
Контакты
СПРАВОЧНИК ПО ЯЗЫКУ JS+ Содержание

TToolBar

- визуальный компонент
Компоненты JS+
Определяет панель кнопок типа TToolButton.

Создание объекта

tlbObj=new TToolBar(Parent);

Собственные свойства
Свойство Тип Описание
AllowTextButtons Boolean разрешить текстовые кнопки
AutoSize Boolean автоматически подгонять высоту компонента под высоту кнопок (по умолчанию)
ButtonMargin Number дополнительный отступ от границ кнопки до ее содержания
ButtonHeight Number высота кнопок
ButtonWidth Number ширина кнопок
Caption String текстовый идентификатор компонента для пользователя
CustomizeKeyName String ключ компонента для сохранения настроек пользователя в реестре Windows
CustomizeValueName String значение ключа компонента для сохранения настроек пользователя в реестре Windows
Customizable Boolean разрешить настройку компонента пользователем (см. Примечание)
DisabledImages TImageList список изображений для запрещенных кнопок
DrawingStyle Enum стиль отображения компонента (см. ниже)
EdgeBorders Enumset отображаемые стороны рамки (см. ниже)
EdgeInner Enum стиль отображения внутренней части рамки (см. ниже)
EdgeOuter Enum стиль отображения внешней части рамки (см. ниже)
Flat Boolean отображать кнопки в плоском виде (по умолчанию)
GradientDirection Enum направление градиента (см. ниже)
GradientDrawingOptions Enumset свойства градиента кнопок (см. ниже)
GradientEndColor TColor конечный цвет градиента
GradientStartColor TColor начальный цвет градиента
HideClippedButtons Boolean скрывать кнопки, выходящие за границы компонента
HotImages TImageList список изображений для кнопок, над которыми находится указатель мыши
HotTrackColor TColor цвет фона кнопки, над которой находится указатель мыши
Images TImageList список изображений для кнопок
Indent Number отступ от левого края компонента до первой кнопки
List Boolean отображать заголовки на кнопках справа от значков (при установленном свойстве ShowCaptions)
ShowCaptions Boolean отображать заголовки на кнопках (для кнопок с установленным свойством Caption)
Transparent Boolean установить прозрачный фон компонента
Wrapable Boolean разрешить перенос кнопок, выходящих за границу компонента, в следующий ряд
Только чтение
ButtonCount Number количество кнопок
Buttons[] TToolButton индексированный список кнопок
Canvas TCanvas дескриптор графической канвы
RowCount Number количество рядов из кнопок

Свойство DrawingStyle
Значение Описание
dsNormal обычный стиль
dsGradient градиент

Свойство EdgeBorders
Значение Описание
ebLeft левая сторона
ebTop верхняя сторона
ebRight правая сторона
ebBottom нижняя сторона

Свойство EdgeInner
Значение Описание
esNone рамка отсутствует
esLowered утопленная рамка
esRaised приподнятая рамка

Свойство EdgeOuter
Значение Описание
esNone рамка отсутствует
esLowered утопленная рамка
esRaised приподнятая рамка

Свойство GradientDirection
Значение Описание
gdHorizontal горизонтальный градиент
gdVertical вертикальный градиент

Свойство GradientDrawingOptions
gdoHotTrack выделять кнопки цветом при прохождении над ними курсора мыши
gdoGradient использовать градиентную заливку кнопок

Стандартные свойства

Стандартные методы

Собственные события
Событие Описание
OnAdvancedCustomDraw требуется поэтапная отрисовка компонента
OnAdvancedCustomDrawButton требуется поэтапная отрисовка кнопки
OnCustomDraw требуется отрисовка компонента
OnCustomDrawButton требуется отрисовка кнопки
OnCustomizeAdded пользователь добавил новую кнопку
OnCustomizeCanDelete пользователь удаляет одну из кнопок
OnCustomizeCanInsert пользователь вставляет новую кнопку
OnCustomizeDelete пользователь удалил одну из кнопок
OnCustomizeNewButton пользователь добавляет новую кнопку
OnCustomizeReset пользователь отменил изменение компонента
OnCustomized пользователь завершил изменение компонента
OnCustomizing пользователю отображен диалог изменения компонента

Стандартные события

Пример (JS+)
// Главная форма
frm=new TForm();
frm.Caption="JS+ - визуальный компонент TToolBar";
frm.Width =525;
frm.Height=375;

// Строка состояния
stb=new TStatusBar(frm);
stb.SimpleText=" Нажмите на любую кнопку ToolBar";

tlb=new TToolBar(frm);
tlb.DrawingStyle=dsGradient;
tlb.EdgeBorders=ebBottom;
tlb.EdgeInner=esRaised;
tlb.ButtonMargin=2;
tlb.ShowCaptions=true;
tlb.Customizable=true;

for (i=j=0;i<5;i++) {
  tbt=new TToolButton(tlb);
  tbt.Style=tbsButton;
  tbt.ShowHint=true;

  switch (i) {
    case 3: tbt.Style=tbsSeparator;
             tbt.Width=3;
             continue;

    default: tbt.Hint="Кнопка "+(j+1);
  }

  tbt.Caption=tbt.Hint;
  tbt.LoadImage(
  JSPlus.HelpDir+"IMAGE\\TToolBar\\"+(j++)+".ico");
  tbt.OnClick=tbt_Click;
}

// Метка
lbl=new TLabel(frm);
lbl.Alignment=taCenter;
lbl.Caption=
"Редактируйте панель кнопок:\n"+
"перетаскиванием кнопок при нажатой клавише Shift или\n"+
"после двойного щелчка на свободной области компонента";
lbl.Left=(frm.ClientWidth-lbl.Width)/2;
lbl.Top =(stb.Top-lbl.Height)/2;

frm.ShowModal();

// Обработчик события OnClick
function tbt_Click(tbt)
{
  alert("Нажата "+tbt.Hint);
}
Примечание
При установке свойства Customizable компонент допускает режим редактирования пользователем. Режим редактирования запускается либо при перетаскивании кнопок при нажатой клавише Shift, либо при двойном щелчке мышью по свободной от кнопок области компонента.
Совместимость
C++ Builder/Delphi
См. также
JS+Руководство пользователя
Адрес этой страницы: http://jsplus.ru/MANUAL/JSPlus/Component/TToolBar.htm
© 2024,