ToolBar

Иерархия наследования

Описание

Компонент ToolBar реализует стандартную панель инструментов, содержащую кнопки и раскрывающиеся списки.

Работа с компонентом

Для редактирования списка элементов управления, расположенных на панели инструментов, используются команды контекстного меню, вызываемого для компонента. Настройка свойств элементов управления осуществляется в инспекторе объектов. Все кнопки создаются одинакового размера, для раскрывающихся списков можно изменить ширину в свойстве Width. Существует возможность настройки общих свойств для группы кнопок или раскрывающихся списков. Для это нужно, удерживая нажатой клавишу CTRL, выделить необходимые кнопки (раскрывающиеся списки) и изменить необходимые свойства в инспекторе объектов.

При работе с панелью инструментов из прикладного кода список элементов управления можно получиться, используя свойство Controls. Данная коллекция формируется из экземпляров объектов классов ToolBarButton и ToolbarComboBox.

Горячие клавиши

Для кнопок панели инструментов есть возможность назначить одно или несколько сочетаний горячих клавиш. Для назначения горячих клавиш в режиме дизайнера формы необходимо выделить кнопку, в инспекторе объектов выделить свойство ShortCut и нажать требуемое сочетание. Дополнительные сочетания горячих клавиш задаются в коллекции AdditionalShortCuts через язык Fore во время выполнения формы.

Пример

Свойства компонента ToolBar

	Имя свойства	Краткое описание
	Align	Свойство Align определяет, как поведет себя компонент при изменении размеров содержащего его родительского компонента.
	AllowClose	Свойство AllowClose определяет возможность закрытия панели инструментов в случае, когда панель не привязана к форме, а расположена независимо в области формы.
	AllowDrag	Свойство AllowDrag определяет возможность взять у компонента перетаскиваемый объект.
	AllowDrop	Свойство AllowDrop определяет, будет ли возможность у компонента принять перетаскиваемый объект.
	AllowUndock	Свойство AllowUndock определяет признак возможности перемещения компонента во время выполнения формы.
	Anchors	Свойство Anchors возвращает настройки, определяющие в процентном соотношении изменение размеров текущего компонента при изменении размеров родительского компонента.
	Brush	Свойство Brush определяет кисть, используемую для заливки области компонента.
	ClientHeight	Свойство ClientHeight используется для получения или задания высоты клиентской области компонента.
	ClientWidth	Свойство ClientWidth используется для получения или задания ширины клиентской области компонента.
	Color	Свойство Color определяет цвет фона компонента.
	ComponentCount	Свойство ComponentCount возвращает количество дочерних компонентов.
	Components	Свойство Components возвращает дочерний компонент.
	Controls	Свойство Controls возвращает коллекцию элементов управления, расположенных на панели инструментов.
	Cursor	Свойство Cursor определяет вид курсора над компонентом.
	Data	Свойство Data предназначено для хранения любых пользовательских данных.
	Edge	Свойство Edge определяет место расположения панели инструментов на форме.
	Enabled	Свойство Enabled определяет доступность компонента для пользователя.
	ExclusiveRow	Свойство ExclusiveRow определяет возможность расположения в одной строке нескольких компонентов.
	Floating	Свойство Floating возвращает состояние панели инструментов относительно окна формы.
	Focused	Свойство Focused возвращает True, если фокус установлен на данном компоненте.
	Font	Свойство Font определяет множество характеристик, описывающих шрифт, используемый при отображении текста.
	Height	Свойство Height определяет высоту компонента.
	HelpContext	Свойство HelpContext определяет уникальный индекс раздела контекстно-зависимой справки для данного компонента.
	Hint	Свойство Hint определяет текст подсказки для компонента.
	Id	Свойство Id определяет уникальный идентификатор панели инструментов.
	Images	Свойство Images определяет компонент ImageList , изображения которого будут отображаться на кнопках панели.
	Left	Свойство Left определяет координату левого края компонента.
	MaxHintWidth	Свойство MaxHintWidth определяет максимальную ширину всплывающей подсказки.
	Name	Свойство Name определяет наименование компонента.
	Parent	Свойство Parent определяет родительский компонент.
	ParentColor	Свойство ParentColor определяет, будет ли для компонента заимствован цвет родительского компонента.
	ParentFont	Свойство ParentFont определяет, будет ли для компонента использоваться шрифт родительского компонента.
	ParentShowHint	Свойство ParentShowHint определяет условие отображения всплывающей подсказки.
	PopupMenu	Свойство PopupMenu определяет контекстное меню, которое будет появляться по щелчку дополнительной кнопки мыши на компоненте.
	Scrolls	Свойство Scrolls возвращает параметры полос прокрутки компонента.
	ShowCaptions	Свойство ShowCaption определяет, будут ли отображаться заголовки на кнопках, расположенных на панели инструментов.
	ShowHint	Свойство ShowHint включает и выключает показ всплывающего окна подсказки для компонента.
	TabOrder	Свойство TabOrder определяет позицию компонента в последовательности табуляции.
	TabStop	Свойство TabStop определяет признак необходимости компоненту получать фокус при нажатии кнопки «TAB».
	Tag	Свойство Tag не используется компилятором. Пользователь может изменить значение свойства Tag и использовать его по своему усмотрению.
	Text	Свойство Text определяет строку, идентифицирующую компонент для пользователя.
	Top	Свойство Top определяет координату верхнего края компонента.
	Visible	Свойство Visible определяет видимость компонента во время выполнения.
	Width	Свойство Width определяет ширину компонента.

Методы компонента ToolBar

	Имя метода	Краткое описание
	BeginUpdate	Метод BeginUpdate запрещает перерисовку компонента ToolBar.
	BringToFront	Метод BringToFront располагает компонент на передний план.
	ClientToScreen	Метод ClientToScreen преобразовывает координаты точки, указанные относительно системы координат компонента, в экранные координаты.
	Dock	Метод Dock осуществляет привязку компонента ToolBar к форме.
	DockLeftOf	Метод DockLeftOf позволяет осуществить привязку ToolBar к форме, располагая этот компонент слева от объекта, передаваемого в качестве входного параметра.
	DoDragDrop	Метод DoDragDrop позволяет начать операцию перетаскивания.
	EndUpdate	Метод EndUpdate отключает режим запрета перерисовки компонента ToolBar.
	Float	Метод Float осуществляет расположение компонента ToolBar на форме как отдельное окно.
	GetImage	Метод GetImage возвращает изображение компонента со всеми дочерними компонентами.
	ScreenToClient	Метод ScreenToClient преобразовывает экранные координаты точки в координаты, указываемые относительно системы координат компонента.
	SendToBack	Метод SendToBack располагает компонент на задний план.
	SetFocus	Метод SetFocus устанавливает фокус на данный компонент.

События компонента ToolBar

	Имя события	Краткое описание
	OnBeginDrag	Событие OnBeginDrag для компонента наступает, когда пользователь начинает перетаскивать объект от компонента.
	OnClick	Событие OnClick наступает, если пользователь щёлкнул в области компонента.
	OnDblClick	Событие OnDblClick наступает, если пользователь дважды щёлкнул в области компонента.
	OnDragDrop	Событие OnDragDrop для компонента наступает, когда пользователь отпускает над ним перетаскиваемый объект.
	OnDragEnter	Событие OnDragEnter наступает, когда перетаскиваемый объект входит в границы данного компонента.
	OnDragLeave	Событие OnDragLeave наступает, когда перетаскиваемый объект выходит за границы данного компонента.
	OnDragOver	Событие OnDragOver для компонента наступает, когда пользователь протаскивает над ним перетаскиваемый объект.
	OnEnter	Событие OnEnter наступает в момент получения фокуса компонентом.
	OnExit	Событие OnExit наступает в момент потери фокуса компонентом.
	OnHScroll	Событие OnHScroll наступает при изменении положения ползунка горизонтальной полосы прокрутки.
	OnKeyDown	Событие OnKeyDown наступает, если компонент находится в фокусе и производится нажатие на клавиатуру.
	OnKeyPress	Событие OnKeyPress наступает, если компонент находится в фокусе, при нажатии пользователем символьной клавиши.
	OnKeyPreview	Событие OnKeyPreview наступает перед каждым событием, связанным с нажатием клавиш.
	OnKeyUp	Событие OnKeyUp наступает, если компонент находится в фокусе, при отпускании пользователем любой, ранее нажатой клавиши.
	OnMouseDown	Событие OnMouseDown наступает, если указатель находится в области компонента и была нажата любая кнопка мыши.
	OnMouseEnter	Событие OnMouseEnter наступает в момент входа курсора мыши в область компонента.
	OnMouseHover	Событие OnMouseHover наступает при задержке курсора мыши в области компонента.
	OnMouseLeave	Событие OnMouseLeave наступает в момент выхода курсора мыши за пределы области компонента.
	OnMouseMove	Событие OnMouseMove наступает при перемещении курсора мыши над компонентом.
	OnMouseUp	Событие OnMouseUp наступает при отпускании кнопки мыши, когда указатель находится в области компонента.
	OnMouseWheel	Событие OnMouseWheel наступает, если компонент находится в фокусе при вращении колеса мыши.
	OnVScroll	Событие OnVScroll наступает при изменении положения ползунка вертикальной полосы прокрутки.

См. также:

Дополнительные компоненты