|Visual Basic (Declaration)|
Public MustInherit Class UltraButtonBase Inherits AutoSizeControlBase Implements Infragistics.Win.AppStyling.ISupportAppStyling, Infragistics.Win.IImageListProvider, Infragistics.Win.IUltraControl, Infragistics.Win.IUltraControlElement
public abstract class UltraButtonBase : AutoSizeControlBase, Infragistics.Win.AppStyling.ISupportAppStyling, Infragistics.Win.IImageListProvider, Infragistics.Win.IUltraControl, Infragistics.Win.IUltraControlElement
This class implements the basic functionality for an autosize button control.
Set the AcceptButton or CancelButton property of a Form to the button to allow the click event to be invoked using the ENTER or ESC keys respectively even if the button does not have focus.
When the form containing the button is displayed using the form's ShowDialog method, the DialogResult property of the button may be used to specify the return value of the ShowDialog method.
The class includes a number of properties to determine the appearance of the button. For example, the UltraButtonBase.PressedAppearance determines the appearance (color, image, etc.) when the button has been pressed. The ButtonStyle property is used to determine the border style for the button. The ShowFocusRect is used to prevent the focus rectangle from being rendered when the control has focus. The ShowOutline property determines whether the button will be rendered with an additional border when it is the default button (IsDefault).
The class also includes properties to affect the behavior of the control. For example, the AcceptsFocus button determines whether the button will receive focus when it is clicked.
Note When a button or other control does not receive focus, regardless of the CausesValidation property, the control with focus will not have its Validating/Validated events fired. These events are controlled and invoked by the base .Net control classes and are not invoked until the control loses focus, the container's Validate method is invoked, etc.