Eclilpse插件编写系列(Editor)

编辑器方法

以下是EditorPart的方法
  1. createPartControl(Composite)
  2.     创建包括在编辑器中的控件。通常情况下,这种方法会调用方法,如createTree,createTextEditor等子方法来创建控件;
  3. dispose()
  4.     此方法在编辑器被关闭的时候自动调用,标志着编辑器的生命周期结束。一般在这个方法中销毁由这个类创建的资源,如图像,剪贴板等等;
  5. doSave(IProgressMonitor)
  6.     保存编辑器的内容。如果保存成功,会触发一个属性改变事件(PROP_DIRTY 属性),变成一个脏状态。如果保存取消,编辑器会调用IProgressMonitor的setCanceled方法通知调用者;
  7. doSaveAs() 
  8.     这个方法是可选的。它打开一个另存为的对话框,另存内容。如果保存成功,编辑器触发一个属性改变事件(PROP_DIRTY 属性),变成一个脏状态。
  9. gotoMarker(IMarker)
  10.     用给定的marker设置光标或选择对象的状态;
  11. init(IEditorSite, IEditorInput) 
  12.     用给定的site与input初始化编辑器。这个方法在编辑器构造之后自动调用,这标记着一个编辑器生命周期的开始。
  13. isDirty() 
  14.    自上次保存后,编辑的内容是否改变;
  15. isSaveAsAllowed() 
  16.    是否这个编辑器支持另存;
  17. setFocus() 
  18.    要求这个编辑器在工作区设置焦点,一般会调用它的子控件的setFocus方法。

MultiPageEditorPart 增加了如下的方法
  1. addPage(Control)
  2.     创建并且新增包含一个新页的控件到多页编辑器中,这个控件Control可能为空,可以以后通过setControl方法来创建这个Control的实例;
  3. addPage(IEditorPart, IEditorInput) 
  4.     创建并且加一个包含给定编辑器的新页到多页编辑器中,同时增加一个属性变化监听器到内嵌的编辑器中;
  5. createPages()
  6.     创建多页编辑器的页。一般来说,这个方法会调用其它方法如ceatePropertiesPage, createSourcePage,等等;
  7. getContainer()
  8.     返回包含多页编辑器页的控件;
  9. setPageImage(int, Image)
  10.     给相应序号的页设置图像;
  11. setPageText(int, String)
  12.     给页设置标题



编辑器属性设置

Eclilpse插件编写系列(Editor)

  1. Extensions:  用分号隔开的字符串,含有此后缀的文件,编辑器可以编辑,为可选属性;
  2. Command: 命令是用来打开一个外部的编辑器; 
  3. Default: 可选true或false,空时,表示false,如果为true,表示这个编辑器是Extensions指定后缀名文件的默认编辑器;
  4. Filenames: 带分号的字符串,表示编辑器可以编辑的文件名;
  5. LauncherL: org.eclipse.ui. IEditorLauncher的实现类,用于打开外部的编辑,它与class、command互斥;
  6. matchingStrategy: org.eclipse.ui.IEditorMatchingStrategy的实现类,用于在openEditor() and findEditor()操作时,找到配置的编辑器;

    另外,编辑器有一个或多个contentTypeBinding子元素,每个contentTypeBinding含有一个contentTypeId属性,contentTypeId引用一个org.eclipse.core.runtime.contentTypes扩展,表示编辑包含内容的类型。contentTypes扩展能更精确定义一个文件是否应与一个指定的编辑器关联。
    在通过名符与后缀名来过滤文件后,编辑器用IContentDescriber or ITextContentDescribert来扫描文件的内容,看文件中是否包含特定的内容。Eclipse提供了几个内建的描述器:
  
  • BinarySignatureDescriber,用来描述二进制格式的内容,它有三个参数signature," "offset," 和 "required” 第一个参数是必须的;
  •     Signature 一个十六进制码。如“CA FE BA BE”,是一个java类名件的签名,Offset是一个整数,表示签名第一个字符的偏移;
       Required 一个布尔值,默认是Ture,是否签字的情况下,应认为该IContentDescriber.INVALID或IContentDescriber.INDETERMINATE内容有效状态。
  • XMLRootElementContentDescriber,用来发现一个XML文件中的顶层元数或DTD标识的名字,它有两个参数:DTD和element。


你可能感兴趣的:(eclipse,UI)