发布时间 : 星期五 文章DCWriter文本编辑器软件使用说明 - 图文更新完毕开始阅读
控件内容是否只读。
Public bool HeaderFooterReadonly{get;set;} 控件中显示的文档的页眉页脚内容是否只读。 Public string LicenseFlag{get;set;}
控件授权信息标记。
Public DCSoft.Writer.Controls.FormViewMode FormView{get;set;} 控件的表单视图模式。可选值有
Disable:不处于表单视图模式，用户可任意编辑。
Normal:处于普通表单视图模式，用户可以编辑输入域中的内容，输入域之外的内容只读，但可以选择。
Strict:严格的表单视图模式，可以可以编辑输入域中的内容，但输入域之外的内容只读，而且不可选项，插入点不可在输入域之外。
Public bool Modified{get;set;}
控件中文档内容是否被改变的标志。 Public object ServerObject{get;set;} 用于”Server”文档变量和脚本中的变量的对象实例。
Public DCSoft.Writer.DocumentOptions DocumentOptions{get;set;}
文档设置。
Public DCSoft.Writer.Dom.XTextDocument Document{get;set} 在控件中显示和编辑的文档对象。 Public int DocumentContentVersion{ get;} 当前文档内容的版本号，对文档内容的任何修改都会使得该版本号增加。 Public int WriteDataSource()
将文档输入域中的表单数据写入到文档对象绑定的数据源中。函数返回填写的数据条数。
Public DCSoft.Writer.Dom.DocumentControler DocumentControler{get;set;}
文档控制器。
Public bool IsAdministrator{get;set} 是否已管理员模式运行。
Public DCSoft.Writer.WriterAppHost AppHost{get;set;} 应用程序宿主对象。
Public void Move( DCSoft.Writer.MoveTarget target )
将插入点移动到指定位置。
Public DCSoft.Writer.Dom.DocumentContentStyle CurrentStyle{ get;} 当前文档样式。
Public DCSoft.Writer.Dom.XTextElement CurrentElement{get;} 获得当前插入点所在的文档元素对象。
Public DCSoft.Writer.Dom.XTextElement GetCurrentElement( Type elementType ) 获得插入点所在的指定类型的文档元素对象。
Public DCSoft.Writer.Dom.XTextElement HoverElement{get;} 当前鼠标光标下的文档元素对象。
Public DCSoft.Writer.Dom.XTextLine CurrentLine{get;} 当前插入点所在的文本行对象。
Public DCSoft.Writer.Dom.XTextElement GetElementById( string id );
获得指定ID号的文档元素大小，查找时ID值区分大小写。
Public DCSoft.Writer.Dom.XTextElementList GetSpecifyElements( Type elementType) 获得文档中所有的指定类型的文档元素列表。
Pulbic DCSoft.Writer.Dom.HighlightInfo HighlightRange{get;set;} 获得或设置文档中的高亮度显示区域。
Public DCSoft.Writer.Dom.HighlightInfoList HighlightRanges{ get;set;} 获得或设置文档中的多个高亮度显示区域。
Public DCSoft.Writer.Dom.XTextContentRender ContentRender{ get;set;} 获得或设置文档内容呈现器。 Public bool AutoUserLogin{get;set;}
每次打开文档时是否自动进行用户登录。
Public DCSoft.Writer.Security.UserLoginInfo AutoUserLoginInfo{get;set;} 执行自动登录时使用的用户登录信息。
Public bool UserLogin( string userID , string username , int permissionLevel )
执行用户登录，第一个参数为用户编号；第二个参数为用户名；第三个参数为用户授权登记。
Public bool UserLogin( UserLoginINfo loginInfo , bool updateUI )
执行用户登录，第一个参数为用户登录信息；第二个参数为是否更新用户界面。 Public bool LoadDocument( string fileName , DCSoft.Writer.FileFormat format ) 从指定的文件已指定的格式加载文档。
Public bool LoadDocument( System.IO.Stream steram , DCSoft.Writer.FileFormat format) 从指定的流中以指定的格式加载文档。 Public event EventHandler DocumentLoad 文档加载成功事件。
Public virtual void OnDocumentLoad( EventArgs args )
出发文档加载成功事件。
Public bool SaveDocument( string filename , FileFormat format ) 以指定的格式将文档保存在指定的文件中。 Public void ClearContent() 清空文档内容。
public void RefreshDocument() 属性文档视图。
Public override string Text{get;set;} 纯文本格式的文档内容。 Public string RTFText{ get;set;}
RTF格式的文档内容。 Public string XMLText{get;set;} XML格式的文档内容。
Public bool EnableJumpPrint{get;set;} 是否允许续打。
Public int JumpPrintPosition{get;set;} 设置和获得续打位置。
Public event EventHandler HoverElementChanged 鼠标悬停的元素发生改变事件。
Public virtual void OnHoverElementChanged( XTextElement oldHoverElement , XTextElement newHoverElement )
触发鼠标悬停的文档元素发生改变事件。第一个参数为旧的鼠标悬停元素，第二个参数为新的鼠标悬停元素。
Public bool HideCaretWhenHasSelection{get;set;} 当选择了文档内容时是否隐藏插入点光标。 Public void SelectAll() 选择文档中所有的内容。 Public void Cut() 执行剪切操作。 Public void Copy() 执行复制操作。 Public void Paste() 执行粘贴操作。 Public void Undo() 执行撤销操作。 Public void Redo()
执行重复操作。
Public void DeleteSelection() 删除被选中的文档内容。 Public int CurrentColumnIndex 获得从1开始计算的当前列号。 Public int CurrentLineIndex 获得从0开始的当前行号。 Public int CurrentLineIndexInPage
获得从1开始计算的当前文本行在页中的序号。 Public DCSoft.Writer.XTextSelection Selection 文档中被选中的部分内容。 Public void PrintDocument() 打印整个文档。
Public void PrintCurrentPage() 打印当前页。
Public event EventHandler DocumentContentChanged 文档内容发生改变事件。
Public event EventHandler SelectionChanged
插入点或文档内容被选择状态发生改变事件。
Pulbic event SelectionChangingEventHandler SelectionChanging 插入点或文档内容被选中状态正在发生改变事件。这个事件是可以撤销的。 Public bool IsEditingElementValue{get;} 控件正在弹出一个用户界面编辑输入域的内容。 Public bool CancelEditElementValue() 取消编辑输入域内容的操作。
Public bool BeginEditElementValue( XTextElement element , bool detect ) 开始执行编辑元素内容的操作。第一个参数为文档元素对象；第二个参数为指示本次调
用只是检测当前元素的值能否编辑，但不执行编辑操作。 Public string PageTitle{get;} 页面标题。
Public string StatusText{get;set;}
状态栏文本。
Public void SetStatusText( string text ) 设置状态栏文本。
Public event EventHandler StatusTextChanged 状态栏文本发生改变事件。 Public void ShowAboutDialog()
显示关于对话框。
4.5.1. WinForm开发
编辑器控件可以用于WinForm应用程序开发。其过程和其他WinForm控件没多大差别。也就是将控件添加到WinForm窗体设计器的控件工具条上，然后拖拽一个控件到窗体上即可使用。
4.5.1.1. 数据交换
DCWriter编辑器控件通过两种方式和其他应用程序交换数据，包括系统剪切板和OLE拖拽。
4.5.1.1.1. 系统剪切板
编辑器控件支持复制数据到Windows系统剪切板和从Windows系统剪切板粘贴数据。当编辑器控件复制数据到剪切板时，复制的数据是多格式的，包括 1. 纯文本格式。
2. 自定义的内置XML字符串格式，该格式名称为“DCWriterXML V:编辑器版本号”，例如
“DCWriter V:1.1.23.3424”。该格式的数据就是一段能用于加载文档的XML字符串。 3. HTML文档格式。 4. RTF文档格式。
5. 当复制的文档内容是一个图片文档元素时，还输出图片格式。
编辑器从系统剪切板粘贴数据时，编辑器以此支持以下格式：
1. 文件名。当数据为一个文件名，而且指向的文件名的扩展名
为.bmp、.png、.jpg、.jpeg、.gif、.emf。则认为它是图片文件。编辑器会加载文件并向文档插入一个图片元素。
2. 位图对象。如果数据为一个位图对象，则编辑器会据此向文档插入一个图片元素。 3. 系统内置XML格式。编辑器会以XML的格式加载文档并将其内容插入到当前文档中。 4. RTF文档。 5. 纯文本。
编辑器在粘贴数据时会调用数据过滤器。关于数据过滤可参看后续相关章节。