Siticone Download Button

// Initiates an asynchronous file download from a URL.
// Handles HTTP requests, file creation, and progress reporting automatically.
await btnDownload.StartWebDownloadAsync("https://file.zip", "C:\\Downloads\\file.zip");

// Connects the button to a generic Task that reports progress.
// Useful for database syncs or non-file operations.
await btnDownload.AttachToAsyncOperation(MyLongRunningTask, "Syncing Data");

// Manually sets the progress and state in one optimized call.
// Bypasses auto-management logic for external control.
btnDownload.SetProgressAndState(50f, DownloadState.Downloading);

// Cancels any active operation and resets the UI immediately.
btnDownload.CancelDownloadAndReset();

// Simulates a fake download for UI testing.
await btnDownload.SimulateDownload(5, "demo_file.exe");

// Updates progress without changing the state logic.
btnDownload.SetProgressWithoutStateChange(75f);

// Manually triggers the error state visualization.
btnDownload.SetError("Connection lost");

private async void BtnDownload_Click(object sender, EventArgs e)
{
                try
    {
                string url = "https://example.com/installer.msi";
                string path = @"C:\Downloads\installer.msi";

                // Configure for file download
        btnDownload.CompletionAction = DownloadCompletionAction.Notify;
        btnDownload.NotificationTitle = "Download Success";
        btnDownload.NotificationContent = "Installer saved to C:\Downloads";

                // Start the operation
                await btnDownload.StartWebDownloadAsync(url, path);
    }
                catch (Exception ex)
    {
                // Handle startup errors
                MessageBox.Show(ex.Message);
    }
}

private async void BtnSync_Click(object sender, EventArgs e)
{
    btnDownload.DownloadText = "Syncing Database...";

                // Define a task that reports progress
                Func<IProgress<float>, CancellationToken, Task> syncTask = 
                async (progressReporter, token) =>
    {
                for (int i = 0; i <= 100; i += 5)
        {
                // Support cancellation via button click
            token.ThrowIfCancellationRequested();

                // Simulate work
                await Task.Delay(100);

                // Update button progress
            progressReporter.Report(i);
        }
    };

                // Attach the task to the button
                await btnDownload.AttachToAsyncOperation(syncTask, "DB Sync");
}

// 1. Disable auto-management to take full control
btnDownload.AutoManageStateByProgress = false;

void OnExternalDownloadStarted()
{
    btnDownload.DownloadState = DownloadState.Downloading;
}

void OnExternalProgressChanged(int percentage)
{
                // Update progress visual without triggering state logic
    btnDownload.SetProgressWithoutStateChange(percentage);
}

void OnExternalDownloadFinished()
{
    btnDownload.DownloadState = DownloadState.Completed;
                // Manually trigger completion logic
    btnDownload.CompleteDownload();
}

private void ApplyModernTheme()
{
                var btn = siticoneDownloadButton1;
    
                // Enable Gradients
    btn.EnableGradient = true;
    btn.GradientAngle = 45f;
    
                // Idle State: Indigo Gradient
    btn.IdleColor = Color.FromArgb(99, 102, 241);
    btn.IdleColor2 = Color.FromArgb(67, 56, 202);

                // Downloading State: Blue Gradient
    btn.DownloadingColor = Color.FromArgb(59, 130, 246);
    btn.DownloadingColor2 = Color.FromArgb(37, 99, 235);

                // Completed State: Emerald Gradient
    btn.CompletedColor = Color.FromArgb(16, 185, 129);
    btn.CompletedColor2 = Color.FromArgb(5, 150, 105);

                // Text Styling
    btn.EnableTextShadow = true;
    btn.TextShadowColor = Color.FromArgb(50, 0, 0, 0);
    btn.CornerRadius = 25;
}