搜尋頁面
ID:
org.eclipse.search.searchPages
說明:
這個延伸點可讓外掛程式針對一個特殊化搜尋來登錄搜尋頁面。
在一個資源上執行搜尋動作時,搜尋基礎架構會尋找最特殊化之已登錄的搜尋頁面。
配置標記:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - 目標延伸點的完整 ID
- id - 延伸實例的選用 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 - 將使用於搜尋頁面標示(tab)中的一個可翻譯的標籤(label)
- class - 實作 org.eclipse.search.ui.ISearchPage 的類別名稱。我們建議繼承 org.eclipse.jface.dialogs.DialogPage 類別。
- icon - 使用於所有符合特定副檔名之影像的相對名稱。
如果省略,則搜尋頁面的標示 (tab) 將只包含一個標籤 (label)。
- sizeHint - 頁面起始大小的提示。此為一個以逗點區隔寬度和高度的字串(例如,"50, 60")。在省略這個提示的情況下,這個頁面將小於其他頁面。
- tabPosition - 一個整數,定義頁面在頁面書籍中的位置。
這個值不是定義絕對位置,而是相對於其他頁面的位置。
頁面的次序如下:
-
如果沒有頁面定義欄標 (tab) 位置,則頁面依其標籤 (label) 的字母順序來排序
-
如果兩個頁面有指定標籤位置,則較低值的頁面放在前面。
如果值相等,則將頁面視為值不存在(請參閱 1.)
-
如果只有一個頁面指定值,則這個頁面放在第一個位置
- extensions - 搜尋頁面可操作的一個以逗點區隔的副檔名清單。
每一個副檔名必須有一個權值(0 代表最小權值),使搜尋基礎架構能夠找出最符合
的頁面。
權值與副檔名之間以一個冒號區隔。
如果搜尋頁面可搜尋所有可能的資源,則可使用 "*"。
- searchViewHelpContextId - 顯示這個頁面結果的「搜尋」視圖之選用性說明環境定義 ID。如果遺漏這個屬性,則使用預設的搜尋說明環境定義 ID (org.eclipse.search.search_view_context)。
- showScopeSection - 如果遺漏了這個屬性,或設成 "false",則範圍區段不會顯示在「搜尋」對話框中。
如果要查看範圍區段,這個屬性必須設成 "true"。
新增本身的搜尋頁面並要看見範圍區段外掛程式必須加入這個 plugin.xml 檔案。
- enabled - 如果遺漏了這個屬性,或設成 "false",則頁面一開始就不會顯示在「搜尋」對話框中。
使用者可以透過「搜尋」對話框中的「自訂...」按鈕來啟動這個頁面。
- canSearchEnclosingProjects - 如果遺漏了這個屬性,或設成 "false",則「Enclosing 專案」搜尋範圍不會顯示在搜尋對話框的範圍組件。
如果遺漏 "showScopeSection" 屬性,或設為 "false",則會忽略這個屬性。
範例:
下列是搜尋頁面延伸定義的範例:
<extension point=
"org.eclipse.search.searchPages"
>
<page
id=
"org.eclipse.search.ui.text.TextSearchPage"
label=
"文字搜尋"
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.
本程式與隨附的資料依照 Elipse Public License 1.0 版此次發行所隨附的條款而提供,
可以在以下網址取得:http://www.eclipse.org/legal/epl-v10.html