WinFormLoading全方位介绍

一、手动停止

WinFormLoading是WinForm开发中一个非常方便的加载动画组件，不需要设计师的设计图，只需要一个动态的效果即可。同时，WinFormLoading也提供了手动停止的功能，这意味着开发者可以在加载的过程中随时停止动画，从而更好地控制用户的体验。

通过以下代码片段，我们可以手动控制WinFormLoading动画的停止。

    
    //手动停止
    loadingForm.Stop();
    

当我们需要停止动画的时候，只需要调用Stop()方法即可。

二、动画展示

WinFormLoading提供了多种动画展示效果，能够满足不同的应用场景和用户需求。开发者可以根据自己的喜好和项目需要选择合适的展示效果，同时还可以调整颜色、大小等展示参数。

以下代码片段演示了如何使用WinFormLoading，并且呈现了其中的动画效果。

    
    private void showLoading()
    {
        WinFormLoading.LoadingForm loadingForm = new WinFormLoading.LoadingForm();
        loadingForm.Show(this);//在当前窗口按照模态框的方式显示loading
        Thread thread = new Thread(() => //同时开启一个线程执行耗时的操作
        {
            //TODO:请在这里添加耗时操作
            Thread.Sleep(3000);//模拟耗时3秒的操作
            this.Invoke(new Action(() =>
            {
                loadingForm.Stop();//关闭loading
            }));
        });
        thread.Start();
    }
    

通过以上代码段可以看到，在使用WinFormLoading时，我们首先需要创建并展示一个新的WinFormLoading.LoadingForm对象，然后在展示完成后，以线程的方式执行耗时操作。展示过程中，会呈现为一个动态的效果。

三、多颜色设置

WinFormLoading提供了多种颜色的设置方式，开发者可以根据自己项目的需要，灵活地调整颜色等参数。同时，为了方便开发者的快速上手，WinFormLoading还提供了一些默认值。

以下代码演示了如何对WinFormLoading展示的颜色进行自定义设置。

    
    private void showLoading()
    {
        WinFormLoading.LoadingForm loadingForm = new WinFormLoading.LoadingForm();
        loadingForm.LineColor = Color.Gold;//自定义颜色为金色
        loadingForm.BackColor = SystemColors.Control;//背景色设置为默认色
        loadingForm.SizeGripStyle = SizeGripStyle.Hide;//不展示调整大小的框
        loadingForm.ShowInTaskbar = false;//不在任务栏中展示
        loadingForm.Show(this);//在当前窗口按照模态框的方式显示loading
        Thread thread = new Thread(() => //同时开启一个线程执行耗时的操作
        {
            //TODO:请在这里添加耗时操作
            Thread.Sleep(3000);//模拟耗时3秒的操作
            this.Invoke(new Action(() =>
            {
                loadingForm.Stop();//关闭loading
            }));
        });
        thread.Start();
    }
    

以上代码中，我们通过调用WinFormLoading.LoadingForm的各种属性，以达到自定义颜色以及其他参数的目的。

四、动画大小调整

在某些情况下，开发者需要调整loading动画的大小，例如当动画和窗口大小不协调时等等。WinFormLoading提供了调整动画大小的功能，开发者可以根据实际需求进行适当调整。

以下代码演示了如何调整WinFormLoading展示的动画大小。

    
    private void showLoading()
    {
        WinFormLoading.LoadingForm loadingForm = new WinFormLoading.LoadingForm();
        loadingForm.LineWidth = 4;//调整展示线的宽度为4个像素
        loadingForm.LineLength = 30;//设置线的长度为30像素
        loadingForm.InnerCircleRadius = 10;//设置内圆的半径为10像素
        loadingForm.OuterCircleRadius = 18;//设置外圆的半径为18像素
        loadingForm.ShowInTaskbar = false;//不在任务栏中展示
        loadingForm.Show(this);//在当前窗口按照模态框的方式显示loading
        Thread thread = new Thread(() => //同时开启一个线程执行耗时的操作
        {
            //TODO:请在这里添加耗时操作
            Thread.Sleep(3000);//模拟耗时3秒的操作
            this.Invoke(new Action(() =>
            {
                loadingForm.Stop();//关闭loading
            }));
        });
        thread.Start();
    }
    

通过以上的代码演示，我们可以看到，WinFormLoading提供了各种界面调整的参数，我们可以根据具体需要进行灵活的调整。

五、错误处理

在使用WinFormLoading的过程中，有时候会发生一些异常情况，例如线程没有正确关闭、参数设置错误等等，这会影响用户的体验。为了充分保障用户体验，WinFormLoading专门设计了一些错误处理机制，在出现异常情况时能够做出正确的处理。

以下代码演示了如何在异常情况下正确进行处理。

    
    private void showLoading()
    {
        try
        {
            WinFormLoading.LoadingForm loadingForm = new WinFormLoading.LoadingForm();
            //TODO:参数设置等操作
            loadingForm.Show(this);//在当前窗口按照模态框的方式显示loading
            Thread thread = new Thread(() => //同时开启一个线程执行耗时的操作
            {
                try
                {
                    //TODO:请在这里添加耗时操作，包括异常情况下的
                    Thread.Sleep(3000);//模拟耗时3秒的操作
                    this.Invoke(new Action(() =>
                    {
                        loadingForm.Stop();//关闭loading
                    }));
                }
                catch (Exception ex)
                {
                    //TODO:在异常情况下显示错误信息等等，保障用户体验
                }
            });
            thread.Start();
        }
        catch (Exception ex)
        {
            //TODO:在异常情况下显示错误信息等等，保障用户体验
        }

    }
    

通过以上演示代码，我们可以看到，在使用WinFormLoading的过程中，我们不能保证一定不会发生异常情况，因此需要针对异常情况进行正确的处理，保障用户体验。

六、总结

本文详细介绍了WinFormLoading的使用方法及其功能，从手动停止、动画展示、多颜色设置、动画大小调整以及错误处理等多个方面进行讲解，提高了开发者对WinFormLoading的认识和使用技能。