AlfaToad.CustomControls 4.1.3

AlfaToad.CustomControls

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

Пакет: NuGet — AlfaToad.CustomControls

Компоненты

Установка

dotnet add package AlfaToad.CustomControls --version 4.1.3

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

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

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

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

Изображения

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

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

Поля данных

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

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

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

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

Общий объект 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(); // SqlDataAdapter и т.д.
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();

Сборка

dotnet build AlfaToad.CustomControls.sln -c Release
dotnet run --project src/AlfaToad.CustomControls.Sample -f net8.0-windows -c Release
dotnet pack src/AlfaToad.CustomControls/AlfaToad.CustomControls.csproj -c Release -o ./nupkg

Структура решения

├── AlfaToad.CustomControls.sln
├── README.md
├── build/AlfaToad.CustomControls.targets
└── src/
    ├── AlfaToad.CustomControls/          # библиотека
    └── AlfaToad.CustomControls.Sample/   # пример