Version

UltraButtonBase Class

Implements the basic functionality common to button controls.
Syntax
'Declaration
 
Public MustInherit Class UltraButtonBase 
   Inherits AutoSizeControlBase
   Implements Infragistics.Win.AppStyling.ISupportAppStyling, Infragistics.Win.IImageListProvider, Infragistics.Win.IUltraControl, Infragistics.Win.IUltraControlElement, Infragistics.Win.Touch.ISupportTouchMetrics, Infragistics.Win.UIAutomation.IProvideUIAutomation 
public abstract class UltraButtonBase : AutoSizeControlBase, Infragistics.Win.AppStyling.ISupportAppStyling, Infragistics.Win.IImageListProvider, Infragistics.Win.IUltraControl, Infragistics.Win.IUltraControlElement, Infragistics.Win.Touch.ISupportTouchMetrics, Infragistics.Win.UIAutomation.IProvideUIAutomation  
Remarks

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 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.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also