基於DevExpress實現對PDF、Word、Excel文檔的預覽及操作處理

在一般的管理系統模塊里面，越來越多的設計到一些常用文檔的上傳保存操作，其中如PDF、Word、Excel等文檔，有時候是通過分布式的WCF技術實現數據的顯示和處理，因此希望直接預覽而不需要下載文件，這樣能夠給我們提供很多的方便。在DevExpress里面，提供了相應的控件來顯示和處理這些文檔，本文主要介紹如何利用DevExpress的控件實現對PDF、Word、Excel文檔的預覽和操作處理。

1、PDF的預覽和操作

在較早的DevExpress的控件里面，已經提供了對應的PDF文檔的顯示控件，不過由於其對PDF格式支持不是很好，有些文檔是Office導出的，也不是很正常閱讀，因此很少使用，本文介紹的DevExpress的PDF查看控件是基於14.1的，測試過很多文檔，好像都能正常打開，因此也想在系統中廣泛使用了。

為了演示這些控件的處理，我單獨編寫了一個例子，用來實現對PDF、Word、Excel等文檔的處理。

為了顯示PDF文檔，我們需要在界面里面添加一個XtraPdfViewer.PdfViewer的控件，這個主要是用來顯示PDF的，它有很多屬性方法，用來實現對PDF的處理操作，測試界面設計好如下所示。

對PDF，我們一般主要是用來打開文件，另存為，或者預覽就可以了。相關的操作代碼如下所示。

    /// <summary>
    /// PDF測試顯示窗體
    /// </summary>
    public partial class PDFViewer : Form
    {
        //記錄窗體的名稱
        readonly string mainFormText;

        public PDFViewer()
        {
            InitializeComponent();

            //記錄窗體的名稱，並實現文檔變化事件的處理，方便顯示新的文件名稱
            mainFormText = this.Text;
            pdfViewer1.DocumentChanged += new DevExpress.XtraPdfViewer.PdfDocumentChangedEventHandler(pdfViewer1_DocumentChanged);
        }

        /// <summary>
        /// PDF文檔變化后，實現對新文件名稱的顯示
        /// </summary>
        void pdfViewer1_DocumentChanged(object sender, DevExpress.XtraPdfViewer.PdfDocumentChangedEventArgs e)
        {
            string fileName = Path.GetFileName(e.DocumentFilePath);
            if (String.IsNullOrEmpty(fileName))
            {
                Text = mainFormText;
            }
            else
            {
                Text = fileName + " - " + mainFormText;
            }
        }

        /// <summary>
        /// 打開PDF文件
        /// </summary>
        private void btnOpenFile_Click(object sender, EventArgs e)
        {
            string filePath = FileDialogHelper.OpenPdf();
            if (!string.IsNullOrEmpty(filePath))
            {
                this.pdfViewer1.LoadDocument(filePath);
            }
        }

        /// <summary>
        /// 另存為PDF文件
        /// </summary>
        private void btnSaveAs_Click(object sender, EventArgs e)
        {
            string dir = System.Environment.CurrentDirectory;
            string filePath = FileDialogHelper.SavePdf("", dir);
            if (!string.IsNullOrEmpty(filePath))
            {
                try
                {
                    this.pdfViewer1.SaveDocument(filePath);
                    MessageUtil.ShowTips("保存成功");
                }
                catch (Exception ex)
                {
                    LogTextHelper.Error(ex);
                    MessageUtil.ShowError(ex.Message);
                }
            }
        }

        /// <summary>
        /// PDF文件打印
        /// </summary>
        private void btnPreview_Click(object sender, EventArgs e)
        {
            this.pdfViewer1.Print();
        }
    }

從上面的代碼，我們可以看到，對於PDF，我們操作起來很方便，主要就是在界面里面加載文件后，就可以對PDFViewer對象實現相關的操作了。

 

2、WORD文檔的預覽和操作

類似於PDF文檔，我們對WORD文檔，也是通過使用RichEditControl實現文檔的顯示，不過和PDFViewer不同，這個控件可以實現對文檔的修改和保存操作，這種對於我們提供用戶對文檔進行編輯很方便。

測試例子的界面如下所示。

相關的操作代碼，也和PDF的操作類似，不同的是，它在文檔變化后，不能很容易從參數里面獲取到對應的文檔的路徑，需要特殊的處理才能得到。

    /// <summary>
    /// WORD控件的測試例子
    /// </summary>
    public partial class WordViewer : Form
    {
        //記錄窗體的名稱
        readonly string mainFormText;

        public WordViewer()
        {
            InitializeComponent();

            //記錄窗體的名稱，並實現文檔變化事件的處理，方便顯示新的文件名稱
            mainFormText = this.Text;
            this.richEditControl1.DocumentLoaded += new EventHandler(richEditControl1_DocumentLoaded);
        }

        /// <summary>
        /// WORD文檔變化后，實現對新文件名稱的顯示
        /// </summary>
        void richEditControl1_DocumentLoaded(object sender, EventArgs e)
        {
            string fileName = Path.GetFileName(this.richEditControl1.Options.DocumentSaveOptions.CurrentFileName);
            if (String.IsNullOrEmpty(fileName))
            {
                Text = mainFormText;
            }
            else
            {
                Text = fileName + " - " + mainFormText;
            }

            //修改默認字體
            DocumentRange range = richEditControl1.Document.Range;
            CharacterProperties cp = this.richEditControl1.Document.BeginUpdateCharacters(range);
            cp.FontName = "新宋體";
            //cp.FontSize = 12;
            this.richEditControl1.Document.EndUpdateCharacters(cp);
        }

        /// <summary>
        /// 打開WORD文件
        /// </summary>
        private void btnOpenFile_Click(object sender, EventArgs e)
        {
            string filePath = FileDialogHelper.OpenWord();
            if (!string.IsNullOrEmpty(filePath))
            {
                richEditControl1.LoadDocument(filePath);//, DocumentFormat.Doc);
            }
        }

        /// <summary>
        /// 保存WORD文件
        /// </summary>
        private void btnSaveFile_Click(object sender, EventArgs e)
        {
            this.richEditControl1.SaveDocument();
        }

        /// <summary>
        /// 另存為WORD文件
        /// </summary>
        private void btnSaveAs_Click(object sender, EventArgs e)
        {
            try
            {
                richEditControl1.SaveDocumentAs();
                MessageUtil.ShowTips("保存成功");
            }
            catch (Exception ex)
            {
                LogTextHelper.Error(ex);
                MessageUtil.ShowError(ex.Message);
            }
        }

        /// <summary>
        /// WORD文件打印
        /// </summary>
        private void btnPreview_Click(object sender, EventArgs e)
        {
            this.richEditControl1.ShowPrintPreview();
        }
    }

加載文檔后，界面顯示內容如下所示：

文檔控件很容易支持打印預覽功能，打印預覽的界面如下所示

不過話說回來，這個RichEditControl雖然能夠較好顯示Word文檔，不過也有一些字體顯示的不是很好，格式和微軟的Word軟件顯示的有些不太一樣，格式有所損失。

因此如果對於格式要求比較嚴謹的，建議還是只是做顯示為佳，不要保存原有的文檔。如果對格式不是特別嚴格，倒是可以作為一個文檔服務器實現文檔的新建、保存處理。

 

3、Excel文檔的預覽和操作

對於Excel文檔的預覽和操作，DevExpress控件在最近版本中增加的XtraSpreadsheet.SpreadsheetControl控件就可以實現Excel的顯示和處理操作，這個控件很強大，可以處理很復雜格式的Excel文檔，雖然我原來使用了另外一個FarPoint Spread控件組，不過這個XtraSpreadsheet控件組，如果集成在DevExpress也就很方便了。

這個DevExpress的控件，可以在其中進行Excel的新建、保存、打印預覽等操作，當然也可以打開我們已有的Excel文件了。

打開文件后，界面效果如下所示。

界面的相關功能操作代碼如下所示。

    /// <summary>
    /// Excel控件的測試例子
    /// </summary>
    public partial class ExcelViewer : Form
    {
        //記錄窗體的名稱
        readonly string mainFormText;

        public ExcelViewer()
        {
            InitializeComponent();

            //記錄窗體的名稱，並實現文檔變化事件的處理，方便顯示新的文件名稱
            mainFormText = this.Text;
            this.spreadsheetControl1.DocumentLoaded += new EventHandler(spreadsheetControl1_DocumentLoaded);
        }

        /// <summary>
        /// 文檔變化后，實現對新文件名稱的顯示
        /// </summary>
        void spreadsheetControl1_DocumentLoaded(object sender, EventArgs e)
        {
            string fileName = Path.GetFileName(this.spreadsheetControl1.Document.Path);
            if (String.IsNullOrEmpty(fileName))
            {
                Text = mainFormText;
            }
            else
            {
                Text = fileName + " - " + mainFormText;
            }
        }

        /// <summary>
        /// 打開Excel文件
        /// </summary>
        private void btnOpenFile_Click(object sender, EventArgs e)
        { 
            string filePath = FileDialogHelper.OpenExcel();
            if (!string.IsNullOrEmpty(filePath))
            {
                IWorkbook workbook = spreadsheetControl1.Document;
                workbook.LoadDocument(filePath);
            }
        }

        /// <summary>
        /// 保存Excel文件
        /// </summary>
        private void btnSaveFile_Click(object sender, EventArgs e)
        {
            spreadsheetControl1.SaveDocument();
        }

        /// <summary>
        /// 另存為Excel文件
        /// </summary>
        private void btnSaveAs_Click(object sender, EventArgs e)
        {
            string dir = System.Environment.CurrentDirectory;
            string filePath = FileDialogHelper.SaveExcel("", dir);
            if (!string.IsNullOrEmpty(filePath))
            {
                try
                {
                    IWorkbook workbook = spreadsheetControl1.Document;
                    workbook.SaveDocument(filePath);

                    MessageUtil.ShowTips("保存成功");
                }
                catch (Exception ex)
                {
                    LogTextHelper.Error(ex);
                    MessageUtil.ShowError(ex.Message);
                }
            }
        }

        /// <summary>
        /// Excel文件打印
        /// </summary>
        private void btnPreview_Click(object sender, EventArgs e)
        {
            this.spreadsheetControl1.ShowPrintPreview();
        }
    }

 

預覽也很方便，和Word的預覽操作類似。

 

以上就是幾個常用文檔的顯示和操作案例，有了這些我們很容易整合到我們的附件管理里面了。

如我在我的《Winform開發框架》、《混合式開發框架里面》使用的通用附件管理模塊，就是基於這些特點，實現圖片、Excel文檔、Word文檔和PDF等文檔的在線預覽和管理操作，界面截圖如下所示。