C# 扩展PdfiumViewer工具栏：实现页面导航与动态缩放的高级自定义

1. 从零开始：为什么我们需要自定义PdfiumViewer工具栏？

如果你用过PdfiumViewer这个控件，肯定对它的默认工具栏又爱又恨。爱的是，它确实能打开PDF，基础的放大缩小、打印保存功能都有，开箱即用。恨的是，功能实在太基础了，想跳转到第50页？想快速回到首页或者跳到最后一页？对不起，没有。你得用鼠标在滚动条上拖来拖去，或者用键盘的PageUp/PageDown一点点翻，在阅读几十上百页的文档时，这种体验简直让人抓狂。我自己在做内部文档管理系统的时候就遇到过这个问题，用户反馈说：“这阅读器怎么连个页码跳转都没有？” 所以，今天我们就来彻底解决它，手把手教你如何给PdfiumViewer的工具栏“动手术”，加上我们梦寐以求的页面导航和智能缩放功能。

这个过程本质上就是一次WinForm控件的深度定制。PdfiumViewer本身是一个优秀的开源组件，它把复杂的PDF渲染内核（pdfium）封装成了C#里易于使用的控件。但它的设计哲学是提供核心的渲染能力，把更多的交互定制权交给了开发者。这既是挑战也是机会。挑战在于，你需要自己去理解它的内部结构，比如PdfRenderer这个核心的渲染器对象；机会在于，你可以完全按照自己应用的业务逻辑，打造出体验一流的PDF阅读界面。我们这次要实现的，就是一套在专业PDF阅读软件里常见的工具栏：首页、尾页、上一页、下一页、页码输入框、动态比例缩放下拉框，以及实时显示当前页码。做完之后，你的应用在PDF浏览体验上会有一个质的飞跃。

2. 搭建舞台：创建项目与界面布局

万事开头难，我们先从创建一个干净的WinForm项目开始。打开Visual Studio，新建一个Windows窗体应用（.NET Framework或者.NET Core/6+都行，PdfiumViewer对两者都支持良好）。我给项目起名叫PdfViewerEnhanced。创建好后，第一件事就是通过NuGet包管理器把PdfiumViewer引进来。在解决方案资源管理器里右键点击项目，选择“管理NuGet程序包”，浏览里搜索“PdfiumViewer”，安装它。安装时注意，它可能会自动带上依赖项“PdfiumViewer.Native”，这个包包含了必要的pdfium.dll本地库，非常重要。

接下来设计主窗体。我的习惯是，先把窗体拉大一点，比如调到800x600。然后从工具箱里拖一个ToolStrip控件到窗体上，它会默认停靠在顶部。这就是我们自定义工具栏的“画布”。紧接着，拖一个PdfiumViewer控件到窗体上，在属性面板里找到Dock属性，把它设置为Fill，这样它就会填满工具栏剩余的所有空间，实现自适应布局。我通常会把PdfiumViewer实例的名字从默认的pdfiumViewer1改成更简单的pdfViewer，写代码时更顺手。

现在，开始往ToolStrip里“塞”按钮和控件。这是最体现细心的地方。我按照阅读的逻辑顺序从左到右添加：

1. 打印预览按钮 (ToolStripButton)：Name设为btnPrint，Text设为“打印”，可以找个打印机图标。
2. 放大按钮 (ToolStripButton)：Name=btnZoomIn，Text=“放大”或“+”。
3. 缩放比例下拉框 (ToolStripComboBox)：Name=cboZoom。这是实现智能缩放的关键。我们需要在窗体加载时，给它添加一些预设项，比如“25%”, “50%”, “75%”, “100%”, “150%”, “200%”, “适合宽度”, “适合页面”。后面我们会把它的SelectedIndexChanged事件和实际的缩放操作绑定起来。
4. 缩小按钮 (ToolStripButton)：Name=btnZoomOut，Text=“缩小”或“-”。
5. 一个分隔符 (ToolStripSeparator)，用来把缩放和翻页功能区分开。
6. 首页按钮 (ToolStripButton)：Name=btnFirstPage，Text=“首页”。
7. 上一页按钮 (ToolStripButton)：Name=btnPrevPage，Text=“上一页”。
8. 页码输入框 (ToolStripTextBox)：Name=txtPageNumber。这里有个关键点，要把它的Size属性宽度调小一点，比如80像素，只够输入数字就行。我们还需要处理它的KeyPress事件，当用户按下回车时执行跳转。
9. 页码显示标签 (ToolStripLabel)：Name=lblPageStatus。Text可以初始化为“/”。我们将用它显示“当前页/总页数”的格式，比如“5/120”。
10. 下一页按钮 (ToolStripButton)：Name=btnNextPage，Text=“下一页”。
11. 尾页按钮 (ToolStripButton)：Name=btnLastPage，Text=“尾页”。
12. 再来一个分隔符。
13. 全屏按钮 (ToolStripButton)：Name=btnFullScreen，Text=“全屏”。

界面摆好之后，别急着写代码。先在窗体类里声明几个关键的全局变量，它们会在多个方法里用到：

private PdfDocument _currentDocument; // 当前加载的PDF文档对象
private int _totalPageCount = 0; // 文档总页数
private bool _isFullScreenMode = false; // 是否处于全屏模式
private FormWindowState _previousWin