DashboardKit 8.6.4

DashboardKit

Панель дашборда с карточками статистики для WinForms-приложений (.NET 8).

Установка

dotnet add package DashboardKit

Справочник API

Класс Dashboard (статический)

Dashboard.Create

public static FlowLayoutPanel Create(params (string Title, object Value, Color Color)[] cards)

Создает панель дашборда (FlowLayoutPanel) с набором карточек статистики. Панель прикрепляется к верхней части контейнера (Dock = Top), высота 100 пикселей, с горизонтальной прокруткой.

Параметры:

• cards — массив кортежей (string Title, object Value, Color Color). Каждый кортеж задает заголовок, значение и цвет фона одной карточки.

Возвращает: FlowLayoutPanel с добавленными карточками.

Dashboard.CreateCard (базовая перегрузка)

public static Panel CreateCard(string title, object value, Color color)

Создает одну карточку статистики размером 180x80 пикселей. Карточка содержит заголовок мелким шрифтом сверху и значение крупным жирным белым шрифтом по центру на цветном фоне.

Параметры:

• title — заголовок карточки.
• value — отображаемое значение (приводится к строке через ToString()).
• color — цвет фона карточки.

Возвращает: Panel с оформленной карточкой.

Dashboard.CreateCard (перегрузка с обработчиком клика)

public static Panel CreateCard(string title, object value, Color color, Action onClick)

Создает карточку статистики с обработчиком клика. При нажатии на карточку или любой её дочерний элемент вызывается переданный делегат. Курсор меняется на «руку».

Параметры:

• title — заголовок карточки.
• value — отображаемое значение.
• color — цвет фона карточки.
• onClick — делегат Action, вызываемый при клике на карточку.

Возвращает: Panel с кликабельной карточкой.

Dashboard.CreateCardWithTrend

public static Panel CreateCardWithTrend(string title, object value, Color color, double changePercent)

Создает карточку статистики шириной 220 пикселей с индикатором тренда. Положительное изменение отображается зеленой стрелкой вверх (▲), отрицательное — красной стрелкой вниз (▼). Процент изменения показывается справа.

Параметры:

• title — заголовок карточки.
• value — отображаемое значение.
• color — цвет фона карточки.
• changePercent — процент изменения (например, 12.5 для роста на 12.5%, -3.2 для падения на 3.2%).

Возвращает: Panel с карточкой и индикатором тренда.

Dashboard.CreateCardWithIcon

public static Panel CreateCardWithIcon(string title, object value, Color color, string icon)

Создает карточку статистики шириной 200 пикселей с Unicode-иконкой слева. Иконка отображается крупным шрифтом (22pt) в левой части карточки.

Параметры:

• title — заголовок карточки.
• value — отображаемое значение.
• color — цвет фона карточки.
• icon — строка с Unicode-символом иконки (например, "\u2708" для самолета).

Возвращает: Panel с карточкой и иконкой.

Примеры использования

Пример 1: Дашборд туристического агентства

using DashboardKit;

// Подсчитываем статистику из базы данных
int tours = db.Tours.Count();
string revenue = db.Orders.Sum(o => o.Total).ToString("N0") + " руб.";
int bookings = db.Orders.Count(o => o.Date == DateTime.Today);
int clients = db.Clients.Count();

// Создаем дашборд с четырьмя карточками
var panel = Dashboard.Create(
    ("Туры в продаже", tours, Color.FromArgb(52, 152, 219)),
    ("Бронирований сегодня", bookings, Color.FromArgb(46, 204, 113)),
    ("Выручка за месяц", revenue, Color.FromArgb(155, 89, 182)),
    ("Клиентов в базе", clients, Color.FromArgb(231, 76, 60))
);
this.Controls.Add(panel);

Пример 2: Склад с кликабельными карточками и трендами

using DashboardKit;

// Карточка с трендом — рост поступлений на 8.3%
var trendCard = Dashboard.CreateCardWithTrend(
    "Поступления", 214, Color.FromArgb(40, 167, 69), 8.3);

// Карточка с трендом — снижение остатков на 2.1%
var stockCard = Dashboard.CreateCardWithTrend(
    "На складе", 1580, Color.FromArgb(52, 152, 219), -2.1);

// Кликабельная карточка — открыть отчет по просроченным позициям
var expiredCard = Dashboard.CreateCard(
    "Просрочено", 5, Color.FromArgb(220, 53, 69),
    () => MessageBox.Show("Открыть отчет по просроченным товарам"));

var flow = new FlowLayoutPanel { Dock = DockStyle.Top, Height = 100 };
flow.Controls.Add(trendCard);
flow.Controls.Add(stockCard);
flow.Controls.Add(expiredCard);
this.Controls.Add(flow);

Пример 3: Библиотечная система с иконками

using DashboardKit;

var books = Dashboard.CreateCardWithIcon(
    "Книг в фонде", 12450, Color.FromArgb(52, 152, 219), "\U0001F4DA");

var readers = Dashboard.CreateCardWithIcon(
    "Читателей", 890, Color.FromArgb(46, 204, 113), "\U0001F464");

var overdue = Dashboard.CreateCardWithIcon(
    "Задолженности", 23, Color.FromArgb(220, 53, 69), "\u26A0");

var flow = new FlowLayoutPanel { Dock = DockStyle.Top, Height = 100 };
flow.Controls.AddRange(new Control[] { books, readers, overdue });
this.Controls.Add(flow);