AlfaToad.CustomControls 4.2.6

AlfaToad.CustomControls

Библиотека пользовательских контролов для Windows Forms (.NET Framework 4.8 и .NET 8).

Пакет: NuGet — AlfaToad.CustomControls

Компоненты

Установка

dotnet add package AlfaToad.CustomControls --version 4.2.1

<PackageReference Include="AlfaToad.CustomControls" Version="4.2.1" />

ScrollableDetailPanel — настраиваемые свойства

Поля данных (имена столбцов в DataTable)

Подписи на экране

Изображения

Размеры строки

ScrollableOrderPanel — настраиваемые свойства

Поля данных

Подписи на экране

Размеры строки

Добавление, редактирование и удаление (CRUD)

Оба списка (ScrollableDetailPanel, ScrollableOrderPanel) поддерживают кнопки Добавить / Изменить / Удалить и клик по строке для редактирования. Формы добавления и редактирования открывает ваше приложение в обработчиках событий.

Права по ролям

При false соответствующая кнопка скрывается. При попытке действия без прав показывается MessageBox с пояснением.

События

После закрытия формы редактирования вызовите EndEditSession(), чтобы снова можно было открыть другое окно.

Пример для администратора (товары)

var panel = new ScrollableDetailPanel { Dock = DockStyle.Fill };
panel.AllowAdd = panel.AllowEdit = panel.AllowDelete = userIsAdmin;
panel.ShowQueryPanel = userIsManagerOrAdmin;

panel.ValidateBeforeDelete = row =>
{
    var article = row["Артикул"]?.ToString();
    return ProductExistsInOrders(article)
        ? "Товар присутствует в заказе и не может быть удалён."
        : null;
};

panel.RecordAddRequested += (_, __) => OpenProductForm(null);
panel.RecordEditRequested += (_, e) => OpenProductForm(e.Row);
panel.RecordDeleted += (_, e) =>
{
    tableAdapter.Update(dataSet);
    panel.RefreshRows();
};

Пример для менеджера (заказы — только просмотр)

ordersPanel.AllowAdd = ordersPanel.AllowEdit = ordersPanel.AllowDelete = userIsAdmin;
// менеджер: все три свойства false — кнопки скрыты, клик только выделяет строку

Обработка исключительных случаев

Библиотека показывает MessageBox в ситуациях:

• действие недоступно для роли;
• не выбрана запись для изменения или удаления;
• уже открыто окно редактирования (IsEditSessionActive);
• ValidateBeforeDelete или RecordDeleting запретили удаление;
• ошибка при удалении строки из DataTable.

BoundDataGridView — настраиваемые свойства

AppearancePalette — настройка цветов и шрифтов

Общий объект Appearance доступен у всех трёх контролов.

Редактор в дизайнере Visual Studio

1. Выберите контрол на форме.
2. В окне Свойства найдите Appearance.
3. Разверните узел — каждый цвет редактируется стандартным выбором цвета.
4. Нажмите «…» рядом с Appearance — откроется окно «Палитра оформления» со всеми цветами, шрифтами и порогом скидки; кнопка «По умолчанию» сбрасывает значения.

Изменения сразу применяются к контролу на форме в режиме дизайна.

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

Список товаров с привязкой к DataSet

using System.Data;
using System.Drawing;
using AlfaToad.CustomControls.Controls;
using AlfaToad.CustomControls.Theme;

var panel = new ScrollableDetailPanel { Dock = DockStyle.Fill };

panel.NoImage = Image.FromFile(@"C:\images\no-photo.png");
panel.ImagesFolder = @"C:\images\products";

panel.CategoryField = "CategoryName";
panel.NameField = "ProductName";
panel.DiscountField = "DiscountPercent";

panel.Appearance = new AppearancePalette
{
    MainBackground = Color.White,
    HighlightBackground = Color.FromArgb(255, 222, 173),
    BorderColor = Color.Black,
    HighlightThresholdPercent = 17m
};

DataSet dataSet = LoadProducts();
panel.BindDataSet(dataSet, "Products");

Поведение цены: если Действующая скидка > 0, основная цена отображается красной и перечёркнутой, рядом — итоговая цена чёрным (цена × (1 − скидка/100)).

Нет на складе: если Кол-во на складе ≤ 0, вся строка подсвечивается цветом OutOfStockRowColor.

Поиск, фильтрация и сортировка (ScrollableDetailPanel)

Панель включена по умолчанию (ShowQueryPanel = true). Всё применяется в реальном времени без кнопки «Найти».

panel.ShowQueryPanel = userIsManagerOrAdmin;

После TableAdapter.Fill(...) список и список поставщиков обновляются автоматически.

Список заказов

var orders = new ScrollableOrderPanel { Dock = DockStyle.Fill };
orders.Appearance = AppearancePalette.CreateDefault();
orders.Appearance.AccentBackground = Color.BurlyWood;
orders.BindDataSet(dataSet, "Orders");

Таблица с подсветкой скидки

var grid = new BoundDataGridView { Dock = DockStyle.Fill };
grid.Appearance = AppearancePalette.CreateDefault();
grid.HighlightColumnName = "Действующая скидка";
grid.ApplyDefaultStyle();
grid.BindDataSet(dataSet, "Products");

Смена цветов после создания

panel.Appearance.MainBackground = ColorTranslator.FromHtml("#FAFAFA");
panel.Appearance.HighlightBackground = ColorTranslator.FromHtml("#FFDEAD");
panel.Appearance.BorderColor = Color.DimGray;
panel.ApplyAppearance();