TabbedProperties实现 -

winseclone

浏览: 57600 次

最近访客更多访客>>

winse

xiefapan

chenweiye120

sunbin

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

TabbedProperties实现

博客分类：

eclipse_V3.7
plugin

eclipse tabbed properties

前文中 http://winseclone.iteye.com/blog/1774307 介绍了使用Properties的方法。但是TableTree 形式的Properties视图，局限性比较大，不能很好的发挥。如下操作在Properties就很难实现：

调整属性，重要的常用的属性放置在前！
在属性上添加其他操作，如在Class对象上通过ctrl+<单击>能跳转到对应的class类，并用编辑器打开。

Tabbed Properties效果

Tabbed Properties与表格式Properties不同，采用的是通过表单形式来编辑属性。如下图所示：

图中主要分3部分：

1、最外面层是Contributor，由Label + TabContainer；

2、中间层是TabContainer，可以包括n个Tab，每个Tab则是一个SectionContainer；

3、内层是SectionContainer，由n个Section组成。

每个层可以使用一个扩展点来实现。对应Tabbed提供的3个扩展点：

org.eclipse.ui.views.properties.tabbed.propertyContributor
org.eclipse.ui.views.properties.tabbed.propertyTabs
org.eclipse.ui.views.properties.tabbed.propertySections

这里，我们先按照步骤一步步的实现效果，然后再讲解3个扩展点常用的属性。

实现Tabbed Properties View

· 更新SampleView.java

1、实现ITabbedPropertySheetPageContributor接口

	public String getContributorId() {
		return SampleView.ID;
	}

2 重写SampleView的getAdapter方法。修改默认的IPropertySheetPage.class适配对象

	public Object getAdapter(Class adapter) {
		if (adapter == IPropertySheetPage.class) {
			return new TabbedPropertySheetPage(this);
		}

		return super.getAdapter(adapter);
	}

· 实现ISection，定义控件以及布局

实现自定义的IFilter和Section

StringFilter

StringTypeSection

· 扩展点实现

添加tabbed的3个扩展点。

contributorId填写为对应SampleView的Id（即SampleView.ID的值）。具体Contributor，Tab，Section的属性配置按照层次关系填写即可。

   <extension
         point="org.eclipse.ui.views.properties.tabbed.propertyContributor">
      <propertyContributor
            contributorId="plugin.properties.views.SampleView"
            labelProvider="org.eclipse.jface.viewers.LabelProvider">
         <propertyCategory
               category="Sample"></propertyCategory>
         <propertyCategory
               category="AdvancedCategory"></propertyCategory>
      </propertyContributor>
   </extension>
   <extension
         point="org.eclipse.ui.views.properties.tabbed.propertyTabs">
      <propertyTabs
            contributorId="plugin.properties.views.SampleView">
         <propertyTab
               category="AdvancedCategory"
               id="plugin.properties.advancedTab"
               label="Advanced">
         </propertyTab>
         <propertyTab
               category="Sample"
               id="plugin.properties.sampleTab"
               label="Sample">
         </propertyTab>
      </propertyTabs>
   </extension>
   <extension
         point="org.eclipse.ui.views.properties.tabbed.propertySections">
      <propertySections
            contributorId="plugin.properties.views.SampleView">
         <propertySection
               class="org.eclipse.ui.views.properties.tabbed.AdvancedPropertySection"
               id="plugin.properties.advanceSection"
               tab="plugin.properties.advancedTab">
            <input
                  type="plugin.properties.views.StringWrapper">
            </input>
         </propertySection>
         <propertySection
               class="plugin.properties.section.StringTypeSection"
               filter="plugin.properties.section.StringFilter"
               id="plugin.properties.sampleSection"
               tab="plugin.properties.sampleTab">
         </propertySection>
      </propertySections>
   </extension>

另外，编写Tabbed Properties页签视图需要懂swt，以及FormLayout布局。

对于一个属性显示一行的TabbedProperties可以通过topcased插件来生成。这个插件还是不错的。但是如果复杂一点的就需要自己定义了。

扩展点含义

下面主要讲一下3个扩展点的常用属性，及其子节点

1、 org.eclipse.ui.views.properties.tabbed.propertyContributor

#propertyContributor节点的属性

contributorId Tabbed PropertySheetPage贡献者的ID，即选中元素所在View或Editor的ID。同时View和Editor也需要实现ITabbedPropertySheetPageContributor 接口，这个接口只有一个方法，要求返回的值即该contributorId。
typeMapper - 实现类型的映射。TabbedPropertyRegistryClassSectionFilter.appliesToSelection(ISectionDescriptor, ISelection) 起到mappingFilter的作用。因为我们选择的元素并不一定是实现IPropertySource的元素（即能够给property view提供内容的元素），比如在GEF中，我们选择的finger实际上是选择了对应的EditPart，而实际上实现了IPropertySource一般的是model部分的元素，所以这时候我们要将Editpart映射到对应的model元素[r3]
labelProvider - 标题显示提供者Provider(ILabelProvider)
actionProvider - 没啥用。TabbedPropertySheetPage.validateRegistry(ISelection)中会调用registry.getActionProvider()，但在中间就返回了。
sectionDescriptorProvider - （应该是类似于propertySections扩展点的作用）
tabDescriptorProvider - （应该是类似于propertyTabs扩展点的作用）