当前位置：首页 > news >正文

在 WPF 启动界面中心加载 GIF 动图

news 2025/7/22 7:35:20

在 WPF 启动界面中心加载 GIF 动图

在 WPF 启动界面中心加载 GIF 动图可以通过多种方式实现。下面我将提供一个完整的解决方案，包括使用第三方库和纯 WPF 实现两种方法。

方法一：使用 WpfAnimatedGif 库（推荐）

这是最简单可靠的方法，使用专门处理 GIF 动画的库。

实现步骤：

安装 NuGet 包
```
Install-Package WpfAnimatedGif
```
创建启动窗口 (SplashScreen.xaml)

<Window x:Class="YourNamespace.SplashScreen"xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"xmlns:gif="http://wpfanimatedgif.codeplex.com"WindowStyle="None" AllowsTransparency="True"Background="Transparent"WindowStartupLocation="CenterScreen"Width="400" Height="400"><Grid><!-- 背景 --><Border CornerRadius="20" Background="#1E1E1E" Opacity="0.9"BorderBrush="#3F3F46" BorderThickness="1"><!-- 阴影效果 --><Border.Effect><DropShadowEffect BlurRadius="20" ShadowDepth="0" Color="#000000" Opacity="0.5"/></Border.Effect></Border><!-- 中心 GIF 动画 --><Image x:Name="LoadingGif" gif:ImageBehavior.AnimatedSource="/Assets/loading.gif"gif:ImageBehavior.AutoStart="True"Width="200" Height="200"HorizontalAlignment="Center" VerticalAlignment="Center"/><!-- 状态文本 --><TextBlock x:Name="StatusText" Text="正在加载..." Foreground="#E0E0E0" FontSize="16"HorizontalAlignment="Center" VerticalAlignment="Bottom"Margin="0,0,0,30"/></Grid>
</Window>

在代码中更新状态文本 (SplashScreen.xaml.cs)

using System.Windows;namespace YourNamespace
{public partial class SplashScreen : Window{public SplashScreen(){InitializeComponent();}// 更新状态文本的方法public void UpdateStatus(string message){StatusText.Text = message;}}
}

在 App.xaml.cs 中使用启动窗口

using System;
using System.Threading.Tasks;
using System.Windows;namespace YourNamespace
{public partial class App : Application{private SplashScreen _splashScreen;protected override void OnStartup(StartupEventArgs e){base.OnStartup(e);// 创建并显示启动窗口_splashScreen = new SplashScreen();_splashScreen.Show();// 异步初始化应用Task.Run(() => InitializeApplication()).ContinueWith(t => {// 初始化完成后切换到主界面Dispatcher.Invoke(() => SwitchToMainWindow());}, TaskScheduler.FromCurrentSynchronizationContext());}private void InitializeApplication(){// 更新状态信息UpdateSplashStatus("正在加载配置...");Task.Delay(800).Wait();UpdateSplashStatus("正在初始化数据库...");Task.Delay(1200).Wait();UpdateSplashStatus("正在准备界面...");Task.Delay(600).Wait();}private void UpdateSplashStatus(string message){Dispatcher.Invoke(() => {if (_splashScreen != null){_splashScreen.UpdateStatus(message);}});}private void SwitchToMainWindow(){// 创建主窗口var mainWindow = new MainWindow();// 关闭启动窗口_splashScreen.Close();_splashScreen = null;// 显示主窗口mainWindow.Show();}}
}

修改 App.xaml

<Application x:Class="YourNamespace.App"xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"Startup="Application_Startup"ShutdownMode="OnExplicitShutdown">
</Application>

优化建议

1. 添加淡入淡出效果

在切换窗口时添加平滑的动画效果：

private void SwitchToMainWindow()
{// 创建主窗口但不立即显示var mainWindow = new MainWindow();mainWindow.Opacity = 0;// 启动窗口淡出var fadeOut = new DoubleAnimation(0, TimeSpan.FromSeconds(0.5));fadeOut.Completed += (s, e) => {_splashScreen.Close();_splashScreen = null;// 主窗口淡入mainWindow.Show();var fadeIn = new DoubleAnimation(1, TimeSpan.FromSeconds(0.5));mainWindow.BeginAnimation(Window.OpacityProperty, fadeIn);};_splashScreen.BeginAnimation(Window.OpacityProperty, fadeOut);
}

2. 处理 GIF 资源加载问题

确保 GIF 文件设置为资源：

在项目资源管理器中右键点击 GIF 文件
选择"属性"
设置"生成操作"为"Resource"

3. 添加加载进度指示器

<Grid><!-- ... 其他元素 ... --><!-- 圆形进度条 --><ProgressBar x:Name="LoadingProgress" Value="0" Minimum="0" Maximum="100"Height="6" Width="300"HorizontalAlignment="Center" VerticalAlignment="Bottom"Margin="0,0,0,60"Foreground="#0EA5E9"><ProgressBar.Template><ControlTemplate TargetType="ProgressBar"><Grid><Border CornerRadius="3" Background="#3F3F46" BorderThickness="0" Height="6"/><Border CornerRadius="3" Background="#0EA5E9" BorderThickness="0" Height="6"HorizontalAlignment="Left"Width="{TemplateBinding Value}"/></Grid></ControlTemplate></ProgressBar.Template></ProgressBar>
</Grid>

在代码中更新进度：

// 在 SplashScreen 中添加
public void UpdateProgress(int value)
{LoadingProgress.Value = value;
}// 在 App.xaml.cs 中
private void InitializeApplication()
{UpdateProgress(10);UpdateSplashStatus("正在加载配置...");Task.Delay(800).Wait();UpdateProgress(40);UpdateSplashStatus("正在初始化数据库...");Task.Delay(1200).Wait();UpdateProgress(80);UpdateSplashStatus("正在准备界面...");Task.Delay(600).Wait();UpdateProgress(100);
}private void UpdateProgress(int value)
{Dispatcher.Invoke(() => {if (_splashScreen != null){_splashScreen.UpdateProgress(value);}});
}

常见问题解决方案

1. GIF 不显示或不动

确保 GIF 文件路径正确
检查 GIF 文件属性设置为"Resource"
尝试使用完整资源路径：pack://application:,,,/YourAppName;component/Assets/loading.gif
确保 GIF 不是单帧图像

2. 启动界面位置不居中

设置 WindowStartupLocation="CenterScreen"
确保启动窗口没有设置 Left 和 Top 属性

3. 背景不透明

确保 AllowsTransparency="True"
设置 Background="Transparent"
移除窗口边框：WindowStyle="None"

4. 内存泄漏

在关闭窗口时停止动画：

protected override void OnClosed(EventArgs e)
{base.OnClosed(e);// 停止 GIF 动画if (gifBehavior != null){ImageBehavior.SetAnimatedSource(LoadingGif, null);}// 清除资源LoadingGif.Source = null;LoadingGif = null;
}

5. 多显示器支持

public SplashScreen()
{InitializeComponent();// 在屏幕中心显示var screen = System.Windows.Forms.Screen.PrimaryScreen;var screenWidth = screen.Bounds.Width;var screenHeight = screen.Bounds.Height;Left = (screenWidth - Width) / 2;Top = (screenHeight - Height) / 2;
}