Events and Callbacks

This feature exposes various events and callbacks that enable developers to react to user interactions and state changes within the SiticoneTabControl. These events provide hooks for custom behavior

Overview

The Events and Callbacks feature of the SiticoneTabControl allows developers to subscribe to both standard and custom events triggered by user interactions. Key events include changes in tab selection, mouse actions (such as clicks, moves, and wheel scrolling), and drag-and-drop operations. By handling these events, developers can implement custom logic to further enhance the control's behavior, integrate business logic, or provide additional visual feedback.

---

Events Overview

Event Name	Description	When Triggered	Inheritance/Origin
SelectedIndexChanged	Occurs when the selected tab changes, allowing custom logic to be executed on tab switch.	After a new tab is selected (via click or programmatically).	Inherited from TabControl
MouseDown	Occurs when a mouse button is pressed on the control; used for initiating tab selection, close operations, or pin toggling.	When a mouse button is pressed over any part of the control.	Inherited from Control
MouseMove	Occurs when the mouse pointer moves over the control; used for hover effects, drag initiation, and dynamic feedback.	Continuously while the mouse is over the control.	Inherited from Control
MouseUp	Occurs when a mouse button is released, commonly used to complete drag-and-drop operations.	When the mouse button is released over the control.	Inherited from Control
MouseLeave	Occurs when the mouse pointer leaves the control's bounds, useful for canceling hover animations.	When the pointer exits the control’s area.	Inherited from Control
MouseWheel	Occurs when the mouse wheel is scrolled, enabling navigation through tabs via the wheel.	On mouse wheel scrolling over the control.	Inherited from Control
HandleCreated	Occurs when the control’s handle is created, ensuring that any initialization requiring a valid handle can be performed.	When the control is fully initialized and its handle is created.	Inherited from Control

*Note: In addition to these standard events, the control internally uses custom event handlers (e.g., for animations and drag feedback) that update the UI automatically. These internal events are managed by the control and do not require manual subscription.

---

Key Points

Aspect	Details
Comprehensive Event Coverage	Events cover both standard user interactions (click, mouse move, wheel scroll) and control-specific operations (tab switching, drag-and-drop).
Customizability	Developers can subscribe to these events to implement custom behaviors, logging, or additional visual effects.
Immediate Feedback	Event callbacks allow immediate responses to user interactions, ensuring a highly interactive and responsive UI.

---

Best Practices

Practice	Explanation	Code Example
Subscribe to SelectedIndexChanged	Use this event to update UI elements or load content dynamically when the active tab changes.	csharp<br>tabControl.SelectedIndexChanged += TabControl_SelectedIndexChanged;<br>
Use Mouse Events for Enhanced Feedback	Leverage MouseDown, MouseMove, and MouseUp events to trigger animations or custom logic (e.g., initiating drag operations).	csharp<br>tabControl.MouseDown += TabControl_MouseDown;<br>tabControl.MouseMove += TabControl_MouseMove;<br>
Unsubscribe When Not Needed	Remove event handlers when they are no longer required to prevent memory leaks and unintended behavior.	csharp<br>tabControl.SelectedIndexChanged -= TabControl_SelectedIndexChanged;<br>

---

Common Pitfalls

Pitfall	Explanation	How to Avoid
Not Handling Multiple Sources of Events	Overlapping mouse events (e.g., MouseDown vs. MouseMove) might lead to unexpected behaviors if not properly managed.	Clearly separate logic for each event and test interactions thoroughly.
Forgetting to Unsubscribe Event Handlers	Not unsubscribing event handlers can lead to memory leaks, especially in long-running applications.	Always unsubscribe event handlers when the control is disposed or no longer needed.
Misinterpreting Standard Events for Custom Logic	Relying solely on inherited events without considering the control-specific behaviors may cause inconsistent UI updates.	Combine standard events with control-specific methods (such as internal animations) where appropriate.

---

Usage Scenarios

Scenario	Description	Sample Code Snippet
Dynamic Content Loading	Use the SelectedIndexChanged event to load new content in a tab when it becomes active.	csharp<br>private void TabControl_SelectedIndexChanged(object sender, EventArgs e)<br>{<br> // Load content based on selected tab<br> var selectedTab = tabControl.SelectedTab;<br> LoadContentForTab(selectedTab);<br>}<br>
Custom Drag-and-Drop Handling	Utilize MouseDown, MouseMove, and MouseUp events to customize drag-and-drop operations or visual feedback during tab reordering.	csharp<br>tabControl.MouseDown += (s, e) => { /* initiate drag */ };<br>tabControl.MouseMove += (s, e) => { /* update drag visual */ };<br>tabControl.MouseUp += (s, e) => { /* finalize drag */ };<br>
Enhanced Interaction Logging	Subscribe to mouse events to log user interactions for debugging or analytics purposes.	csharp<br>tabControl.MouseWheel += (s, e) => { Console.WriteLine("Mouse wheel scrolled: " + e.Delta); };<br>

---

Detailed Code Examples

Example 1: Handling Tab Selection Changes

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

public class EventHandlingDemoForm : Form
{
    private SiticoneTabControl tabControl;

    public EventHandlingDemoForm()
    {
        InitializeComponents();
    }

    private void InitializeComponents()
    {
        // Initialize the SiticoneTabControl
        tabControl = new SiticoneTabControl
        {
            Location = new Point(20, 20),
            Size = new Size(700, 350)
        };

        // Add sample tabs
        for (int i = 0; i < 4; i++)
        {
            TabPage page = new TabPage($"Tab {i + 1}");
            tabControl.TabPages.Add(page);
        }

        // Subscribe to the SelectedIndexChanged event
        tabControl.SelectedIndexChanged += TabControl_SelectedIndexChanged;

        // Add the tab control to the form
        this.Controls.Add(tabControl);
        this.Text = "Event and Callback Demo";
        this.StartPosition = FormStartPosition.CenterScreen;
    }

    private void TabControl_SelectedIndexChanged(object sender, EventArgs e)
    {
        // Custom logic when a new tab is selected
        MessageBox.Show($"You switched to {tabControl.SelectedTab.Text}.", "Tab Changed");
    }

    [STAThread]
    public static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new EventHandlingDemoForm());
    }
}

Example 2: Custom Mouse Interaction Logging

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

public class MouseEventDemoForm : Form
{
    private SiticoneTabControl tabControl;

    public MouseEventDemoForm()
    {
        InitializeComponents();
    }

    private void InitializeComponents()
    {
        // Initialize the SiticoneTabControl
        tabControl = new SiticoneTabControl
        {
            Dock = DockStyle.Fill
        };

        // Add sample tabs
        for (int i = 0; i < 3; i++)
        {
            TabPage page = new TabPage($"Page {i + 1}");
            tabControl.TabPages.Add(page);
        }

        // Subscribe to various mouse events for logging
        tabControl.MouseDown += (s, e) => Console.WriteLine($"MouseDown at {e.Location}");
        tabControl.MouseMove += (s, e) => Console.WriteLine($"MouseMove at {e.Location}");
        tabControl.MouseUp += (s, e) => Console.WriteLine($"MouseUp at {e.Location}");
        tabControl.MouseWheel += (s, e) => Console.WriteLine($"MouseWheel scrolled: {e.Delta}");

        // Add the tab control to the form
        this.Controls.Add(tabControl);
        this.Text = "Mouse Event Logging Demo";
        this.StartPosition = FormStartPosition.CenterScreen;
    }

    [STAThread]
    public static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new MouseEventDemoForm());
    }
}

---

Review

Aspect	Review Comments
Flexibility	The control's events provide hooks for both standard and custom interactions, making it easy to extend and adapt the behavior.
Ease of Integration	Developers can quickly subscribe to events like SelectedIndexChanged, MouseDown, and MouseWheel to implement custom logic with minimal effort.
Responsiveness	Immediate callback on user actions (e.g., tab selection, mouse movement) ensures a responsive user interface.

---

Summary

The Events and Callbacks feature in the SiticoneTabControl offers a robust set of event hooks that allow developers to respond to user interactions such as tab selection, mouse actions, and drag events. By subscribing to these events, custom logic can be implemented to enhance interactivity, provide dynamic feedback, and integrate additional business rules or logging functionality. This feature, built on top of standard .NET events, ensures that the control remains flexible and extensible for a variety of application needs.

---

Additional Sections

Integration Checklist

Step	Action Required
Subscribe to Key Events	Attach event handlers to SelectedIndexChanged, MouseDown, MouseMove, MouseUp, MouseWheel, and other events as needed.
Implement Custom Logic	Define callback methods that implement the desired behavior upon each event trigger.
Test Event Responses	Validate that the event handlers are triggered as expected in response to user interactions.
Unsubscribe When Appropriate	Ensure that event handlers are removed when no longer needed to avoid memory leaks.

Frequently Asked Questions

Question	Answer
How do I determine which event to use for a specific interaction?	Use SelectedIndexChanged for tab switching, MouseDown/MouseUp for click events, and MouseWheel for navigation via scrolling.
Can I combine multiple events for a single action?	Yes, you can subscribe to several events to create a composite interaction (e.g., logging on MouseDown and MouseUp).
What if my custom logic causes performance issues?	Optimize your event handlers by keeping them lightweight and consider debouncing or throttling frequent events like MouseMove.

---

This comprehensive documentation for the Events and Callbacks feature, based solely on the provided code, is designed to guide developers in integrating and leveraging event-driven functionality within the SiticoneTabControl for enhanced interactivity and custom behavior in WinForms applications.