Spread for WinForms 表格控件客户问题实战
Spread for WinForms
目录
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)
22.剪切板操作 (76)
23.鼠标交互 (77)
24.文件交互 (80)
Excel 导出 (80)
Excel 导入 (83)
25.皮肤 (84)
26.如何调用设计器 (86)
27.汉化 (87)
28.本文档所有示例下载地址 (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）。
2)在弹出的界面上点击“激活”链接。
3)激活产品建的界面上点击“下一步”。
4)在输入产品键界面输入产品键等使用信息点击“下一步”按钮。
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 平台。
部署文件
您必须在用户系统中部署下列文件：
下列程序集是与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)。
在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 https://www.360docs.net/doc/a317515568.html, 工程
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属性。
单元格类型指定了用户与单元格交互的形式，通过指定的单元格类型对数据进行访问，显示，校验。单元格类型为单元格定义了一个editor用以处理输入数据,一个formatter用以分析数据，还有一个render用以控制单元格的数据如何显示。
ComboxCellType 不同选项定制不同的背景色
问题描述：如何获取ComoboCellType的选择事件，改变单元格的背景色。
问题解答：ComoboCellType提供了EditorValueChanged事件用于捕获选择事件。
关键代码：
添加ComboCellType 单元格类型
示例下载：点击下载
更多信息请参考Spread for WinForms V7.0 API中文文档相关章节。
如何禁止ComboxCellType 编辑
问题描述：如何设置ComboCellType所在单元格只能通过选择项更改文本，禁止通过键盘编辑文本。问题解答：ComboCellType提供了Editable 属性用于获取或设置是否可以编辑文本。
关键代码：
Spread for WinForms V7.0 API中文文档
实现像google 搜索一样的自动完成功能
问题描述：通过输入字符在自动匹配数据库中选项，提高输入效率。
问题解答：ComboBoxCellType 提供了AutoCompleteMode 属性用于设置自动完成模式，AutoCompleteSource用于指定自动完成数据源。
关键代码：
示例下载：点击下载
更多信息请参考Spread for WinForms V7.0 API中文文档相关章节。
如何在单元格中同时显示文本和图片
问题描述：希望在单元格中同时添加文本和图片混排的方式。
问题解答：Spread提供了单元格自定义功能，可以继承ComoboCellType 并且重载PaintCell 方法来手动添加图片。
关键代码：
效果截图：
示例下载：点击下载
更多信息请参考Spread for WinForms V7.0 API中文文档相关章节。
CheckBoxCellType 的点击事件
问题描述：如何获取CheckBoxCellType 的点击事件。
问题解答：CheckBoxCellType提供了EditorValueChanged事件用于捕获按钮点击事件。关键代码：
示例下载：点击下载
更多信息请参考Spread for WinForms V7.0 API中文文档相关章节。
DoubleCellType 设置为会计专用格式
问题描述：如何设置DoubleCellType 的分隔符、小数位以及数值范围。
问题解答：DoubleCellType提供了DecimalSeparator、DecimalPlaces和MaximumValue等属性分别用于设置分隔符、小数位以及数值范围等。
关键代码：
Spread for WinForms V7.0 API 中文文档 ImageCellType 如何让图片自适应单元格大小
问题描述：使用
ImageCellType 在单元格中插入图片时，使图片自适应单元格大小。 问题解答：ImageCellType 提供Style 属性用于设置图片在单元格中的显示方式。 关键代码：
Spread for WinForms V7.0 API 中文文档 向用户开放向单元格添加图片的功能
问题描述：双击单元格，然后弹出图片选择对话框，然后把图片插入到该单元格。
问题解答：可以通过CellDoubleClick 事件来捕获双击Spread 事件，然后通过ImageCellType 插入选择图片。 关键代码：
示例下载：点击下载
更多信息请参考Spread for WinForms V7.0 API中文文档相关章节。DateTimeCellType日期格式的问题
问题描述：单元格中的日期格式显示为"2011-3-14" 如何更改为"2011年03月14日"的格式。问题解答：DateCellType下UserDefinedFormat属性用于获取或设置日期显示格式。
关键代码：
更多信息请参考Spread for WinForms V7.0 API中文文档相关章节。
限制单元格输入最大输入长度
问题描述：限制单元格文本长度在40 个字符。
问题解答：TextCellType提供了MaxLength属性用于获取或设置输入文本最大长度。关键代码：
Spread for WinForms V7.0 API中文文档
如何实现隐藏输入文本，类似于密码输入框
问题描述：如题
问题解答：TextCellType提供了PasswordChar 属性用于获取或设置替代字符。
关键代码：
更多信息请参考Spread for WinForms V7.0 API中文文档相关章节。HyperLinkCellType 设置点击不打开网页
问题描述：单元格设置为HyperLinkCellType时，点击就会打开网页，如何禁止网页打开。问题解答：HyperLinkCellType 提供了Locked 属性用于获取或设置是否打开网页。
关键代码：
Spread for WinForms V7.0 API中文文档
MaskCellType在单元格中显示固定占位符
问题描述：单元格进入编辑状态后，如何显示固定的占位符。
问题解答：MaskCellType提供了Mask属性用于获取或设置编辑固定格式。
关键代码：
示例下载：点击下载
更多信息请参考Spread for WinForms V7.0 API中文文档相关章节。MultiColumnComboBoxCellType 实现下拉表单
问题描述：能否在点击单元格时，根据当前单元格信息，弹出其相对应的数据库子表单。
问题解答：MultiColumnComboBoxCellType 单元格类型可以绑定DataTable，并且以下拉框方式显示。关键代码：