提要項目延伸

org.eclipse.ui.cheatsheets.cheatSheetItemExtension

3.0

當需要在提要的某個步驟中加入額外按鈕時,應該使用這個延伸點。 您可以在提要內容檔案中的 "item" 標示放入新的屬性,當提要組織架構讀取該值時,將會檢查並查看是否有類別透過這個延伸點登錄來處理這個屬性。提要內容檔中的屬性名稱會與所有登錄的 cheatsheetItemExtension 點實作的 "itemAttribute" 屬性的所有值進行比對。如果有相符項目,提要組織架構就會載入指定處理這個項目屬性的類別,而且呼叫類別來處理提要內容檔中指定的屬性。 剖析項目屬性的值之後,類別會繼續供提要組織架構使用。當項目呈現於提要視圖時,會再次呼叫類別來處理加入元件到「複合項」。新增到這個「複合項」的項目會顯示在提要步驟中(目前是在說明圖示旁邊)。這只會針對由屬性出現在提要內容檔的 "item" 標示所說明的步驟來顯示。 這個延伸點的建議使用方式是新增含有圖形的小 (16x16) 按鈕,當按下時會開啟對話框。

<!ELEMENT extension (itemExtension)*>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT itemExtension EMPTY>

<!ATTLIST itemExtension

itemAttribute CDATA #REQUIRED

class         CDATA #REQUIRED>

使用這個項目延伸來將元素新增至提要步驟中。您可以使用這個延伸點來新增提要中之步驟的圖示和按鈕(目前是在說明圖示旁邊)。 您指定將放入提要項目標示中的屬性名稱。您還要指定當載入提要內容時,將處理提要內容檔中的屬性值剖析的類別。屬性值必須是一個字串。指定的類別必須繼承 org.eclipse.ui.cheatsheets.AbstractItemExtensionElement。當剖析且載入提要內容檔之後,會透過介面再次呼叫延伸點中指定的類別,新增圖形或按鈕到提要內容中的步驟(目前是在說明按鈕的旁邊)。



下列是這個延伸點的範例實作:

<extension point=

"org.eclipse.ui.cheatsheets.cheatSheetItemExtension"

>

<itemExtension itemAttribute=

"xyzButton"

class=

"com.example.HandleParsingAndAddButton"

>

</itemExtension>

</extension>

下列是這個延伸的 item 屬性:

<item title=

"XYZ Title"

xyzButton=

"/icon/button.gif"

/>

請注意,項目標示中的屬性值可以是「任意值」。因為剖析該屬性的類別是 HandleParsingAndAddButton 類別,在此範例中從屬性剖析出 /icon/button.gif 字串。稍後會使用這項資訊來載入 gif 並作為新按鈕的圖示。

請參閱 org.eclipse.ui.cheatsheets.AbstractItemExtensionElement 的 Javadoc 資訊,以取得有關 API 的詳細資料。

這時沒有提供的實作。