aardio 文档
dotNet.ReoGrid 扩展库 - 设置
ReoGrid 提供了工作簿设置 WorkbookSettings 和每个工作表的设置 WorksheetSettings。通过这些设置，可以改变工作簿和工作表的许多默认行为。
可以通过工作簿实例的 SetSettings、EnableSettings、DisableSettings 方法来修改工作簿设置：
// 设置参数
reoGridControl.SetSettings(WorkbookSettings 设置项, 布尔值 启用状态);
reoGridControl.EnableSettings(WorkbookSettings 设置项);
reoGridControl.DisableSetting(WorkbookSettings 设置项);
// 获取设置状态
var 状态 = reoGridControl.HasSetting(WorkbookSettings 设置项);
| 设置项 |
说明 |
| View_ShowSheetTabControl |
是否显示工作表标签控件 |
| View_ShowScrollsShow |
是否显示所有滚动条 |
| View_ShowHorScrollShow |
是否显示水平滚动条 |
| View_ShowVerScrollShow |
是否显示垂直滚动条 |
| 设置项 |
说明 |
| Script_AutoRunOnload |
决定是否在工作簿或工作表从资源加载后立即运行脚本 |
| Script_PromptBeforeAutoRun |
如果从资源加载工作簿，在自动运行脚本前向最终用户显示提示信息 |
可以通过工作表实例的 SetSettings、EnableSettings、DisableSettings 方法来修改工作表设置：
var sheet1 = reoGridControl.CurrentWorksheet;
// 设置参数
sheet1.SetSettings(WorkbookSettings 设置项, 布尔值 启用状态);
sheet1.EnableSettings(WorkbookSettings 设置项);
sheet1.DisableSetting(WorkbookSettings 设置项);
// 获取设置状态
var 状态 = reoGridControl.HasSetting(WorkbookSettings 设置项);
工作表设置包含以下项目：
| 设置项 |
说明 |
| Behavior_DoubleClickToFitRowHeight |
允许双击自动调整行高 |
| Behavior_DoubleClickToFitColumnWidth |
允许双击自动调整列宽 |
| Behavior_MouseWheelToScroll |
允许通过鼠标滚轮滚动工作表 |
| Behavior_MouseWheelToZoom |
允许通过鼠标滚轮缩放工作表 |
| Behavior_ShortcutKeyToZoom |
允许通过快捷键(Ctrl + 加号/减号)缩放工作表 |
| Behavior_DragToMoveCells |
允许通过拖动鼠标移动或复制选定区域 |
| Behavior_DragToMoveColumnHeader |
允许用户通过拖动鼠标移动整列(保留功能) |
| Behavior_ScrollToFocusCell |
允许在滚动工作表时保持焦点单元格可见 |
| Behavior_AllowUserChangingPageBreaks |
允许用户通过鼠标插入、删除或调整分页符 |
| 设置项 |
说明 |
| Edit_Readonly |
指示工作表处于只读模式，不允许任何修改 |
| Edit_AutoFormatCell |
允许在用户编辑或输入文本后自动格式化数据 |
| Edit_FriendlyPercentInput |
允许在百分比格式的单元格中输入时显示百分号 |
| Edit_AutoAdjustRowHeight |
允许在用户增大单元格字体时自动调整行高 |
| Edit_AllowAdjustRowHeight |
允许用户通过拖动鼠标调整行高 |
| Edit_AllowAdjustColumnWidth |
允许用户通过拖动鼠标调整列宽 |
| Edit_DragSelectionToMoveCells |
允许用户通过拖拽选区来移动单元格内容 |
| Edit_DragSelectionToFillSerial |
允许用户通过拖动鼠标填充区域 |
| 设置项 |
说明 |
| View_ShowColumnHeader |
显示列标题 |
| View_ShowRowHeader |
显示行标题 |
| View_ShowHorizontalRuler |
显示水平标尺(保留功能) |
| View_ShowVerticalRuler |
显示垂直标尺(保留功能) |
| View_ShowGuideLine |
显示参考线 |
| View_ShowHiddenCellLine |
允许在隐藏行标题上显示单行标记 |
| View_AllowShowRowOutlines |
如果存在大纲，允许显示行大纲 |
| View_AllowShowColumnOutlines |
如果存在大纲，允许显示列大纲 |
| View_ShowPageBreaks |
允许显示分页线 |
| View_AllowCellTextOverflow |
使单元格文本仅显示在单元格内，不覆盖相邻单元格 |
| View_ShowPrintAreasEnable |
显示打印区域的边界线 |
| 设置项 |
说明 |
| Formula_AutoUpdateReferenceCell |
允许自动更新公式引用单元格 |
| Formula_AutoPickingAddress |
允许在编辑公式时从工作表中选择和拾取地址 |
| Formula_AutoFormat |
允许自动校正、格式化和重建公式 |
aardio 代码示例
import dotNet.ReoGrid;
// 创建工作簿控件
var grid = ReoGrid.ReoGridControl(winform);
// 获取当前工作表
var sheet1 = grid.CurrentWorksheet;
// 启用工作簿设置 - 显示工作表标签和滚动条
grid.EnableSettings(
ReoGrid.WorkbookSettings.View_ShowSheetTabControl |
ReoGrid.WorkbookSettings.View_ShowScrollsShow
);
// 禁用工作簿设置 - 隐藏水平滚动条
grid.DisableSettings(ReoGrid.WorkbookSettings.View_ShowHorScrollShow);
// 检查设置状态
var hasSetting = grid.HasSetting(ReoGrid.WorkbookSettings.View_ShowVerScrollShow);
// 设置工作表行为 - 允许双击调整行高和列宽
sheet1.EnableSettings(
ReoGrid.WorksheetSettings.Behavior_DoubleClickToFitRowHeight |
ReoGrid.WorksheetSettings.Behavior_DoubleClickToFitColumnWidth
);
// 设置工作表编辑选项 - 允许调整行高和列宽
sheet1.SetSettings(
ReoGrid.WorksheetSettings.Edit_AllowAdjustRowHeight |
ReoGrid.WorksheetSettings.Edit_AllowAdjustColumnWidth,
true // 启用
);
// 设置工作表外观 - 显示行列标题和参考线
sheet1.EnableSettings(
ReoGrid.WorksheetSettings.View_ShowColumnHeader |
ReoGrid.WorksheetSettings.View_ShowRowHeader |
ReoGrid.WorksheetSettings.View_ShowGuideLine
);
说明：
- 在 aardio 中，设置项使用按位或(
|)操作符组合多个选项
EnableSettings 和 DisableSettings 方法用于快速启用/禁用单个或多个设置SetSettings 方法可以更精确地控制设置项的启用状态HasSetting 方法用于检查特定设置是否已启用
Markdown 格式