StatusBarKit 8.6.4

StatusBarKit

Умная статусная строка для WinForms-приложений с часами, счетчиком записей, индикатором подключения, сообщениями и прогресс-баром.

Установка

dotnet add package StatusBarKit

Справочник API

Класс SmartStatusBar

SmartStatusBar.Create

public static SmartStatusBar Create(Form form)

Создает статусную строку и добавляет её на форму. Строка содержит: область сообщения, прогресс-бар (скрыт по умолчанию), счетчик записей, статус подключения, имя пользователя и часы (обновляются каждую секунду).

Параметры:

• form — форма, к которой прикрепляется статусная строка.

Возвращает: экземпляр SmartStatusBar для цепочки вызовов.

.SetUser

public SmartStatusBar SetUser(string user)

Устанавливает имя текущего пользователя в статусной строке.

Параметры:

• user — имя пользователя для отображения.

Возвращает: текущий SmartStatusBar.

.SetRecordCount

public SmartStatusBar SetRecordCount(int count)

Устанавливает количество записей. Отображается в формате «Записей: N».

Параметры:

• count — количество записей.

Возвращает: текущий SmartStatusBar.

.SetStatus

public SmartStatusBar SetStatus(string statusText)

Устанавливает статус подключения. Если передана непустая строка — отображается зеленый индикатор с текстом. Если передана пустая строка или null — отображается красный индикатор «Отключено».

Параметры:

• statusText — текст статуса (например, «Подключено к серверу»). Пустая строка переключает в режим «Отключено».

Возвращает: текущий SmartStatusBar.

.SetMessage

public SmartStatusBar SetMessage(string message)

Устанавливает текст сообщения в основной области статусной строки (левая часть, автоматически растягивается).

Параметры:

• message — текст сообщения.

Возвращает: текущий SmartStatusBar.

.SetProgress

public SmartStatusBar SetProgress(int percent)

Устанавливает значение прогресса и делает прогресс-бар видимым. Значение ограничивается диапазоном 0-100.

Параметры:

• percent — процент выполнения (0-100).

Возвращает: текущий SmartStatusBar.

.ShowProgress

public SmartStatusBar ShowProgress()

Показывает прогресс-бар (делает его видимым без изменения текущего значения).

Возвращает: текущий SmartStatusBar.

.HideProgress

public SmartStatusBar HideProgress()

Скрывает прогресс-бар и сбрасывает его значение на 0.

Возвращает: текущий SmartStatusBar.

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

Пример 1: Туристическое агентство

using StatusBarKit;

private SmartStatusBar _statusBar;

private void MainForm_Load(object sender, EventArgs e)
{
    _statusBar = SmartStatusBar.Create(this)
        .SetUser("Иванова А.М.")
        .SetStatus("Подключено к серверу бронирования")
        .SetRecordCount(47)
        .SetMessage("Готово");
}

private async void btnLoadTours_Click(object sender, EventArgs e)
{
    _statusBar.SetMessage("Загрузка туров...");
    _statusBar.SetProgress(0);

    for (int i = 0; i <= 100; i += 10)
    {
        _statusBar.SetProgress(i);
        await Task.Delay(100);
    }

    _statusBar.SetMessage("Загружено 47 туров");
    _statusBar.HideProgress();
}

Пример 2: Складская система

using StatusBarKit;

private SmartStatusBar _statusBar;

private void MainForm_Load(object sender, EventArgs e)
{
    _statusBar = SmartStatusBar.Create(this)
        .SetUser("Кладовщик: Петров С.В.")
        .SetStatus("Склад #3")
        .SetMessage("Готово");
}

private void UpdateGrid()
{
    var items = LoadWarehouseItems(filter);
    grid.DataSource = items;
    _statusBar.SetRecordCount(items.Count);
    _statusBar.SetMessage($"Показано {items.Count} позиций");
}

private void OnConnectionLost()
{
    _statusBar.SetStatus("");
    _statusBar.SetMessage("Соединение с базой данных потеряно");
}

Пример 3: Банковская система с прогрессом импорта

using StatusBarKit;

private SmartStatusBar _statusBar;

private void MainForm_Load(object sender, EventArgs e)
{
    _statusBar = SmartStatusBar.Create(this)
        .SetUser("Оператор: Сидорова Е.К.")
        .SetStatus("Центральный офис")
        .SetRecordCount(0);
}

private void ImportStatements(List<Statement> statements)
{
    _statusBar.SetMessage("Импорт банковских выписок...");
    _statusBar.ShowProgress();

    for (int i = 0; i < statements.Count; i++)
    {
        ProcessStatement(statements[i]);
        int percent = (int)((i + 1.0) / statements.Count * 100);
        _statusBar.SetProgress(percent);
    }

    _statusBar.HideProgress();
    _statusBar.SetRecordCount(statements.Count);
    _statusBar.SetMessage($"Импортировано {statements.Count} выписок");
}