搜索页面
标识:
org.eclipse.search.searchPages
描述:
此扩展点允许插件为专用搜索注册搜索页面。当对资源执行搜索操作时,搜索基础结构将查找最专业的注册搜索页面来获取它。
配置标记:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - 目标扩展点的标准标识
- id - 扩展实例的可选标识
- name - 扩展实例的可选名称
<!ELEMENT page EMPTY>
<!ATTLIST page
id CDATA #REQUIRED
label CDATA #REQUIRED
class CDATA #REQUIRED
icon CDATA #IMPLIED
sizeHint CDATA #IMPLIED
tabPosition CDATA #IMPLIED
extensions CDATA #IMPLIED
searchViewHelpContextId CDATA #IMPLIED
showScopeSection (true | false)
enabled (true | false)
canSearchEnclosingProjects (true | false) >
- id - 将用来标识此搜索页面的唯一名称
- label - 将在搜索页面选项卡中使用的可翻译标签
- class - 实现 org.eclipse.search.ui.ISearchPage 的类的名称。建议对 org.eclipse.jface.dialogs.DialogPage 划分子类。
- icon - 将用于与指定的扩展相匹配的所有资源的图像的相对名称。如果省略,则搜索页面的选项卡将只包含标签。
- sizeHint - 关于页面的初始大小的提示。这是一个包含由逗号隔开的宽度和高度的字符串(例如,“50, 60”)。在省略了此提示的情况下,页面将不会超过其它页面的大小。
- tabPosition - 一个整数,用来定义页面放置在页面册中何处。该值并不定义绝对位置,而是定义相对于其它页面的位置。页面的排序如下所示:
-
如果没有页面定义选项卡位置,则它们是根据其标签按字母顺序排序的
-
如果两个页面都指定了选项卡位置,则首先出现具有较低值的页面。如果值相同,则当这些值好象不存在那样来处理页面(请参阅 1.)
-
如果只有一个页面指定了值,则此页面先出现
- extensions - 搜索页面可对其执行操作的具有文件扩展名用逗号分隔的列表。每个扩展名还必须包含权重(0 表示最低权重),它使搜索基础结构能够查找最合适的页面。权重与扩展名之间由冒号隔开。如果搜索页面可以搜索所有可能的资源,则可使用“*”。
- searchViewHelpContextId - 用于显示此页面的结果的“搜索”视图的可选帮助上下文标识。如果缺少此属性,则使用缺省搜索帮助上下文标识(org.eclipse.search.search_view_context)。
- showScopeSection - 如果此属性丢失或设置为“false”,则作用域部分不会显示在“搜索”对话框中。要查看作用域部分,必须将此属性设置为“true”。添加它们自己的“搜索”页并且想查看作用域部分的插件必须将此项添加至它们的 plugin.xml。
- enabled - 如果此属性丢失或设置为“false”,则在“搜索”对话框中最初不会显示该页面。用户可通过“搜索”对话框上的“定制...”按钮来激活该页面。
- canSearchEnclosingProjects - 如果缺少此属性或者设置为“false”,则“外层项目”搜索作用域不会显示在搜索对话框的作用域部分。如果缺少“showScopeSection”属性或者设置为“false”,则将忽略此属性。
示例:
以下是搜索页面扩展定义的一个示例:
<extension point=
"org.eclipse.search.searchPages"
>
<page
id=
"org.eclipse.search.ui.text.TextSearchPage"
label=
"Text Search"
icon=
"icons/full/obj16/tsearch_pref.gif"
sizeHint=
"250,160"
tabPosition=
"1"
extensions=
"*:1"
showScopeSection=
"true"
class=
"org.eclipse.search.ui.text.TextSearchPage"
>
</page>
</extension>
API 信息:
添加的类必须实现 org.eclipse.search.ui.ISearchPage
所提供的实现:
搜索基础结构为全文本搜索提供了搜索页面。
Copyright (c) 2001, 2004 IBM Corporation and others.
All rights reserved. 本程序及所附带提供的资料依据 Common Public License v1.0 的条款方可使用,本发行中提供了该许可条款,并且在以下位置也可获得该条款:http://www.eclipse.org/legal/cpl-v10.html。