PPButtonGroup

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

          IComponent

          IControl

          IPPButtonGroup

          PPButtonGroup

Описание

Компонент PPButtonGroup реализует группу кнопок.

Комментарии

Компонент представляет из себя группу кнопок, работающих по принципу переключателей. Переключение осуществляется путем отображения одной из кнопок в нажатом состоянии. Во время работы только одна из кнопок может находиться в нажатом состоянии, при переключении остальные кнопки автоматически переходят в ненажатое состояние. Используя свойство AllowAllUp для компонента можно задать режим, когда все кнопки могут находиться в ненажатом состоянии.

Для добавления кнопки в группу используйте команду контекстного меню «Добавить кнопку». При этом будет создана кнопка, реализуемая классом PPSwitchButton. При работе формы кнопки могут быть добавлены динамически из кода приложения, для этого используется метод Add или Insert. При добавлении кнопки в группу в качестве родительского компонента для нее автоматически будет установлен текущий компонент PPButtonGroup. Размеры всех кнопок рассчитываются автоматически относительно размеров компонента PPButtonGroup и количества добавляемых кнопок. Крайние кнопки будут иметь закругленные края.

Пример

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

  Имя свойства Краткое описание
Свойство Align определяет, как поведет себя компонент при изменении размеров содержащего его родительского компонента.
Свойство AllowAllUp определяет, могут ли все кнопки, составляющие группу, находиться одновременно в ненажатом состоянии.
Свойство AllowDrag определяет возможность взять у компонента перетаскиваемый объект.
Свойство AllowDrop определяет, будет ли возможность у компонента принять перетаскиваемый объект.
Свойство Anchors возвращает настройки, определяющие в процентном соотношении изменение размеров текущего компонента при изменении размеров родительского компонента.
Свойство Brush определяет кисть, используемую для заливки области компонента.
Свойство ClientHeight используется для получения или задания высоты клиентской области компонента.
Свойство ClientWidth используется для получения или задания ширины клиентской области компонента.
Свойство Color определяет цвет фона компонента.
Свойство ComponentCount возвращает количество дочерних компонентов.
Свойство Components возвращает дочерний компонент.
Свойство Count возвращает количество кнопок, добавленных в группу.
Свойство Cursor определяет вид курсора над компонентом.
Свойство Data предназначено для хранения любых пользовательских данных.
Свойство Enabled определяет доступность компонента для пользователя.
Свойство Focused возвращает True, если фокус установлен на данном компоненте.
Свойство Font определяет множество характеристик, описывающих шрифт, используемый при отображении текста.
Свойство Height определяет высоту компонента.
Свойство HelpContext определяет уникальный индекс раздела контекстно-зависимой справки для данного компонента.
Свойство Hint определяет текст подсказки для компонента.
Свойство Item возвращает параметры кнопки по индексу.
Свойство Left определяет координату левого края компонента.
Свойство Name определяет наименование компонента.
Свойство Parent определяет родительский компонент.
Свойство ParentColor определяет, будет ли для компонента заимствован цвет родительского компонента.
Свойство ParentFont определяет, будет ли для компонента использоваться шрифт родительского компонента.
Свойство ParentShowHint определяет условие отображения всплывающей подсказки.
Свойство PopupMenu определяет контекстное меню, которое будет появляться при клике дополнительной клавишей мыши на компоненте.
Свойство ShowHint включает и выключает показ всплывающего окна подсказки для компонента.
Свойство TabOrder определяет позицию компонента в последовательности табуляции.
Свойство TabStop определяет признак необходимости компоненту получать фокус при нажатии кнопки «Tab».
Свойство Tag не используется компилятором. Пользователь может изменить значение свойства Tag и использовать его по своему усмотрению.
Свойство Text определяет строку, идентифицирующую компонент для пользователя.
Свойство Top определяет координату верхнего края компонента.
Свойство Visible определяет видимость компонента во время выполнения.
Свойство Width определяет ширину компонента.

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

  Имя метода Краткое описание
Метод Add добавляет указанную кнопку в группу.
Метод BringToFront располагает компонент на передний план.
Метод Clear удаляет все кнопки из группы.
Метод ClientToScreen преобразовывает координаты точки, указанные относительно системы координат компонента, в экранные координаты.
Метод DoDragDrop позволяет начать операцию перетаскивания.
Метод GetImage возвращает изображение компонента со всеми дочерними компонентами.
Метод Insert вставляет кнопку в указанную позицию в группе.
Метод Remove удаляет указанную кнопку из группы.
Метод RemoveByIndex удаляет кнопку из группы по индексу.
Метод ScreenToClient преобразовывает экранные координаты точки в координаты, указываемые относительно системы координат компонента.
Метод SendToBack располагает компонент на задний план.
Метод SetFocus устанавливает фокус на данный компонент.

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

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

См. также:

Компоненты платформы