AlfaToad.CustomControls
4.0.0
.NET 8.0
This package targets .NET 8.0. The package is compatible with this framework or higher.
.NET Framework 4.8
This package targets .NET Framework 4.8. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package AlfaToad.CustomControls --version 4.0.0
NuGet\Install-Package AlfaToad.CustomControls -Version 4.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="AlfaToad.CustomControls" Version="4.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="AlfaToad.CustomControls" Version="4.0.0" />
<PackageReference Include="AlfaToad.CustomControls" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add AlfaToad.CustomControls --version 4.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: AlfaToad.CustomControls, 4.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package AlfaToad.CustomControls@4.0.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=AlfaToad.CustomControls&version=4.0.0
#tool nuget:?package=AlfaToad.CustomControls&version=4.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
AlfaToad.CustomControls
Библиотека пользовательских контролов для Windows Forms (.NET Framework 4.8 и .NET 8).
Пакет: NuGet — AlfaToad.CustomControls
Компоненты
| Контрол | Назначение |
|---|---|
ScrollableDetailPanel |
Прокручиваемый список строк с фото, полями товара и скидкой |
ScrollableOrderPanel |
Прокручиваемый список строк заказа |
BoundDataGridView |
Таблица с привязкой к DataSet и подсветкой столбца |
Установка
dotnet add package AlfaToad.CustomControls --version 4.0.0
<PackageReference Include="AlfaToad.CustomControls" Version="4.0.0" />
ScrollableDetailPanel — настраиваемые свойства
Поля данных (имена столбцов в DataTable)
| Поле на экране | Свойство | Значение по умолчанию |
|---|---|---|
| Фото | ImageField |
Фото |
| Категория | CategoryField |
Категория товара |
| Наименование | NameField |
Наименование товара |
| Описание | DescriptionField |
Описание товара |
| Производитель | ManufacturerField |
Производитель |
| Поставщик | SupplierField |
Поставщик |
| Цена | PriceField |
Цена |
| Единица измерения | UnitField |
Единица измерения |
| Количество на складе | StockField |
Кол-во на складе |
| Скидка | DiscountField |
Действующая скидка |
Подписи на экране
| Подпись | Свойство | Значение по умолчанию |
|---|---|---|
| Описание | DescriptionCaption |
Описание товара: |
| Производитель | ManufacturerCaption |
Производитель: |
| Поставщик | SupplierCaption |
Поставщик: |
| Цена | PriceCaption |
Цена: |
| Единица измерения | UnitCaption |
Единица измерения: |
| Количество на складе | StockCaption |
Количество на складе: |
| Заголовок столбца скидки | DiscountCaption |
Действующая скидка |
Изображения
| Свойство | Описание |
|---|---|
NoImage |
Картинка при отсутствии файла или пустом поле. По умолчанию не задана — область фото остаётся пустой. |
ImagesFolder |
Папка, из которой загружаются файлы по имени из ImageField. |
Размеры строки
| Свойство | По умолчанию |
|---|---|
RowHeight |
160 |
ImageColumnWidth |
120 |
DiscountColumnWidth |
110 |
ScrollableOrderPanel — настраиваемые свойства
Поля данных
| Поле на экране | Свойство | Значение по умолчанию |
|---|---|---|
| Артикул заказа | ArticleField |
Артикул заказа |
| Статус | StatusField |
Статус заказа |
| Адрес пункта выдачи | AddressField |
Адрес пункта выдачи |
| Дата заказа | OrderDateField |
Дата заказа |
| Дата доставки | DeliveryDateField |
Дата доставки |
Подписи на экране
| Подпись | Свойство | Значение по умолчанию |
|---|---|---|
| Артикул | ArticleCaption |
Артикул заказа |
| Статус | StatusCaption |
Статус заказа |
| Адрес | AddressCaption |
Адрес пункта выдачи |
| Дата заказа | OrderDateCaption |
Дата заказа |
| Дата доставки | DeliveryDateCaption |
Дата доставки |
Размеры строки
| Свойство | По умолчанию |
|---|---|
RowHeight |
110 |
DeliveryColumnWidth |
140 |
BoundDataGridView — настраиваемые свойства
| Свойство | Описание | По умолчанию |
|---|---|---|
HighlightColumnName |
Столбец для подсветки ячеек | Действующая скидка |
ApplyRowHighlight |
Включить подсветку | true |
Appearance |
Палитра цветов | см. ниже |
AppearancePalette — настройка цветов и шрифтов
Общий объект Appearance доступен у всех трёх контролов.
| Свойство | Назначение | По умолчанию |
|---|---|---|
MainBackground |
Основной фон | #FFFFFF |
SectionBackground |
Фон заголовков таблицы | #F5DEB3 |
AccentBackground |
Линии сетки таблицы | #DEB887 |
HighlightBackground |
Подсветка скидки > порога | #FFDEAD |
PrimaryText |
Цвет текста | Black |
SeparatorText |
Цвет разделителя \| |
Gray |
BorderColor |
Рамки строк списка | Black |
FontFamily |
Шрифт | Arial |
BaseFontSize |
Размер обычного текста | 9 |
TitleFontSize |
Размер заголовка строки | 10 |
HighlightThresholdPercent |
Порог подсветки скидки (%) | 17 |
Примеры использования
Список товаров с привязкой к 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");
Список заказов
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/ # пример
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0-windows7.0 is compatible. net9.0-windows was computed. net10.0-windows was computed. |
| .NET Framework | net48 is compatible. net481 was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
.NETFramework 4.8
- No dependencies.
-
net8.0-windows7.0
- No dependencies.
NuGet packages (2)
Showing the top 2 NuGet packages that depend on AlfaToad.CustomControls:
| Package | Downloads |
|---|---|
|
AlfaToad.DataSetCRUDS
Готовые формы добавления и редактирования для ScrollableDetailPanel и ScrollableOrderPanel с привязкой к DataSet. |
|
|
AlfaToad.DefaultScreens
Готовые экранные формы WinForms с ролевым доступом, входом и каталогом на базе AlfaToad.CustomControls и AlfaToad.DataSetCRUDS. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 4.2.10 | 163 | 6/8/2026 |
| 4.2.9 | 112 | 6/8/2026 |
| 4.2.8 | 118 | 6/8/2026 |
| 4.2.7 | 128 | 6/8/2026 |
| 4.2.6 | 141 | 6/8/2026 |
| 4.2.5 | 350 | 6/7/2026 |
| 4.2.4 | 117 | 6/7/2026 |
| 4.2.3 | 133 | 6/7/2026 |
| 4.2.2 | 121 | 6/7/2026 |
| 4.2.1 | 137 | 6/6/2026 |
| 4.2.0 | 113 | 6/6/2026 |
| 4.1.3 | 111 | 6/5/2026 |
| 4.1.2 | 115 | 6/5/2026 |
| 4.1.1 | 120 | 6/5/2026 |
| 4.1.0 | 112 | 6/5/2026 |
| 4.0.0 | 110 | 6/5/2026 |
| 3.0.2 | 104 | 6/5/2026 |
| 3.0.1 | 98 | 6/5/2026 |
| 3.0.0 | 111 | 6/5/2026 |
| 2.0.2 | 116 | 6/4/2026 |
Loading failed