搜索页面
标识:
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, 2005 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html