Spread for WinForms 表格控件客户问题实战

产品网站：                                        1 of 88                                       Spread for WinForms 表格控件 客户问题实战   产品网站：                                        2 of 88 目录  1. 安装 Spread for WinForms . 4 2. 添加 Spread 控件到 Microsoft Visual Studio 工具箱  . 4 3. 激活 Spread for WinForms 表格控件  . 4 4. 部署  . 6 5. 升级产品  . 8 6. 单元格类型  . 8 7. 单元格交互  . 24 8. 边框及网格线设置  . 30 9. 行列交互  . 36 10. 表单交互  . 39 11. 排序  . 42 12. 过滤  . 44 13. 数据搜索  . 46 14. 数据绑定  . 47 15. 数据可视化  . 50 图表  . 50 Shape . 57 波形图  . 61 条件格式化  . 62 16. 大纲分组  . 63 17. Outlook 分组  . 64 18. 级联显示  . 66 19. 公式  . 68 20. 打印  . 72 21. 键盘动作映射  . 74  产品网站：                                        3 of 88 22. 剪切板操作  . 76 23. 鼠标交互  . 77 24. 文件交互  . 80 Excel 导出  . 80 Excel 导入  . 83 25. 皮肤  . 84 26. 如何调用设计器  . 86 27. 汉化  . 87 28. 本文档所有示例下载地址  . 88                              产品网站：                                        4 of 88 1. 安装 Spread for WinForms 安装  Spread for WinForms 产品步骤 如下：  1) 保存下载的 ZIP 文件到临时目录，解压该文件到临时目录。   2) 如 已经 安装试用版或旧版本，运行该版本控件的安装文件并按照提示进行卸载 （卸载 前请通过  LicenseManager 反 激活） ，否则进行第 4 步。   3) 重新打开安装文件夹。   4) 运行 SpreadWin(Bits 控件 安装包 ) 或  SpreadWin(Docs 文档 安装包 )。   5) 点击欢迎界面的 下一步 。   6) 在许可协议界面上，选择是否同意协议，若同意，点击 下一步 。   7) 选择需要安装 的 控件， 点击 下一步 ：  8) 继续执行安装步骤， 直至 点击 “ 完成 ” 按钮 确认安装完成。   注意：   如果 安装 系统为 Microsoft Windows Vista 或更高版本 ， 你需要使用 管理员权限安装 。如果 仍然无法安装 ，请 尝试请 禁用使用者帐户控 制 (UAC) 后 再次安装。   Spread for WinForms：  Microsoft 已经告知 MSN Messenger 会 锁定 GAC， 这样就会阻止安装程序移除 GAC 中的旧版本程序集。  2. 添加 Spread 控件 到 Microsoft Visual Studio 工具箱  在 Microsoft Visual Studio 使用 Spread 表格控件 ， 你需要添加 控件到 工具箱，操作步骤如下：  1) 如果工具箱 没有显示 ，在 Visual Studio 视图 菜单中选择 “工具箱” 。  2) 右键 点击工具箱，在弹出的菜单项中 点击  “选择项”  选项。  3) 在选择 工具箱对话框中 ， 选择 “.NET Framework 组件 ” 选项卡 。  4) 在 “.NET Framework 组件 ” 选项卡 中，  Spread 控件（ FarPoint.Win.Spread 命名空间 ） 应该已经在列表中。  5) 勾选 FpSpread 控件点击 “确认” 按钮。  6) 如果 Spread 表格 控件没有显示在列表中，点击 “ 浏览 ” 按钮，在安装文件夹下选择FarPoint.Win.Spread.dll 后 点击打开 。 这时 Spread 表格 控件被添加到列表中 ， 勾选后点击 “确认” 按钮 。  3. 激活 Spread for WinForms 表格 控件  可以 通过以下步骤激活 Spread 表格 控件：  1) 运行 葡萄城许可证管理工具 （开始 菜单 ->所有 程序 ->ComponentOne->License Manager） 。   产品网站：                                        5 of 88  2) 在弹出 的界面上 点击 “ 激活 ” 链接。  3) 激活 产品建的界面上点击 “ 下一步 ” 。   4) 在输入 产品键界面输入 产品键 等使用信息 点击“ 下一步 ” 按钮。   产品网站：                                        6 of 88  5) 激活 成功界面点击 “完成” 按钮确认激活完毕。   4. 部署  系统要 求  您的系统必须满足以下配置要求：   Microsoft Windows 98   Microsoft Windows 98 SE   Microsoft Windows ME   Microsoft Windows 2000 (SP3)   Microsoft Windows Server 2003   Microsoft Windows Server 2008   Microsoft Windows XP (SP2)   Microsoft Windows Vista   Microsoft Windows 7   Microsoft Windows 8  软件 要求  必须安装 Microsoft .NET 平台。   产品网站：                                        7 of 88  部署文 件  您必须在用户系统中部署下列文件：  下列程序集是与  Spread for Windows Forms 一起提供的：   FarPoint.CalcEngine.dll   FarPoint.Excel.dll   FarPoint.PluginCalendar.WinForms.dll   FarPoint.Win.dll   FarPoint.Win.Spread.dll   FarPoint.Localization.dll  安装应用程序必须从  Spread for Windows Forms 目录复制这些程序集到应用程序的可执行文件目录下或者把他们安装到全局程序集缓存中  (GAC)。了解 GAC 信息，请参照 Microsoft Visual Studio .NET 和  .NET 平台文档。   .NET 平台可在发行组件包，如果用户系统上没有 .NET 平台，关于软件包的更多信息，参照 .NET平台文档。   如果您要使用高级  ink 您需要同时部署  FarPoint.Win.Ink.dll。这些程序集到应用程序的可执行文件目录下或者把他们安装到全局程序集缓存中  (GAC)。这也需要 Microsoft Tablet PC SDK 运行是组件。  FarPoint.Win.Ink 程序集是基于  Microsoft Tablet PC SDK 1.7 版本编译的。   如果在您的工程中应用了文本编辑器功能那么您需要部署 FarPoint.Win.TextRenderer.dll。这个  DLL 需要和应用程序的可执行文件安装在统一文件夹下。这个特性只在 .NET 2.0 平台下使用。   如果在您的工程中应用了导出 PDF 格式的功能那么您同样需要部署 FarPoint.PDF.dll。   如果在您的工程中应用了导出 HTML 格式的功能那么您需要同时部署FarPoint.Win.Spread.Html.dll 和  System.Web.dll。   如果在运行时使用了 Spread 设计器那么您需要部署 FarPoint.Win.Spread.Design.dll。   如果在您的工程中应用了图表控件您需要部署 FarPoint.Win.Chart.dll。   如果 在您的工程中应用了 GcTextBox 或 GcDateTime 您需要 部署 GrapeCity.Win.PluginInputMan.dll。  托管网页上的控 制  如果您将  Spread for Windows Forms 控件作为用户控件托管在 Microsoft Internet Explorer (IE) 一个网页上，调整下列安全权限：   在 IE 中，选择工具 ->Internet 选项 ->安全并选择可信任站点。点击网站按钮并添加网站 (例如  http:/localhost)。   产品网站：                                        8 of 88 在 Windows 中，选择开始 ->设置 ->控制面板并选择管理工具。选择  Microsoft .NET 框架配置。在  .NET 平台配置窗体，选择运行库安全策略并点击调整区域安全。  5. 升级产品  升级 Visual Studio .NET 工具箱  对于 新的工程 ，您需要 移除工具箱中的现有 Spread 控件，再 添加新的 Spread 控件。  1) 如果工具箱 没有显示 ，在 Visual Studio 视图 菜单中选择 “工具箱 ” 。  2) 右键 点击工具箱，在弹出的菜单项中 点击“选择项 ” 选项。  3) 在选择 工具箱对话框中 ， 选择 “.NET Framework 组件 ” 选项卡 。  4) 在 “.NET Framework 组件 ” 选项卡 中，  Spread 控件（ FarPoint.Win.Spread 命名空间 ） 应该已经在列表中。  5) 勾选 FpSpread 控件点击 “ 确认 ” 按钮。  6) 如果 Spread 表格 控件没有显示在列表中，点击 “ 浏览 ” 按钮，在安装文件夹下选择FarPoint.Win.Spread.dll 后 点击打开 。 这时 Spread 表格 控件被添加到列表中 ， 勾选后点击 “ 确认 按钮 ” 。  升级现有 Visual Studio.NET 工程  1) 对于现有的 工程 ， 升级步骤如下：   2) 删除使用了  Spread 工程中  Spread 相关的 DLL 引用   3) 删除使用了  Spread 的工程中  licenses.licx 文件   4) 在工程中添加一个新的窗体（为了自动生成 Licenses.licx，并自动添加  Spread 相关的 DLL 引用）   5) 在 VS 工具箱中将  Spread 控件添加到窗体中，此时会自动添加  Spread 相关的 DLL 引用，并自动   生成 licenses.licx 文件（需要确认 DLL 和 License 中 Spread 的版本号是否正确）   6) 对解决方案中所有工程进行 1-4 步操作 。（一般客户会在该步骤出现问题，一定要针对项目的所有工程进行操作）   7) Rebuild 整个解决方案。   8) 重新发布。  6. 单元格类型  本章节 中将列举 了 Spread 用户在实际项目中遇到的 典型 单元格类型问题， 包括 了 常用 单元格 类型 的设置方法 、 事件 捕获 及 扩展 现有单元格类型实现 自定义 单元格类型 等 。  Spread 支持多达 24 种 单元格类型。设置单元格类型时，对每一种单元格类型，您需要创建一个单元格类型对象，设置其属性，然后将其设为一个或多个单元格的 CellType 属性。   产品网站：                                        9 of 88 单元格 类型 指定 了 用户与单元格交互的形式，通过指定的单元格 类型 对数据进行访问，显示，校验。单元格类型为单元格定义了一个 editor 用以处理输入数据 ,一个 formatter 用以分析数据，还有一个 render 用以控制单元格的数据如何显示。   ComboxCellType 不同 选项 定制 不同的背景色  问题描述 ：如何获取 ComoboCellType 的 选择事件，改变单元格的背景色。  问题 解答： ComoboCellType 提供 了 EditorValueChanged 事件 用于捕获选择事件。  关键代码 ：  添加 ComboCellType 单元格 类型  通过 事件判断选择文本更改背景色：  效果截图 ：          /         /添加  ComboBoxCellType 单元格类型          /         private void AddCellType()                     FarPoint.Win.Spread.CellType.ComboBoxCellType comboBoxCellType1 = new FarPoint.Win.Spread.CellType.ComboBoxCellType()；             comboBoxCellType1.Items = (newString "红色 ", "绿色 ", )；             fpSpread1.Sheets0.Cells0, 0.CellType = comboBoxCellType1；             comboBoxCellType1.EditorValueChanged += newEventHandler(comboBoxCellType1_EditorValueChanged)；                 void comboBoxCellType1_EditorValueChanged(object sender, EventArgs e)                     FarPoint.Win.Spread.CellType.ComboBoxCellType test = sender as FarPoint.Win.Spread.CellType.ComboBoxCellType； if (this.fpSpread1.Sheets0.ActiveCell.Text = "红色 ")             this.fpSpread1.Sheets0.ActiveCell.BackColor = Color.Red；             if (this.fpSpread1.Sheets0.ActiveCell.Text = "绿色 ")             this.fpSpread1.Sheets0.ActiveCell.BackColor = Color.Green；                       产品网站：                                        10 of 88  示例下载： 点击下载  更多信息 请参考 Spread for WinForms V7.0 API 中文文档  相关章节。  如何禁止 ComboxCellType 编辑  问题描述 ： 如何 设置 ComboCellType 所在 单元格只能 通过 选择项更改文本， 禁止通过 键盘编辑文本。  问题 解答： ComboCellType 提供了 Editable 属性 用于获取或设置是否 可以 编辑 文本。  关键代码 ：  更多信息 请参考 Spread for WinForms V7.0 API 中文文档  相关章节。           /         /添加  ComboCellType 并且禁止编辑          /         private void AddCellType()                     string cbstr；             cbstr = newString "AAA", "AABC", "ABBC", "BBB", "BBC", "BCC" ；             string strval；             strval = newString "1", "2", "3", "4", "5", "6" ；              FarPoint.Win.Spread.CellType.ComboBoxCellType combo = new FarPoint.Win.Spread.CellType.ComboBoxCellType()；             combo.Items = cbstr；             combo.ItemData = strval；             combo.EditorValue = FarPoint.Win.Spread.CellType.EditorValue.ItemData；              /禁止编辑  Combo 文本              combo.Editable = false；             fpSpread1.Sheets0.Cells0, 0.CellType = combo；          产品网站：                                        11 of 88 实现像 google 搜索 一样的自动完成功能  问题描述 ： 通过 输入字符在 自动 匹配 数据库 中选项 ， 提高输入效率。  问题 解答： ComboBoxCellType 提供了 AutoCompleteMode 属性 用于设置 自动 完成模式，AutoCompleteSource 用于 指定自动完成数据源。  关键代码 ：  示例下载： 点击下载  更多信息 请参考 Spread for WinForms V7.0 API 中文文档  相关章节。   如何 在单元格中同时显示文本和图片  问题描述 ： 希望 在单元格中同时添加文本和图片混排 的 方式。  问题 解答： Spread 提供了 单元格自定义功能，可以继承 ComoboCellType 并且 重载 PaintCell 方法 来手动 添加 图片。  关键代码 ：  /设置单元格类型  FarPoint.Win.Spread.CellType.ComboBoxCellType combo = new FarPoint.Win.Spread.CellType.ComboBoxCellType()；  string cbstr； cbstr = newString "AAA", "AABC", "ABBC", "BBB", "BBC", "BCC" ； string strval； strval = newString "1", "2", "3", "4", "5", "6" ；  combo.Items = cbstr； combo.ItemData = strval； combo.EditorValue = FarPoint.Win.Spread.CellType.EditorValue.ItemData；  /指定自动完成的模式及数据源  combo.AutoCompleteMode = AutoCompleteMode.SuggestAppend； combo.AutoCompleteSource = AutoCompleteSource.ListItems；  fpSpread1.Sheets0.Cells0, 0.CellType = combo；  产品网站：                                        12 of 88       /     /通过继承  ComboCellType 实现      /         public class ImageCombo : FarPoint.Win.Spread.CellType.ComboBoxCellType     public override void PaintCell(Graphics g, Rectangle r, FarPoint.Win.Spread.Appearance appearance, object value, bool isSelected, bool isLocked, float zoomFactor)                     if (value != null)                             int ind =0；             for (int i = 0； i <base.Items.Length； i+)                         if (base.Itemsi = value.ToString()                             ind = i；                 break；                                   Image img = base.ImageList.Imagesind；             g.DrawImage(img, newRectangle(newPoint(r.X, r.Y), newSize(20, 20)；             g.DrawString(value.ToString(), appearance.Font, newSolidBrush(Color.Black), newPointF(r.X + 20, r.Y-10 + 10)；             ControlPaint.DrawComboButton(g, newRectangle(r.Right - 17, r.Y, 17, r.Height), ButtonState.Normal)；                                         else                             base.PaintCell(g, r, appearance, value, isSelected, isLocked, zoomFactor)；                                  产品网站：                                        13 of 88 效果截图 ：   示例下载： 点击下载  更多信息 请参考 Spread for WinForms V7.0 API 中文文档  相关章节。   CheckBoxCellType 的点击事件  问题描述 ： 如何 获取 CheckBoxCellType 的点击事件。  问题 解答： CheckBoxCellType 提供 了 EditorValueChanged 事件 用于捕获 按钮 点击事件。  关键代码 ：          /         /添加  CheckBoxCellType         / private void AddCellType()                     FarPoint.Win.Spread.CellType.CheckBoxCellType ckbxcell = new FarPoint.Win.Spread.CellType.CheckBoxCellType()；             ckbxcell.TextAlign = FarPoint.Win.ButtonTextAlign.TextRightPictLeft；             ckbxcell.Caption = "Item Selected?"；              /添加点击事件              ckbxcell.EditorValueChanged += newEventHandler(ckbxcell_EditorValueChanged)；             fpSpread1.Sheets0.Cells2, 2.CellType = ckbxcell；                   void ckbxcell_EditorValueChanged(object sender, EventArgs e)                     MessageBox.Show("CheckBox 点击 ")；           产品网站：                                        14 of 88 示例下载： 点击下载  更多信息 请参考 Spread for WinForms V7.0 API 中文文档  相关章节。  DoubleCellType 设置 为 会计专用 格式  问题描述 ：如何设置 DoubleCellType 的 分隔符、小数位以及数值范围 。  问题 解答： DoubleCellType 提供 了 DecimalSeparator、 DecimalPlaces 和 MaximumValue 等 属性分别用于设置分隔符 、 小数位以及数值范围等。  关键代码 ：     产品网站：                                        15 of 88 更多信息 请参考 Spread for WinForms V7.0 API 中文文档  相关章节。  ImageCellType 如何 让图片 自适应 单元格大 小  问题描述 ： 使用 ImageCellType 在 单元格中插入图片时，使图片 自适应 单元格大小。  问题 解答： ImageCellType 提供 Style 属性 用于设置图片在单元格中的显示方式。  关键代码 ：  更多信息 请参考 Spread for WinForms V7.0 API 中文文档  相关章节。  向用户开放向单元格 添加 图片 的功能  问题描述 ： 双击 单元格 ，然后弹出 图片 选择 对话框 ，然后把图片插入到该单元格 。  问题 解答： 可以 通过 CellDoubleClick 事件 来捕获双击 Spread 事件，然后通过 ImageCellType 插入选择图片。  关键代码 ：            /         /设置  NumberCellType 单元格类型          /         private void AddCellType()                     FarPoint.Win.Spread.CellType.NumberCellType nmbrcell = new FarPoint.Win.Spread.CellType.NumberCellType()；             /设置分隔符              nmbrcell.DecimalSeparator = ","；             /设置小数位              nmbrcell.DecimalPlaces = 5；             /设置整数位为 0时是否显示              nmbrcell.LeadingZero = FarPoint.Win.Spread.CellType.LeadingZero.UseRegional；             /设置最大值              nmbrcell.MaximumValue = 500.000；             /设置最小值              nmbrcell.MinimumValue = -10.000；             fpSpread1.ActiveSheet.Cells1, 1.CellType = nmbrcell；                     FarPoint.Win.Spread.CellType.ImageCellType icelltype = new FarPoint.Win.Spread.CellType.ImageCellType()；             /设置图片自适应单元格大小              icelltype.Style = FarPoint.Win.RenderStyle.Stretch；  产品网站：                                        16 of 88 示例下载： 点击下载  更多信息 请参考 Spread for WinForms V7.0 API 中文文档  相 关章节。  DateTimeCellType 日期格式的问题  问题描述 ： 单元格 中的日期格式显示为 "2011-3-14" 如何 更改为 "2011 年 03 月 14 日 "的格 式。  问题 解答： DateCellType 下 UserDefinedFormat 属性 用 于获取 或设置日期显示格式。  关键代码 ：          /         / 添加  ImageCellType         /         private void AddCellType()                     FarPoint.Win.Spread.CellType.ImageCellType imgct = new FarPoint.Win.Spread.CellType.ImageCellType()；              System.Drawing.Image image = System.Drawing.Image.FromFile("Tulips.jpg")；             imgct.Style = FarPoint.Win.RenderStyle.Stretch；             imgct.TransparencyColor = Color.Black；             imgct.TransparencyTolerance = 20；             fpSpread1.Sheets0.Columns1, 2.Width = 100；             fpSpread1.Sheets0.Rows1, 1.Height = 50；              fpSpread1.Sheets0.Cells1, 1.CellType = imgct；              fpSpread1.Sheets0.Cells1, 1.Value = image；              this.fpSpread1.CellDoubleClick += new FarPoint.Win.Spread.CellClickEventHandler(fpSpread1_CellDoubleClick)；                  /双击弹出选择对话框          private void fpSpread1_CellDoubleClick(object sender, FarPoint.Win.Spread.CellClickEventArgs e)                     if (fpSpread1.ActiveSheet.ActiveCell.CellType is FarPoint.Win.Spread.CellType.ImageCellType)                             OpenFileDialog dlgOpen = new OpenFileDialog()；                 dlgOpen.Filter = "*.jpg|*.jpg"；                 if (dlgOpen.ShowDialog() = System.Windows.Forms.DialogResult.OK)                                     fpSpread1.ActiveSheet.ActiveCell.Value = System.Drawing.Image.FromFile(dlgOpen.FileName)；                                      产品网站：                                        17 of 88  更多信息 请参考 Spread for WinForms V7.0 API 中文文档  相关章节。  限制 单元格 输入 最大输入长 度  问题描述 ：限制单元格文本长度在 40 个 字符。  问题 解答： TextCellType 提供 了 MaxLength 属性 用 于 获取或设置输入文本最大长度。  关键代码 ：  更多信息 请参考 Spread for WinForms V7.0 API 中文文档  相关章节。  如何 实现 隐藏 输入文本 ， 类似于密码输入框  问题描述 ：如题  问题解答 ： TextCellType 提供 了 PasswordChar 属性 用于 获取 或设置替代字符。  关键代码 ：            /         /设置  DateTimeCellType 单元格类型          /         private void AddCellType()                     FarPoint.Win.Spread.CellType.DateTimeCellType dt = new FarPoint.Win.Spread.CellType.DateTimeCellType()；              dt.DateTimeFormat = FarPoint.Win.Spread.CellType.DateTimeFormat.UserDefined；             dt.UserDefinedFormat = "yyyy 年  MM月  dd日 "；             fpSpread1.ActiveSheet.Cells0, 0.CellType = dt；             fpSpread1.ActiveSheet.Cells0, 0.Value = System.DateTime.Now；             fpSpread1.ActiveSheet.Columns0.Width = 130；                     FarPoint.Win.Spread.CellType.TextCellType txt = new FarPoint.Win.Spread.CellType.TextCellType()；             txt.CharacterCasing = CharacterCasing.Upper；             txt.CharacterSet = FarPoint.Win.Spread.CellType.CharacterSet.Ascii；             txt.HotkeyPrefix = System.Drawing.Text.HotkeyPrefix.Show；             txt.MaxLength = 40；             txt.Multiline = true；             txt.ScrollBars = ScrollBars.Vertical；             txt.Static = true；             fpSpread1.Sheets0.Cells0, 0.CellType = txt；             fpSpread1.Sheets0.Cells0, 0.Text = "This is a text cell.  It can provide a wide range of" + " functionality for handlinga large amount of data that a user might want to include" + " in a single cell."；   产品网站：                                        18 of 88 效果 截图：   更多信息 请参考 Spread for WinForms V7.0 API 中文文档  相关章节。  HyperLinkCellType 设置 点击 不打开网页  问题描述 ： 单元格 设置为 HyperLinkCellType时，点击 就会 打开网页，如何禁止网页打开。  问题 解答： HyperLinkCellType 提供了  Locked 属性 用于 获取或 设置 是否 打开网页。  关键代码 ：  更多信息 请参考 Spread for WinForms V7.0 API 中文文档  相关章节。  MaskCellType 在 单元格中显示固定 占位符  问题描述 ： 单元格 进入编辑状态后 ，如何 显示固定的 占位符 。  问题解答： MaskCellType 提供 了 Mask 属性用于获取或设置编辑固定格式。  关键代码 ：              FarPoint.Win.Spread.CellType.TextCellType txt = new FarPoint.Win.Spread.CellType.TextCellType()；             txt.PasswordChar = Convert.ToChar("*")；             fpSpread1.Sheets0.Cells0, 0.CellType = txt；             fpSpread1.Sheets0.Cells0, 0.Text = "This is a text cell."；              /锁定单元格即可禁止打开网页              this.fpSpread1.ActiveSheet.Columns1.Locked = true；             this.fpSpread1.ActiveSheet.Columns1.VerticalAlignment = FarPoint.Win.Spread.CellVerticalAlignment.Center；             this.fpSpread1.ActiveSheet.Columns1.Width = 45；  产品网站：                                        19 of 88           /         /添 加  MaskCellType 单元格类型