Skip to main content

TcxSpeedButtonOptions.Down Property

Specifies whether the button is pressed.

Declaration

property Down: Boolean read; write; default False;

Property Value

Type Default
Boolean False

Remarks

This property is in effect for group buttons – the buttons whose GroupIndex property is set to a value greater than 0, specifying the group by its index. If the Down property is set to True, the button appears pressed (down). Otherwise, the button is in the normal state (up). Use the AllowAllUp property to specify how the Down property value can be changed.

In addition, buttons provide the following behavior:

  • If the button Action property is unassigned, you can set the Down property to False at design time, regardless of the AllowAllUp property setting.

  • If the button Action property is assigned, the Down and GroupIndex property settings are always synchronized with the Checked and GroupIndex properties of the linked action. In this instance, if the action Checked property is set to True the button appears pressed (down) only if the action GroupIndex property is set to a value greater than 0.

The Down property is similar to the Down property of standard VCL TSpeedButton controls. To mimic the behavior of these controls, disable the CanBeFocused option.

The default value of the Down property is False.

See Also