AdvancedCheckBox Class

Represents a checkbox with additional features such as customizable disabled colors, fixed auto sizing behavior, buffered fading animations, and more.

Definition

Namespace: KGySoft.WinForms.Controls
Assembly: KGySoft.WinForms (in KGySoft.WinForms.dll) Version: 5.0.1

C#

[ToolboxBitmapAttribute(typeof(CheckBox))]
public class AdvancedCheckBox : CheckBox, 
	ISupportsFading<ControlAppearanceState>, IWin32Window

VB

<ToolboxBitmapAttribute(GetType(CheckBox))>
Public Class AdvancedCheckBox
	Inherits CheckBox
	Implements ISupportsFading(Of ControlAppearanceState), IWin32Window

C++

[ToolboxBitmapAttribute(typeof(CheckBox))]
public ref class AdvancedCheckBox : public CheckBox, 
	ISupportsFading<ControlAppearanceState^>, IWin32Window

F#

[<ToolboxBitmapAttribute(typeof(CheckBox))>]
type AdvancedCheckBox = 
    class
        inherit CheckBox
        interface ISupportsFading<ControlAppearanceState>
        interface IWin32Window
    end

Inheritance: Object MarshalByRefObject Component Control ButtonBase CheckBox AdvancedCheckBox

Implements: ISupportsFadingControlAppearanceState, IWin32Window

Remarks

The AdvancedCheckBox class offers the following features in addition to CheckBox:

The AutoSize property works as expected when the checkbox is docked.
Different rendering qualities (see TextRenderingQuality and VisualsRenderingQuality).
Adjustable colors in disabled state (see DisabledBackColor and DisabledForeColor).
Buffered fading animations with every FlatStyle (only on Vista and above with visual styles enabled, see FadingAnimationsEnabled and FadingAnimationOptions).
Consistent font scaling on all platforms when per-monitor DPI awareness is enabled (see AutoScaleFont). Note that it affects font scaling only, so auto-sizing behavior still depends on the current platform.
Fixed rendering in high DPI modes when the application is DPI aware.

Examples

The following image illustrates a few features of the AdvancedCheckBox class, like the default disabled colors difference (the disabled colors are customizable), text rendering quality, and the fixed auto sizing behavior when the control is docked to the top:

AdvancedCheckBox in the KGySoft.WinForms.Example application

Tip

The image above is from the example application. At the Releases page of the project repository you can download it as executable binaries as well.

Constructors

AdvancedCheckBox

Creates a new instance of AdvancedCheckBox.

Properties

AutoScaleFont	Gets or sets whether the Font should be automatically scaled when DPI changes and the current thread has per-monitor DPI awareness. Default value: .
BackColor	Gets or sets the background color of the control in the current Enabled state. (Overrides ButtonBaseBackColor)
DisabledBackColor	Gets or sets the background color when the control is not Enabled.
DisabledForeColor	Gets or sets the text color when the control is not Enabled.
EnabledBackColor	Gets or sets the background color when the control is Enabled.
EnabledForeColor	Gets or sets the text color when the control is Enabled.
FadingAnimationDefaultSpeed	Gets or sets the default fading animation speed for non-standard animations in milliseconds. Zero value means immediate change. Default value: 500.
FadingAnimationOptions	Gets or sets the fading options of the control. Default value: StandardEffects.
FadingAnimationsEnabled	Gets or sets whether fading animations are enabled for the control. Animations work on Windows Vista and above when rendering with visual styles. Default value: .
FlatStyle	Gets or sets the flat style appearance of the checkbox. Default value: Standard.
Font	Gets or sets the font of the text displayed by the control. (Overrides ControlFont)
ForeColor	Gets or sets the foreground color of the control in the current Enabled state. (Overrides ControlForeColor)
TextRenderingQuality	Gets or sets the text rendering quality of the AdvancedCheckBox. Default value: SystemDefault. See the online help for an image example.
UseCompatibleTextRendering	Gets or sets whether to use the text rendering engine compatible with .NET Framework 1.x (GDI+) or not (GDI). Default value: .
VisualsRenderingQuality	Gets or sets the rendering quality of the AdvancedCheckBox visuals. Has effect only in high DPI mode when FlatStyle is Standard. Default value: High.

Methods

Dispose	Releases the unmanaged resources used by the ButtonBase and optionally releases the managed resources. (Overrides ButtonBaseDispose(Boolean))
GetPreferredSize	Retrieves the size of a rectangular area into which a control can be fitted. (Overrides ButtonBaseGetPreferredSize(Size))
OnBackColorChanged	Raises the BackColorChanged event. (Overrides ControlOnBackColorChanged(EventArgs))
OnEnabledChanged	Raises the EnabledChanged event. (Overrides ButtonBaseOnEnabledChanged(EventArgs))
OnFontChanged	Raises the FontChanged event. (Overrides ControlOnFontChanged(EventArgs))
OnForeColorChanged	Raises the ForeColorChanged event. (Overrides ControlOnForeColorChanged(EventArgs))
OnHandleCreated	Raises the HandleCreated event. (Overrides CheckBoxOnHandleCreated(EventArgs))
OnKeyDown	Raises the KeyDown event. (Overrides ButtonBaseOnKeyDown(KeyEventArgs))
OnKeyUp	Raises the KeyUp event. (Overrides ButtonBaseOnKeyUp(KeyEventArgs))
OnMouseDown	Raises the MouseDown event. (Overrides ButtonBaseOnMouseDown(MouseEventArgs))
OnMouseEnter	Raises the MouseEnter event. (Overrides ButtonBaseOnMouseEnter(EventArgs))
OnMouseLeave	Raises the MouseLeave event. (Overrides ButtonBaseOnMouseLeave(EventArgs))
OnMouseMove	Raises the MouseMove event. (Overrides ButtonBaseOnMouseMove(MouseEventArgs))
OnMouseUp	Raises the MouseUp event. (Overrides CheckBoxOnMouseUp(MouseEventArgs))
OnPaddingChanged	Raises the PaddingChanged event. (Overrides ControlOnPaddingChanged(EventArgs))
OnPaint	Implicitly calls the OnPaintState method, which raises both the Paint and PaintState events. (Overrides ButtonBaseOnPaint(PaintEventArgs))
OnPaintState	Paints the specified state of this control, and raises the PaintState event.
OnParentChanged	Raises the ParentChanged event. (Overrides ButtonBaseOnParentChanged(EventArgs))
OnParentFontChanged	Raises the FontChanged event when the Font property value of the control's container changes. (Overrides ControlOnParentFontChanged(EventArgs))
OnTextChanged	Raises the TextChanged event. (Overrides ButtonBaseOnTextChanged(EventArgs))
OnVisibleChanged	Raises the VisibleChanged event. (Overrides ButtonBaseOnVisibleChanged(EventArgs))
WndProc	Processes Windows messages. (Overrides ButtonBaseWndProc(Message))

Events

PaintState

Occurs when the control is painted in a specific state.

Extension Methods

GetFormatFlags	Gets the formatting flags for the text of a custom drawn control. (Defined by ControlExtensions)
GetScale	Gets the current scale factor of the specified control. If per-monitor DPI awareness is not enabled, it always returns SystemScale. (Defined by ScaleHelper)
GetScrollBarSize	Gets the recommended width and height of scrollbars matching the current scaling of the specified control. (Defined by ScaleHelper)
HasDefaultScaling	Gets whether the display that the specified control belongs to has the same DPI as the initial DPI of the primary display. (Defined by ScaleHelper)
ScaleHeight	Scales the specified height by the vertical scale factor of the control. (Defined by ScaleHelper)
ScaleSize	Scales the specified size by the scale factor of the control. (Defined by ScaleHelper)
ScaleWidth	Scales the specified width by the horizontal scale factor of the control. (Defined by ScaleHelper)
SetControlEnabled	Sets the Enabled property of the child controls within the specified root control, or the Enabled property of the specified control itself, if it is not a recognized container control. By this way pages of a TabControl will remain selectable, a SplitContainer remains resizable, etc. (Defined by ControlExtensions)
SetControlReadonly	Recursively sets the read-only state in the children of the specified root control. Affects TextBoxBase and IReadOnlyCapable instances. (Defined by ControlExtensions)
SetDoubleBuffered	Sets the double buffered state of a control (Defined by ControlExtensions)
SetStyle	Sets a specified ControlStyles flag to either or . It calls the protected Control.SetStyle method on the specified control as if it was a public method. (Defined by ControlExtensions)