BeepCalendarWidget

Overview

BeepCalendarWidget is a paint-based WinForms widget that inherits from BaseControl. It uses an IWidgetPainter pipeline to render rich visuals without child controls. The Style property selects one of 10 built-in render modes; changing it at runtime immediately swaps the painter and triggers a repaint.

Key Features

Style Variants (10)

Properties

Inherits all BaseControl properties (Border, Padding, Theme colors, etc.).

Events

Basic Usage

var cal = new BeepCalendarWidget
{
    Style        = CalendarWidgetStyle.CalendarView,
    SelectedDate = DateTime.Today,
    DisplayMonth = DateTime.Today,
    Events       = new List
    {
        new CalendarEvent { Title = "Sprint Planning", StartTime = DateTime.Today.AddHours(9),
                            EndTime = DateTime.Today.AddHours(11), Color = Color.SteelBlue },
        new CalendarEvent { Title = "Design Review",  StartTime = DateTime.Today.AddDays(2).AddHours(14),
                            EndTime = DateTime.Today.AddDays(2).AddHours(15), Color = Color.MediumPurple },
    },
    Size = new Size(380, 300)
};
this.Controls.Add(cal);

Event Handling

cal.DateClicked += (s, e) =>
{
    DateTime date = (DateTime)e.Data;
    ShowEventsForDate(date);
};

cal.EventClicked += (s, e) =>
{
    var evt = (CalendarEvent)e.Data;
    OpenEventEditor(evt);
};

cal.MonthChanged += (s, e) =>
{
    DateTime newMonth = (DateTime)e.Data;
    LoadEventsForMonth(newMonth);
};

Best Practices

• Set Style before adding the widget to the form to avoid double repaints.
• Adjust Size to fit your layout — defaults are minimum comfortable sizes.
• Read BeepEventDataArgs.Data in event handlers for context-specific click data.
• Call Invalidate() after updating data properties to trigger a repaint.
• Let theme colors flow from BeepStyling.CurrentTheme — avoid overriding color properties unless customization is explicitly desired.

Related Widgets