📚
Siticone Docs
HomePricing PlansSuggest a FeatureMy LicenseChangelogDownloads
  • Dear Developer!
  • Quick Start Guide
    • Install Siticone UI Library
    • Register for 1 month free trial
    • Register for Premium License
  • Net Framework | Net Core UI
    • Input Controls
      • Siticone TextBox
        • Appearance and Styling
        • Text and Placeholder Config.
        • Input, Validation and Read-Only Behavior
        • User Interaction & Shortcuts
        • System Theme Integration
        • Events and Callbacks
      • Siticone TextArea
        • Always Multiline
        • Custom Font
        • Vertical Scrollbars
        • Border-less Design
        • Dynamic Resizing
        • Margin Spacing
      • Siticone CheckBox
        • Visual Style
        • State Management
        • Interaction Effects
        • Container Layout
        • Container Style
        • Container States
        • State Colors
        • Border Configuration
        • Layout
        • Focus Appearance
        • Text Property
        • Trigger Feedback
      • Siticone RadialButton
        • Appearance
        • Behavior
        • Layout Management
        • User Assistance
        • Animation Timing
        • Events and Callbacks
      • Siticone ToggleButton
        • Toggle Functionality
        • Appearance and Text
        • Border Settings
        • Corner Radius
        • Animation Settings
        • Ripple & Interaction Effects
        • Read-only and Feedback
        • Sizing and Layout
        • Context Menu Integration
        • State Persistence
        • Accessibility
        • Events and Callback
      • Siticone ToggleSwitch
        • Core Toggle Functionality
        • Appearance and Theming
        • Logging and Diagnostics
        • Interactive Effects
        • Labels and Icons
        • Audio Feedback
        • Thumb Customization
        • Animation Settings
        • Context Menu Integration
        • Tool-tip Capabilities
        • Events and Callbacks
      • Siticone UpDown
        • Behavior and Data Config
        • Appearance Customization
        • Feedback and Animation
        • Events and Callbacks
      • Siticone PhoneNumberBox
        • Page 1
        • Phone Number Config
        • Country Flag Display
        • Shadow Effects
        • Input Validation
        • Border and Background
        • Placeholder and Animation
        • Text & Cursor Customization
        • Font and Text Style
        • Corner and Fill Config
        • System Theme (Preview)
        • Public Methods & Text
        • Events and Callbacks
      • Siticone Otp
        • Security & Input Protection
        • Interactive Feedback
        • Input Validation
        • Box Appearance & Layout
        • Data Extraction & Display
        • State Analysis
        • Events and Callbacks
        • Additional Public Methods
    • Buttons and Elements
      • Siticone Button
        • Animation Effects
        • Theme & System Integration
        • User Assist & Interaction
        • Layout & Content
        • Visual Effects & Styling
        • Badge Configuration
        • Manage State & Behavior
        • Performance and Rendering
        • Events for Control Updates
      • Siticone TileButton
        • Animation Effects
        • Color Settings
        • Visual Style
        • Icon Settings
        • Advanced Styling
        • Badge Display
        • Loading Indicator
        • State Management
        • Tool-tip Settings
        • Accessibility
        • Corner Radius
      • Siticone ImageButton
        • Content Presentation
        • Interaction and Behavior
        • Feedback and Animations
        • Visual Style and Layout
        • Badge Features
        • Theme Integration
        • Events and Callbacks
      • Siticone MenuButton
        • Appearance and Visual Style
        • Icon Customization
        • Animation Features
        • Behavior and Interaction
        • Events and Callbacks
      • Siticone CloseButton
        • Appearance Customization
        • Animation and Visual Effects
        • Behavioral Settings
        • Accessibility Features
        • Tool-tip Configuration
        • Countdown Display Config
        • Events and Callbacks
      • Siticone CopyButton
        • Appearance & Visual Effects
        • Corner and Shape Config
        • Behavior & Target Copy
        • Notification Customization
        • Context Menu Customization
        • Accessibility Features
        • Events and Callbacks
      • Siticone DashboardButton
        • Visual Effects
        • Visual Appearance
        • Notification Badge
        • Selection Indicator
        • Layout and Text
        • State Management & Colors
        • Animation Settings
        • Shape Customization
        • Accessibility
        • User Interaction Events
      • Siticone NavBackButton
        • Behavior and Feedback
        • Visual Appearance
        • Dimensions & Icon Styling
        • Animation Effects
        • Visual Style Enhancements
        • Events and Callbacks
      • Siticone NavForwardBtn
        • Behavior & Read-Only Config
        • Icon Customization
        • Colors & Visual Feedback
        • Button Dimensions & Shape
        • Animation Features
        • Visual Style and Effects
        • Events for Animation
        • Control Overrides
        • Events and Callbacks
      • Siticone NotificationBtn
        • Tool-tip Features
        • Layout & Size Customization
        • Bell Appearance & Behavior
        • Badge (Count) Features
        • Interaction and Gesture
        • Visual Effects and Animation
        • Visual Style and Shadow
        • Additional Behavior Settings
        • Events for Feedback
        • Events and Callbacks
      • Siticone PlayPauseBtn
        • Progress Indicator
        • Animation Effects
        • Visual Style
        • Shape Customization
        • Shape Customization
        • Icon Customization
        • Behavior
        • Events and Callbacks
    • Container and Layout
      • Siticone Panel
        • Border Customization
        • Corner Curvature
        • Background Appearance
        • Gradient Effects
        • Interactive Ripple Effects
        • Backdrop Effects
        • Event Notifications
      • Siticone AdvancedPanel
        • Essential Styling
        • Motion and Animation
        • Color and Gradient
        • Depth and Shadow
        • Border Enhancements
        • Interactive States
        • Background Effects
        • Content Management
        • Events and Callback
      • Siticone FlatPanel
        • Appearance and Styling
        • Performance & Rendering
        • Design-Time Integration
      • Siticone FlowPanel
        • Appearance & Visual Effects
        • Layout Customization
        • Performance Optimization
        • Interaction and Behavior
        • Theme & DPI Integration
        • Events and Callbacks
      • Siticone Container
        • Color and Gradients
        • Border Design and Styling
        • Corner and Shape Config
        • Shadow & Elevation Effects
        • Interactive and Animations
        • Badge Configuration
        • Content Management
        • Context Menu Integration
        • Dragging and Interaction
        • Security and Feedback
        • Events and Callbacks
      • Siticone SplitContainer
        • Event Handling
        • Splitter Movement & Behavior
        • Animation & Smooth Drag
        • Appearance and Styling
        • State Management
        • Accessibility & Keyboard Navigation
        • Context Menu Integration
        • System Theme Integration
        • Drag and Drop Panel Reordering
      • Siticone GroupBox
        • Theming and Aesthetics
        • Border & Edge Effects
        • Text & Title Styling
        • Layout Configuration
        • Chevron Styling
        • Badge Config & Animation
        • Collapsible Features
        • Interaction Behavior & Events
        • Status Elements
      • Siticone NativeGroupBox
        • Border Customization
        • Appearance & Layout
      • Siticone DragPanel
        • Layout Customization
        • Appearance Customization
        • Rendering Quality
        • Interactive Behavior
      • Siticone Card
        • Color and Gradients
        • Border Config & Styling
        • Corner and Shape Config
        • Shadow and Elevation
        • Interactive Effects and Animations
        • Hover Effects
        • Visual Effects
        • Badge Configuration
        • Security and Feedback Settings
        • Dynamic Content & Context Menu
        • Drag-and-Drop Interaction
        • Front-Facing Events
      • Siticone TabControl
        • General Layout and Sizing
        • Appearance and Color Customization
        • Close Button Customization
        • Pin Functionality
        • Tab Management and Navigation
        • Animation and Visual Effects
        • Context Menu Customization
        • Events and Callbacks
      • Siticone Workbook (Preview)
    • Progress and Loading
      • Siticone HProgressBar
        • Rounded Corners & Shape Customization
        • Progress Value & Range Management
        • Orientation & Layout
        • Animation & Indeterminate Mode
        • Progress State Colors & Thresholds
        • Gradient & Bar Styling
        • Label & Tooltip Customization
        • Read‑Only Mode
        • Ripple Effects
        • User Experience Enhancements
        • System Theme Tracking
        • Events and Callbacks
      • Siticone VProgressBar
        • Appearance & Styling
        • Behavior, Animation & Interaction
        • System Integration & Events
      • Siticone HBarsProgress
        • Animation Control
        • Progress Value Management
        • Appearance and Styling
        • Display and Interaction
        • Events and Callbacks
      • Siticone VBarsProgress
        • Animation Features
        • Progress and Range Settings
        • Line Configuration
        • Color and Appearance
        • Display Options
        • User Interaction
        • Events and Callbacks
      • Siticone HLineProgress
        • Range Settings
        • Animation Settings
        • Color and Gradient Design
        • Visual Effects
        • Pulse Animation Settings
        • Corner Radius Customization
        • Page
      • Siticone VLineProgress
        • Range Settings
        • Animation Settings
        • Color and Gradient Customization
        • Background and Highlight Effects
        • Pulse Animation Settings
        • Corner Radius Settings
      • Siticone CircularSpinner
        • Visual Customization
        • Geometry and Layout
        • Motion and Animation
        • Progress Indication
        • Events
      • Siticone LoadingSpinner
        • General Control Methods & Events
        • Animation Settings
        • Appearance & Visual Customization
        • Progress Display Customization
        • Size & Radius Customization
        • Ring & Spoke Customization
        • Special Effects
        • Events and Callbacks
      • Siticone RadialProgress
        • Core Configuration
        • Visual Styling
        • Interaction and Control
        • Animation and Motion
        • Advanced Effects & Readonly State
        • Color Customization
        • Indeterminate Mode
        • Events
      • Siticone SmoothCSpinner
        • Appearance Customization
        • Animation Control
        • Arc Dimension Settings
      • Siticone SmoothLProgress
        • Dual-Bar Behavior
        • Visual Appearance
        • Motion Dynamics
        • Animation Control
    • Sliders and Range
      • Siticone HSlider
        • Appearance and Layout
        • Read-Only Customization
        • Visual Effects & Animations
        • Interaction & Behavior
        • Data Binding & State Management
        • Events & Accessibility
        • Built-In Context Menu Operations
      • Siticone VSlider
        • Data & Value Management
        • Appearance Customization
        • Read-Only Mode Appearance
        • Visual Effects & Animations
        • Interaction & Feedback Settings
        • Events & Event Handling
        • State Management
        • Accessibility & Data Binding Support
      • Siticone HTrackBar
        • Data & Value Management
        • Appearance Customization
        • Animation & Interaction Effects
        • Behavior & Interaction
        • Accessibility & Data Binding
        • Events
      • Siticone VTrackBar
        • Value and Range Configuration
        • Appearance Customization
        • Animation and Interaction Customization
        • Feedback Mechanisms
        • Context Menu and Tooltip Features
        • Accessibility and Keyboard Support
        • State Management and Data Binding
        • Events
      • Siticone HRangeSlider
        • Behavior & Value Management
        • Appearance Customization
        • User Interaction
        • Events
      • Siticone HRangeTrackBar
        • Behavior Settings
        • Appearance Settings
        • Event Handling
        • Built-In Context Menu Functionality
        • Keyboard and Mouse Interaction
    • Data Display and Grid
      • Siticone DataGrid
        • Data Management & Binding
        • Theming and Appearance Customization
        • Behavior & Interaction
        • Built-In Data Import/Export and Encryption
        • Search and Filtering Capabilities
        • Text Formatting and Cell Styling (Ribbon Toolbar)
        • User Interaction Enhancements
        • Events and Callbacks
      • Siticone Label
        • Text and Content
        • Transparent Background
        • Layout & Rendering Enhancements
        • Standard Layout Properties (Inherited)
      • Siticone LinkedLabel
        • Text and Link Behavior
        • Color Properties
        • Font and Appearance
        • Events
      • Siticone ShimmerLabel
        • Shimmer Appearance
        • Shimmer Behavior
        • Shimmer Text
    • Form Design Framework
      • Siticone Form
        • Window Behavior & Layout
        • Title Bar Customization
        • Control Box (Window Buttons) Customization
        • Theme and Appearance
        • Animation & Visual Effects
        • Events and Public Methods
      • Siticone EmptyForm
        • Visual Appearance & Styling
        • Rendering and Performance Enhancements
      • Siticone DragForm
        • Drag Functionality
        • Accessibility and Keyboard Navigation
        • Performance Optimizations
        • Appearance Customization
    • Gauges and Measurement
      • Siticone GaugeClock
        • Value Hand Customization
        • Core Appearance & Theme
        • Typography & Labeling
        • Gauge Configuration & Value Range
        • 3D Effects and Metallic Appearance
        • Visual Effects and Enhancements
        • Gradient Customization
        • Display & Format Options
        • Scale and Tick Mark Configuration
        • Animation & Interaction
        • Export/Import and Context Menu Options
        • Section Management
        • Events and Callbacks
      • Siticone GaugeDigital
        • Gauge Core Settings
        • LED Display Settings
        • Visual Style and Themes
        • 3D Effects
        • Lighting Effects
        • Typography and Scale
        • Custom Gradients and Texture
        • Animation and Interactivity
        • Context Menu Operations
        • Events
      • Siticone GaugeNumeric
        • Gauge Display & Value
        • Scale and Markers
        • Typography & Text
        • Color Customization
        • 3D and Special Effects
        • Interaction & Tool-tip
        • Additional Features & Events
      • Siticone GaugeZone
        • ZonePasswordForm (Password Dialog Control)
        • Control Features
    • Chip and Group Controls
      • Siticone Chip
        • Appearance & Color Scheme
        • Corner and Shape Customization
        • Visual Effects
        • Interaction & Behavior
        • Close Button Customization
        • Selection Indicator Customization
        • Visual Content
        • Events
      • Siticone GroupChip
        • Group Management
        • Visual Effects
        • State Colors
        • Close Button Styling & Layout
        • Selection Indicator
        • Visual Elements
        • Color Scheme
        • Border Customization
        • Corner Customization
        • Interactive Features
        • Animation Settings
        • Behavior
        • Events
      • Siticone GroupChipPanel
        • Drag-and-Drop Customization
        • Chip Selection Customization
        • Chip Management API
        • Chip Events
      • Siticone GroupButton
        • Material Design Effects
        • Surface Styling
        • Screen Reader Support
        • Alert System (Badge Features)
        • Selection and Interactive States
        • Selection Markers and Indicator Customization
        • Content Layout
        • Animation and Motion
        • Corner and Shape Customization
        • Events and Callbacks
    • Media and Graphics
      • Siticone Audio
        • Basic Behavior and State
        • Appearance Customization
        • Sound Wave Animation and Style
        • Visual Effects and Animations
        • Events and Callbacks
      • Siticone PictureBox
        • Image Loading and Display
        • Layout and Sizing
        • Shape and Border Config
        • Image Quality and Effects
        • Image Transformations
        • Slideshow Functionality
        • Interaction & Behavior
        • Performance & Display
      • Signature Pad
        • Context Menu Customization
        • Template Customization
        • Animation Features
        • Stroke Aesthetics and Dynamics
        • Input Processing and Guides
        • Visual Guides
        • Rendering Quality
        • Performance
        • User Experience
        • Public Methods for Signature Handling
        • Public Events for Integration
        • Events
    • Separator Controls
      • Siticone HSeparator
        • Segment Configuration
        • Line Multiplication
        • Visual Styling
      • Siticone VSeparator
        • Segment Configuration
        • Line Multiplication
        • Visual Styling
        • Enumerations
    • Utility Controls
      • Siticone BackgroundWkr
        • Worker Initialization and Configuration
        • Custom Progress Reporting Functionality
      • Siticone SystemInfo
        • System and Service Information
        • Security and User Information
        • Performance and Memory Metrics
        • System Hardware and Operating System Details
        • Peripherals and Additional Devices
        • Hardware (Detailed)
        • Display Details
        • Network Information
        • Configuration Options
        • Methods for Data Retrieval and Export
        • Events and Callbacks
      • Siticone TaskbarBadgeS.
        • Badge Display & Formatting
        • Animation Effects
        • Notification Effects
        • Flash / Highlight Effects
        • System Theme Integration
        • Parent Form Integration
        • Events and Callbacks
      • Siticone ThemeSwitcher
        • Layout and Spacing
        • Visual Effects and Animation
        • Icon Customization
        • Border and Corner Configuration
        • Color Scheme
        • Behavior and State
        • Accessibility
      • Siticone ThemeTracker
        • Theme and Accent Information
        • Theme Application and Automation
        • Theme & Accent Events
        • Initialization
      • Siticone IdGen
        • Unique ID Customization
        • Character Set Customization
        • ID Generation Strategy and Distribution Settings
        • ID Generation and Collision Handling
    • Data Formatting and Display
      • Siticone Humanizer Date..
        • Data Management
        • Formatting Settings
        • Calculation Options
        • Custom Translations
      • Siticone HumanizerDec..
        • Input Value Configuration
        • Automatic Humanized Output
        • Customizable Humanization
      • Siticone HumanizerFloat
        • Formatting Features
        • Validation Features
        • Currency Features
        • Localization Features
        • Value and Precision Features
        • Read-Only Display Features
        • Additional Public Methods
        • Enumerations (for Customization)
      • Siticone HumanizerInt
        • Core Number Conversion
        • Text Customization and Styling Options
        • Number Scale & Localization
        • Currency Features
        • Performance and Asynchronous Processing
        • Caching Mechanism and Management
        • Settings Change Notifications
      • Siticone HumanizerLong
        • Core Number Conversion
        • Formatting and Localization Options
        • Security and Data Integrity
        • Performance and Caching
        • Events for Developer Integration
    • Special Purpose Controls
      • Siticone CardNumber
        • Appearance Customization
        • Credit Card Specific Features
        • Input and Validation
        • Read-Only Customization
        • Shadow & Animation Effects
        • Selection and Text Editing
        • Context Menu Support
        • Credit Card Events
      • Siticone CopyUrl
        • URL Display and Core Functionality
        • Icon Management
        • Copy Button Customization
        • Text Styling
        • Background & Border Styling
        • Corner Styling
        • Animation Effects
        • Interaction Behavior
        • Notification System
        • Additional Built-In Features
      • Siticone Rating
        • Rating Functionality
        • Appearance Customization
        • Layout and Sizing Customization
        • Behavior Customization
        • Animation Customization
        • Focus and Accessibility Customization
        • Right‑Click Context Menu Customization
      • Siticone RatingEmoji
        • Theme Management
        • Emoji Customization
        • Visual Enhancement
        • Selection and Rating
        • Animation and Interaction Dynamics
        • User Feedback
        • Data Persistence
Powered by GitBook
On this page
  1. Net Framework | Net Core UI
  2. Input Controls
  3. Siticone CheckBox

Container States

Manage and customize the container's appearance based on different interaction and state scenarios to enhance user experience and interface aesthetics.

Overview

The Container States feature of the SiticoneCheckBox control allows developers to define and manipulate the container's visual appearance based on various states such as Default, Hover, Pressed, Checked, and Indeterminate. By leveraging these state-specific properties, you can provide clear visual feedback to users, enhancing interactivity and ensuring that the checkbox seamlessly integrates with your application's design language.

Key Properties

The following table outlines the primary public properties associated with the Container States of the SiticoneCheckBox. These properties enable comprehensive customization of the container's appearance based on its current state.

Property

Type

Description

ContainerBackColor

Color

Sets the background color of the container in its default state.

ContainerBorderColor

Color

Sets the border color of the container in its default state.

ContainerBorderWidth

int

Sets the border width of the container in pixels.

ContainerTopLeftRadius

int

Sets the top-left corner radius of the container.

ContainerTopRightRadius

int

Sets the top-right corner radius of the container.

ContainerBottomLeftRadius

int

Sets the bottom-left corner radius of the container.

ContainerBottomRightRadius

int

Sets the bottom-right corner radius of the container.

ContainerCheckedColor

Color

Sets the container's background color when the checkbox is checked.

ContainerCheckedBorderColor

Color

Sets the container's border color when the checkbox is checked.

ContainerHoverBackColor

Color

Sets the container's background color when the mouse hovers over it.

ContainerPressedBackColor

Color

Sets the container's background color when the checkbox is pressed (clicked).

ContainerCheckedHoverColor

Color

Sets the container's background color when the checkbox is both checked and hovered over.

ContainerCheckedPressedColor

Color

Sets the container's background color when the checkbox is both checked and pressed.

IndeterminateColor

Color

Sets the container's background color when the checkbox is in an indeterminate state.

IndeterminateBorderColor

Color

Sets the container's border color when the checkbox is in an indeterminate state.

Detailed Property Descriptions

1. ContainerBackColor (Color)

Description: Sets the container's background color in its default (normal) state, providing a consistent baseline appearance when the checkbox is neither interacted with nor in a checked or indeterminate state.

Usage: Assign a Color value to define the container's default background.

Example:

// Set container default background color to white
siticoneCheckBox.ContainerBackColor = Color.White;

// Set container default background color to light gray
siticoneCheckBox.ContainerBackColor = Color.LightGray;

2. ContainerBorderColor (Color)

Description: Sets the container's border color in its default state, defining the outline's visual characteristics when the checkbox is in its normal state.

Usage: Assign a Color value to customize the container's default border color.

Example:

// Set container default border color to dark gray
siticoneCheckBox.ContainerBorderColor = Color.DarkGray;

// Set container default border color to black
siticoneCheckBox.ContainerBorderColor = Color.Black;

3. ContainerBorderWidth (int)

Description: Sets the width of the container's border in pixels, allowing control over the thickness of the container's outline.

Usage: Specify the border width in pixels.

Example:

// Set container border width to 2 pixels
siticoneCheckBox.ContainerBorderWidth = 2;

// Increase container border width to 4 pixels for greater emphasis
siticoneCheckBox.ContainerBorderWidth = 4;

4. ContainerTopLeftRadius (int)

Description: Sets the top-left corner radius of the container, allowing for rounded or sharp corners based on the value.

Usage: Assign an integer value representing the radius in pixels.

Example:

// Set top-left corner radius to 10 pixels
siticoneCheckBox.ContainerTopLeftRadius = 10;

// Set top-left corner radius to 0 for a sharp corner
siticoneCheckBox.ContainerTopLeftRadius = 0;

5. ContainerTopRightRadius (int)

Description: Sets the top-right corner radius of the container, enabling customization of corner curvature.

Usage: Assign an integer value representing the radius in pixels.

Example:

// Set top-right corner radius to 10 pixels
siticoneCheckBox.ContainerTopRightRadius = 10;

// Set top-right corner radius to 0 for a sharp corner
siticoneCheckBox.ContainerTopRightRadius = 0;

6. ContainerBottomLeftRadius (int)

Description: Sets the bottom-left corner radius of the container, allowing for tailored corner shapes.

Usage: Assign an integer value representing the radius in pixels.

Example:

// Set bottom-left corner radius to 10 pixels
siticoneCheckBox.ContainerBottomLeftRadius = 10;

// Set bottom-left corner radius to 0 for a sharp corner
siticoneCheckBox.ContainerBottomLeftRadius = 0;

7. ContainerBottomRightRadius (int)

Description: Sets the bottom-right corner radius of the container, providing control over the curvature of the corner.

Usage: Assign an integer value representing the radius in pixels.

Example:

// Set bottom-right corner radius to 10 pixels
siticoneCheckBox.ContainerBottomRightRadius = 10;

// Set bottom-right corner radius to 0 for a sharp corner
siticoneCheckBox.ContainerBottomRightRadius = 0;

8. ContainerCheckedColor (Color)

Description: Sets the container's background color when the checkbox is in the checked state. This property allows the container to visually reflect the checkbox's state, providing clear user feedback.

Usage: Assign a Color value to customize the container's background color when checked.

Example:

// Set container checked background color to green
siticoneCheckBox.ContainerCheckedColor = Color.Green;

// Set container checked background color to blue
siticoneCheckBox.ContainerCheckedColor = Color.Blue;

9. ContainerCheckedBorderColor (Color)

Description: Sets the container's border color when the checkbox is in the checked state. This property enhances the visual distinction of the checked state by altering the container's outline accordingly.

Usage: Assign a Color value to customize the container's border color when checked.

Example:

// Set container checked border color to dark green
siticoneCheckBox.ContainerCheckedBorderColor = Color.DarkGreen;

// Set container checked border color to navy
siticoneCheckBox.ContainerCheckedBorderColor = Color.Navy;

10. ContainerHoverBackColor (Color)

Description: Sets the container's background color when the user hovers the mouse over the checkbox, providing visual feedback during hover interactions.

Usage: Assign a Color value to customize the container's background color on hover.

Example:

// Set container hover background color to light yellow
siticoneCheckBox.ContainerHoverBackColor = Color.LightYellow;

// Set container hover background color to light gray
siticoneCheckBox.ContainerHoverBackColor = Color.LightGray;

11. ContainerPressedBackColor (Color)

Description: Sets the container's background color when the checkbox is pressed (clicked), providing immediate visual feedback during active interactions.

Usage: Assign a Color value to customize the container's background color when pressed.

Example:

// Set container pressed background color to dark blue
siticoneCheckBox.ContainerPressedBackColor = Color.DarkBlue;

// Set container pressed background color to dark green
siticoneCheckBox.ContainerPressedBackColor = Color.DarkGreen;

12. ContainerCheckedHoverColor (Color)

Description: Sets the container's background color when the checkbox is both checked and hovered over. This allows for nuanced visual feedback combining multiple states.

Usage: Assign a Color value to customize the container's background color when checked and hovered.

Example:

// Set container checked hover background color to light green
siticoneCheckBox.ContainerCheckedHoverColor = Color.LightGreen;

// Set container checked hover background color to teal
siticoneCheckBox.ContainerCheckedHoverColor = Color.Teal;

13. ContainerCheckedPressedColor (Color)

Description: Sets the container's background color when the checkbox is both checked and pressed. This provides distinct visual feedback during combined state interactions.

Usage: Assign a Color value to customize the container's background color when checked and pressed.

Example:

// Set container checked pressed background color to dark teal
siticoneCheckBox.ContainerCheckedPressedColor = Color.DarkTeal;

// Set container checked pressed background color to dark blue
siticoneCheckBox.ContainerCheckedPressedColor = Color.DarkBlue;

14. IndeterminateColor (Color)

Description: Sets the container's background color when the checkbox is in an indeterminate state. This property is useful for scenarios like "Select All" checkboxes that indicate partial selection.

Usage: Assign a Color value to customize the container's background color when in the indeterminate state.

Example:

// Set container indeterminate background color to yellow
siticoneCheckBox.IndeterminateColor = Color.Yellow;

// Set container indeterminate background color to orange
siticoneCheckBox.IndeterminateColor = Color.Orange;

15. IndeterminateBorderColor (Color)

Description: Sets the container's border color when the checkbox is in an indeterminate state. This property differentiates the container's outline during partial selection scenarios.

Usage: Assign a Color value to customize the container's border color when in the indeterminate state.

Example:

// Set container indeterminate border color to goldenrod
siticoneCheckBox.IndeterminateBorderColor = Color.Goldenrod;

// Set container indeterminate border color to dark orange
siticoneCheckBox.IndeterminateBorderColor = Color.DarkOrange;

Code Examples

Example 1: Enabling Container States with Customized Styling

using SiticoneNetFrameworkUI;
using System.Drawing;
using System.Windows.Forms;

public class ContainerStatesForm : Form
{
    private SiticoneCheckBox containerStateCheckBox;

    public ContainerStatesForm()
    {
        InitializeComponent();
    }

    private void InitializeComponent()
    {
        this.containerStateCheckBox = new SiticoneCheckBox();
        this.SuspendLayout();

        // 
        // containerStateCheckBox
        // 
        this.containerStateCheckBox.Style = CheckBoxStyle.Classic;
        this.containerStateCheckBox.IsContained = true; // Enable container layout
        this.containerStateCheckBox.ContainerBackColor = Color.White;
        this.containerStateCheckBox.ContainerBorderColor = Color.Gray;
        this.containerStateCheckBox.ContainerBorderWidth = 1;
        this.containerStateCheckBox.ContainerHoverBackColor = Color.LightYellow;
        this.containerStateCheckBox.ContainerHoverBorderColor = Color.Orange;
        this.containerStateCheckBox.ContainerPressedBackColor = Color.LightGreen;
        this.containerStateCheckBox.ContainerPressedBorderColor = Color.Green;
        this.containerStateCheckBox.ContainerCheckedColor = Color.Green;
        this.containerStateCheckBox.ContainerCheckedBorderColor = Color.DarkGreen;
        this.containerStateCheckBox.ContainerCheckedHoverColor = Color.MediumSeaGreen;
        this.containerStateCheckBox.ContainerCheckedPressedColor = Color.DarkGreen;
        this.containerStateCheckBox.IndeterminateColor = Color.Yellow;
        this.containerStateCheckBox.IndeterminateBorderColor = Color.Goldenrod;
        this.containerStateCheckBox.Text = "Enable Feature";
        this.containerStateCheckBox.Location = new Point(50, 50);
        this.containerStateCheckBox.Size = new Size(200, 40);
        this.containerStateCheckBox.CheckStateChanged += ContainerStateCheckBox_CheckStateChanged;

        // 
        // ContainerStatesForm
        // 
        this.ClientSize = new Size(300, 200);
        this.Controls.Add(this.containerStateCheckBox);
        this.Text = "SiticoneCheckBox - Container States Example";
        this.ResumeLayout(false);
    }

    private void ContainerStateCheckBox_CheckStateChanged(object sender, CheckStateEventArgs e)
    {
        // The container appearance updates automatically based on property bindings.
        // No additional code is required here unless you have custom logic to handle state changes.
    }
}

Explanation:

  • The checkbox is enabled within a styled container by setting IsContained = true.

  • Container properties are customized for different states: default, hover, pressed, checked, and indeterminate.

  • An event handler ContainerStateCheckBox_CheckStateChanged is attached to respond to state changes. The container's appearance updates automatically based on property bindings, eliminating the need for manual updates.


Example 2: Dynamic Container Styling Based on Checkbox State

using SiticoneNetFrameworkUI;
using System.Drawing;
using System.Windows.Forms;

public class DynamicContainerStatesForm : Form
{
    private SiticoneCheckBox dynamicContainerCheckBox;

    public DynamicContainerStatesForm()
    {
        InitializeComponent();
    }

    private void InitializeComponent()
    {
        this.dynamicContainerCheckBox = new SiticoneCheckBox();
        this.SuspendLayout();

        // 
        // dynamicContainerCheckBox
        // 
        this.dynamicContainerCheckBox.Style = CheckBoxStyle.Minimal;
        this.dynamicContainerCheckBox.IsContained = true;
        this.dynamicContainerCheckBox.ContainerPadding = 8;
        this.dynamicContainerCheckBox.ContainerBackColor = Color.White;
        this.dynamicContainerCheckBox.ContainerBorderColor = Color.Gray;
        this.dynamicContainerCheckBox.ContainerBorderWidth = 1;
        this.dynamicContainerCheckBox.ContainerHoverBackColor = Color.LightGray;
        this.dynamicContainerCheckBox.ContainerHoverBorderColor = Color.DarkGray;
        this.dynamicContainerCheckBox.ContainerPressedBackColor = Color.DarkGray;
        this.dynamicContainerCheckBox.ContainerPressedBorderColor = Color.Black;
        this.dynamicContainerCheckBox.ContainerCheckedColor = Color.LightGreen;
        this.dynamicContainerCheckBox.ContainerCheckedBorderColor = Color.Green;
        this.dynamicContainerCheckBox.ContainerCheckedHoverColor = Color.MediumSeaGreen;
        this.dynamicContainerCheckBox.ContainerCheckedPressedColor = Color.DarkGreen;
        this.dynamicContainerCheckBox.IndeterminateColor = Color.LightYellow;
        this.dynamicContainerCheckBox.IndeterminateBorderColor = Color.Goldenrod;
        this.dynamicContainerCheckBox.Text = "Agree to Terms";
        this.dynamicContainerCheckBox.Location = new Point(50, 50);
        this.dynamicContainerCheckBox.Size = new Size(180, 35);
        this.dynamicContainerCheckBox.CheckStateChanged += DynamicContainerCheckBox_CheckStateChanged;

        // 
        // DynamicContainerStatesForm
        // 
        this.ClientSize = new Size(300, 200);
        this.Controls.Add(this.dynamicContainerCheckBox);
        this.Text = "SiticoneCheckBox - Dynamic Container Styling";
        this.ResumeLayout(false);
    }

    private void DynamicContainerCheckBox_CheckStateChanged(object sender, CheckStateEventArgs e)
    {
        // The container appearance updates automatically based on property bindings.
        // No additional code is required here unless you have custom logic to handle state changes.
    }
}

Explanation:

  • The checkbox is contained within a styled container with initial properties set for padding, background color, border color, and corner radii.

  • An event handler DynamicContainerCheckBox_CheckStateChanged is attached to respond to state changes. The container's appearance updates automatically based on property bindings, eliminating the need for manual updates.


Best Practices

Adhering to best practices ensures that the Container States feature enhances the user interface without introducing design inconsistencies or usability issues. The following table outlines key best practices for effectively implementing container states in the SiticoneCheckBox control.

Best Practice

Description

Enable Containers When Necessary

Use containers to group checkboxes with related options, enhancing layout structure and visual hierarchy within the UI.

Maintain Consistent State Styling

Apply uniform styling for containers across similar states to ensure a cohesive and professional appearance.

Use Complementary Colors

Choose ContainerBackColor and ContainerBorderColor that complement the application's color scheme, maintaining visual harmony and enhancing the checkbox's visibility.

Adjust Corner Radii for Style

Customize corner radii (ContainerTopLeftRadius, etc.) to align with the overall design language, whether aiming for rounded or sharp edges.

Dynamic Styling Based on State

Utilize state-specific properties like ContainerCheckedColor and ContainerHoverBackColor to provide clear visual feedback on user interactions and checkbox states.

Optimize for Readability

Ensure that container styling does not obscure the checkbox's visibility. Maintain sufficient contrast and clarity between the container and the checkbox.

Leverage Event Handlers for Dynamic Changes

Use event handlers such as CheckStateChanged to handle custom logic based on the checkbox's state, enhancing interactivity and responsiveness.

Ensure Scalability

Design container layouts to be responsive and adaptable to different screen sizes and resolutions, ensuring consistent appearance across various devices and display settings.

Avoid Overcomplicating Designs

While containers offer enhanced styling options, avoid overly complex container designs that may clutter the UI or confuse users.

Test Across Different Themes

Validate container layouts under various application themes (light, dark, custom) to ensure consistent and visually appealing appearances in all contexts.


Common Pitfalls and Design Considerations

Understanding and avoiding common pitfalls ensures that the Container States feature is implemented effectively, maintaining both functionality and visual appeal. The following tables detail these aspects.

Common Pitfalls

Pitfall

Description

Solution

Inconsistent Container Styling

Applying different container styles to similar checkboxes can lead to a disjointed and unprofessional UI.

Establish and adhere to a consistent container styling guideline, ensuring uniformity across all checkbox instances.

Overlapping Container and Checkbox Styles

Conflicting styles between the container and the checkbox can obscure the checkbox or create visual confusion.

Ensure that container background and border colors complement the checkbox's style and do not obscure its visibility.

Insufficient Contrast

Low contrast between ContainerBackColor and ContainerBorderColor can make the container's boundaries unclear.

Choose colors with adequate contrast to clearly define the container's borders and background.

Neglecting Padding Adjustments

Inadequate ContainerPadding can result in cramped or overly spacious checkbox placements within containers.

Adjust ContainerPadding to achieve balanced spacing that enhances readability and aesthetics.

Ignoring Corner Radius Consistency

Varying corner radii within a single container or across multiple containers can disrupt visual harmony.

Maintain consistent corner radii settings within a single container and across similar controls throughout the application.

Design Considerations

Designing effective container states involves several key considerations to ensure that the checkbox is both functional and aesthetically pleasing. The following table outlines these considerations.

Aspect

Consideration

Implementation Tips

Visual Hierarchy

Containers can establish a visual hierarchy, grouping related checkboxes and enhancing UI structure.

Use containers to logically group related checkboxes, making the interface more intuitive and organized for users.

Aesthetic Consistency

The container's styling should align with the application's overall design language and theme to maintain visual harmony.

Select ContainerBackColor, ContainerBorderColor, and corner radii that complement the application's color palette and design motifs.

Spatial Efficiency

Containers should optimize the use of space without causing clutter or excessive whitespace.

Adjust ContainerPadding to achieve balanced spacing, ensuring that checkboxes are neither too cramped nor overly spaced.

State-Responsive Styling

Containers should visually respond to the checkbox's state changes, providing clear feedback to users.

Utilize state-specific properties like ContainerCheckedColor and ContainerHoverBackColor to dynamically reflect the checkbox's state.

Accessibility

Container designs should support accessibility, ensuring that all users can interact with and understand the checkbox's state.

Choose colors with sufficient contrast, maintain clear borders, and ensure that container styling does not impede readability.

Responsive Design

Containers should adapt to different screen sizes and resolutions, maintaining consistent appearance across devices.

Implement scalable container sizes and responsive corner radii to ensure that the checkbox remains proportionate and visible on various displays.

Interactive Feedback

Containers should enhance interactive feedback, such as hover and press effects, to improve user engagement.

Customize ContainerHoverBackColor and ContainerPressedBackColor to provide immediate visual responses to user interactions.

Performance Impact

Complex container designs can impact rendering performance, especially in resource-constrained environments.

Opt for simple and optimized container styles that achieve the desired aesthetic without excessive rendering overhead.

Customization Flexibility

Providing a range of container customization options allows developers to tailor the checkbox to diverse design requirements.

Expose properties like ContainerBorderWidth to enable detailed customization based on specific UI needs.

Integration with Other Controls

Ensure that container styles harmonize with other UI elements, fostering a cohesive and professional interface.

Align container styling with the styling of related controls (e.g., buttons, labels) to maintain a unified design language.


Summary and Review

The Container States feature of the SiticoneCheckBox control provides a set of properties that enable developers to customize the container's appearance based on the checkbox's current state comprehensively. By defining state-specific colors and adjusting container properties, you can ensure that the container dynamically reflects the checkbox's state, offering clear and immediate visual feedback to users.

Key Takeaways:

Point

Explanation

State-Specific Customization

Properties like ContainerCheckedColor, ContainerHoverBackColor, and ContainerPressedBackColor allow for detailed customization based on the checkbox's state.

Comprehensive Styling Options

A wide range of container properties such as ContainerBackColor, ContainerBorderColor, and ContainerBorderWidth enable developers to create visually appealing layouts.

Dynamic Feedback

The container's appearance updates automatically based on property bindings, ensuring that visual feedback corresponds accurately to the checkbox's state.

Accessibility and Usability

Thoughtful color choices and clear border definitions ensure that the container is accessible to all users, including those with visual impairments.

Consistency and Uniformity

Maintaining consistent container styles across similar controls fosters a cohesive and professional user interface, improving overall user experience.

Performance Optimization

Efficient implementation of container state properties ensures that enhanced visual feedback does not compromise application performance.

Customization Flexibility

The extensive range of container properties provides developers with the flexibility to tailor the checkbox's appearance to meet specific design requirements and preferences.

Responsive Design Support

Containers are designed to adapt to various screen sizes and resolutions, maintaining consistent appearance and functionality across different devices.

By adhering to the best practices and design considerations outlined above, developers can effectively leverage the Container States feature to create checkboxes that are not only functional but also enhance the overall visual structure and user experience of their applications.

PreviousContainer StyleNextState Colors

Last updated 4 months ago