綱目定義頁面

關於這個頁面

這個表單頁面可讓您編輯綱目物件的結構和內容,它們構成所編輯的綱目文法。

綱目物件的結構是在延伸點元素區段中進行編輯。這個區段佔用編輯區的左上角部分。

綱目物件的內容是在 <schema-object> 詳細資料區段中進行編輯。視延伸點元素區段中選取的綱目元素類型而定,這些區段會在編輯區右上角部分啟動。

頁面區段

這個頁面是由下列區段組成:

延伸點元素區段

這個區段可讓您執行下列各項:

可直接透過綱目定義表單頁面來存取這個區段。

延伸點元素區段欄位

您可以利用延伸點元素檢視器欄位來執行下列各項:

這個檢視器包含下列節點:

元素:

Compositor:

屬性:

範例:延伸元素指定容許一或多個捷徑元素所組成的序列作為其合法子項。 元素參照是用來代表捷徑元素。Sequence compositor 是用來代表一連串的元素。

延伸點元素區段 2

範例:捷徑元素指定允許說明或種類元素作為其合法的子項。元素參照是用來代表說明和種類元素。Choice compositor 是用來代表選擇的元素。

延伸點元素區段 1

延伸點元素區段動作

按一下新增元素按鈕,可將新的廣域元素宣告新增至延伸點綱目文法中。選取任何節點後,便可使用這個動作。附註:元素宣告順序不重要

按一下新增屬性按鈕,可將新的區域屬性宣告新增至延伸點綱目文法中的選定元素。這個動作可用於所有選取的元素節點,但延伸元素節點除外。延伸元素節點一律具有相同的屬性:id、name、point。附註:屬性宣告順序不重要。

如果要從延伸點綱目文法中刪除綱目物件,請用滑鼠右鍵按一下所選取的節點,並選取刪除。這個動作可用於所有選取的節點,但延伸元素節點除外。對於非共用綱目,延伸元素節點是特殊根元素,用來定義所編輯之綱目文法的進入點。外掛程式資訊清單編輯器中所定義的任何延伸,都必須使用延伸母元素來指定其 XML 相關標記。

如果要指定元素子項是由延伸點綱目文法中的一連串或選擇的其他元素組成,請執行下列動作:

  1. 選取並用滑鼠右鍵按一下您要指定為母元素的元素節點。
  2. 選取新建 > Compositor > Sequence,以定義一連串元素。選取新建 > Compositor > Choice,以定義選擇的元素。
  3. 選取並用滑鼠右鍵按一下新的 compositor 節點。
  4. 從新建 > 參照子功能表中選取您要指定為母元素之子項的元素。在參照子功能表中,會移入在延伸點綱目文法中全域宣告的所有元素。
  5. 重複步驟 (3) 和 (4) 可指定其他子元素。如果指定了 Sequence compositor,則相當於在序列中指定其他元素。如果指定了 Choice compositor,則相當於指定其他元素 choice。

附註:如果要指定某元素為另一個元素的子項,母元素一定要使用中間的 Sequence 或 Choice compositor。compositor 節點為連接器節點;而 element reference 節點則為葉節點。因此,compositor 節點一律至少指定一個子元素參照節點。

附註:Sequence 和 Choice compositor 可不限巢狀深度來建立更多複雜文法。

附註:文法不得包含自我參照循環。當元素 A 需要元素 B 作為子項,而元素 B 需要元素 A 作為子項時,就會發生禁止循環的最基本形式。

如果要指定某元素不含子項,並容許在其開始和結束 XML 標籤內指定文字(字元內容),只要依現狀保留元素的結構即可,不要新增任何屬性、compositor 和元素參照至其中(元素內容)。附註:元素不得指定混合內容(字元內容和元素內容)。

說明區段

這個區段可讓您在所編輯的綱目文法內提供任何元素、屬性或 compositor 的簡要說明。

可直接透過綱目定義表單頁面來存取這個區段。

說明區段

說明區段欄位

編輯說明文字欄位,以提供在延伸點元素區段中選取的現行元素、屬性或 compositor 節點的簡要說明。必要時,可在這個欄位內使用有效的 HTML 標記。

附註:更新元素參照說明也會更新它所參照和被參照的廣域元素宣告的說明。

元素詳細資料區段

這個區段可讓您編輯元素的內容。元素有兩種類型:延伸元素和非延伸元素。延伸元素是特殊根元素宣告,用來定義所編輯之綱目文法的進入點。非延伸元素是廣域元素宣告,用來作為所編輯之綱目文法內的基本結構建置區塊。

您可在延伸點元素區段中選取延伸元素節點或非延伸元素節點,來啟動這個區段。

延伸元素的元素詳細資料區段。

元素詳細資料區段 1

非延伸元素的元素詳細資料區段。

元素詳細資料區段 2

元素詳細資料區段欄位

編輯名稱欄位以指定元素名稱。

按一下內部欄位中的 true 按鈕或 false 按鈕,以指出該元素是否為內部元素。外掛程式資訊清單編輯器將以警告來標示任何內部延伸 XML 標記(依預設)。這個欄位類似所匯出套件的 x-internal 屬性。

按一下已淘汰欄位中的 true 按鈕或 false 按鈕,以指出該元素是否已淘汰。外掛程式資訊清單編輯器將以警告來標示任何已淘汰的延伸 XML 標記(依預設)。這個欄位類似 Java 的 Javadoc @deprecated 標籤。

如果延伸元素標示為已淘汰,請編輯取代欄位,指定使用者應在原處使用的未淘汰延伸點,以達到相同功能。

從標籤內容欄位中選取其中一個元素定義屬性,以指定要作為外掛程式資訊清單編輯器中的元素標籤的屬性值。例如,如果選取一值,外掛程式資訊清單編輯器中的延伸頁面的所有延伸區段中的元素節點標籤,將如下所示:selected-attribute-value (element-name)。否則,如果未選取值,元素的節點標籤將如下所示:(element-name)。

從圖示欄位選取其中一個元素定義資源類型屬性,以指定用來代表外掛程式資訊清單編輯器中的元素節點的圖示資源。如果要使元素的節點圖示正確顯示在外掛程式資訊清單編輯器中的延伸頁面的所有延伸區段中,必須符合下列條件:

按一下可翻譯欄位中的 true 按鈕或 false 按鈕,以指出該元素的字元內容是否可翻譯。只有當元素沒有指定的子項(元素內容)或屬性,並容許在其開始和結束 XML 標籤內指定文字(字元內容)時,這個欄位才適用。如果元素的字元內容是標示為可翻譯,則 PDE 工具可用於提供的延伸 XML 標記上,將內容提出至內容檔,以獲得多國語言支援。

使用唯讀 DTD 近似值欄位,以檢視元素綱目文法與同等元素 DTD 文法近似的一對一對映。在指定 XML 文件的正式文法方面,DTD(文件類型定義)是比 XML 綱目更容易閱讀但功能較弱的替代方案。下列表示法是用來指定 DTD 近似值:

Compositor 詳細資料區段

這個區段可讓您編輯 compositor 的內容。compositor 有兩種類型:sequence compositor、choice compositor。sequence compositor 可讓您指定元素的子項是由所編輯之綱目文法中的一連串其他元素組成。choice compositor 可讓您指定元素的子項是由所編輯之綱目文法中選擇的其他元素組成。

您可在延伸點元素區段中選取 Sequence 或 Choice 節點,來啟動這個區段。

Compositor 詳細資料區段

Compositor 詳細資料區段欄位

編輯最少出現次數欄位,以指定含有其他元素及 / 或 compositor 的這個 compositor 可以出現在提供的延伸 XML 標記中的最少出現次數。PDE 使用這個欄位的值來驗證外掛程式資訊清單編輯器中的對應關係限制。如果元素 A 需要正好一個元素 B 或元素 C 作為它的子項,而且它使用 Choice compositor 指定最少需出現 2 次,則必須在提供的延伸 XML 標記中,定義任兩個元素 B 與元素 C 的組合實例,才有效。

編輯最多出現次數欄位,以指定含有其他元素及 / 或 compositor 的這個 compositor 可以出現在提供的延伸 XML 標記中的最多出現次數。PDE 使用這個欄位的值來驗證外掛程式資訊清單編輯器中的對應關係限制。如果元素 A 需要正好一個元素 B 或元素 C 作為它的子項,而且它使用Choice compositor 指定最多只能出現 2 次,在提出的延伸 XML 標記中,最多只能定義 2 個元素 B 與元素 B 與元素 C 的組合實例,才有效。

勾選無界限欄位,以指定不限制這個 compositor 可出現在提供的延伸 XML 標記內的容許出現次數上限。

從類型欄位中選取一值,以指定這個 compositor 是 sequence 或 choice。

使用唯讀 DTD 近似值欄位,以檢視 compositor 綱目文法與同等 compositor DTD 文法近似的一對一對映。 在本文件的元素詳細資料區段欄位標題下,說明了用來指定 DTD 近似值的表示法。

元素參照詳細資料區段

這個區段可讓您編輯元素參照的內容。元素參照是所編輯之綱目文法內的廣域元素宣告之參照。compositor 使用元素參照作為不可分割的建置區塊,來定義廣域元素宣告的文法。

您可在延伸點元素區段中選取元素參照節點,來啟動這個區段。

元素參照詳細資料區段

元素參照詳細資料區段欄位

編輯最少出現次數欄位,以指定這個元素可以出現在提供的延伸 XML 標記中的最少出現次數。PDE 使用這個欄位的值來驗證外掛程式資訊清單編輯器中的對應關係限制。如果元素 A 指定最少出現次數 2,則必須在提供的延伸 XML 標記中定義元素 A 的 2 個實例。

編輯最多出現次數欄位,以指定這個元素可以出現在提供的延伸 XML 標記中的最多出現次數。PDE 使用這個欄位的值來驗證外掛程式資訊清單編輯器中的對應關係限制。如果元素 A 指定最多出現次數 2,則在提供的延伸 XML 標記中最多只能定義元素 A 的 2 個實例。

勾選無界限欄位,以指定不限制這個元素可出現在提供的延伸 XML 標記內的容許出現次數上限。

使用唯讀 DTD 近似值欄位,以檢視元素綱目文法與同等元素 DTD 文法近似的一對一對映。在本文件的元素詳細資料區段欄位標題下,說明了用來指定 DTD 近似值的表示法。

元素參照詳細資料區段動作

按一下參照欄位內的 element-name 超鏈結,以編輯這個區域元素參照所參照的廣域元素宣告的內容。當這個動作完成時,會在延伸點元素區段中選取所參照的元素節點,並且會啟動對應的元素詳細資料區段。

屬性詳細資料區段

這個區段可讓您編輯屬性的內容。屬性是用來提供元素的相關資訊。

您可在延伸點元素區段中選取必要屬性、選用屬性、類別屬性或資源屬性節點,來啟動這個區段。

指定列舉限制的字串類型必要屬性的屬性詳細資料區段。

屬性詳細資料區段 1

指定預設值的 boolean 類型選用屬性的屬性詳細資料區段。

屬性詳細資料區段 2

類別屬性的屬性詳細資料區段,其指出屬性值代表的類別必須延伸指定的類別及/或實作指定的介面。

屬性詳細資料區段 3

資源屬性的屬性詳細資料區段。

屬性詳細資料區段 4

使用綱目 ID 屬性

延伸點作者可以定義參照其他屬性的屬性。其作法是將延伸點屬性設定為類型 ID,並且選擇它所參照的屬性。舉例來說,像是 org.eclipse.ui.handlers 延伸點。commandId 屬性會參照 org.eclipse.ui.commands 延伸點中所定義的指令。

綱目 ID 用法

之後,提供處理程式的延伸開發人員可以從 commandId 屬性的所有有效 ID 中選取。一旦 ID 不存在,就會發出警告,以免發生 ID 拼錯的一般誤失。

屬性詳細資料區段欄位

編輯名稱欄位以指定屬性名稱。

按一下已淘汰欄位中的 true 按鈕或 false 按鈕,以指出該屬性是否已淘汰。外掛程式資訊清單編輯器將以警告來標示任何已淘汰的延伸 XML 標記(依預設)。這個欄位類似 Java 的 Javadoc @deprecated 標籤。

從使用欄位中選取一個值,指出是否必須在提供的延伸 XML 標記內,在屬性的定義元素上指定屬性。 下列選項可用:

請編輯預設值欄位,指定在提供的延伸 XML 標記內,當沒有在屬性的定義元素上指定屬性時,屬性所用的預設值。 唯有選取了使用欄位中的預設值時,這個欄位才適用。

從類型欄位中選取一值,以指定屬性值類型。 下列選項可用:

按一下可翻譯欄位中的 true 按鈕或 false 按鈕,以指出該屬性值是否可翻譯。唯有選取了類型欄位中的 string 值時,這個欄位才適用。如果屬性值是標示為可翻譯,則 PDE 工具可用於提供的延伸 XML 標記上,將這些值提出至內容檔,以獲得多國語言支援。

請利用限制欄位,檢視限制屬性用來作為本身的值的字串值清單。 如果該欄位不包含值,則對屬性值沒有限制。唯有選取了類型欄位中的 string 值時,這個欄位才適用。 附註:在所編輯綱目的文法中會使用字串基本類型的列舉限制來完成這項功能。

編輯延伸欄位,以便在目標平台的類別路徑上指定完整的類別名稱(例如 org.eclipse.ui.part.EditorPart),其必須由指定為屬性值的類別予以子類別化。PDE 將在提供的延伸 XML 標記中驗證類別屬性值,以確保它延伸了超類別。唯有選取了類型欄位中的 java 值時,這個欄位才適用。

編輯實作欄位,以便在目標平台的類別路徑上指定完整的介面名稱(例如 org.eclipse.ui.IEditorPart),其必須由指定為屬性值的類別進行實作。PDE 將在提供的延伸 XML 標記中驗證類別屬性值,以確保它實作該介面。唯有選取了類型欄位中的 java 值時,這個欄位才適用。

屬性詳細資料區段動作

按一下限制欄位中的新增... 按鈕,以開啟新限制對話框,在屬性值中新增限制。完成這個對話框之後,新限制會新增到限制屬性用來作為本身的值的字串值清單中。 唯有選取了類型欄位中的 string 值時,才可使用這個動作。

在限制欄位中選取一字串值,按一下移除按鈕,從限制屬性用來作為本身的值之字串值清單中,移除一項限制。 唯有選取了類型欄位中的 string 值時,才可使用這個動作。

如果延伸欄位中指定的值參照目標平台類別路徑上的完整類別名稱,則按一下延伸超鏈結,會在新的 Java 程式碼編輯器中開啟該類別。 否則,按一下延伸超鏈結將開啟新建 Java 類別精靈,它可讓您建立新類別。 唯有選取了類型欄位中的 java 值時,才可使用這個動作。

如果實作欄位中指定的值參照目標平台類別路徑上的完整介面名稱,則按一下實作超鏈結,會在新的 Java 程式碼編輯器中開啟該介面。否則,按一下實作超鏈結將開啟新建 Java 類別精靈,它可讓您建立新介面。唯有選取了類型欄位中的 java 值時,才可使用這個動作。

按一下瀏覽... 按鈕以開啟選取類型對話框,以選取目標平台類別路徑上的現有類別作為延伸欄位的值。唯有選取了類型欄位中的 java 值時,才可使用這個動作。

按一下瀏覽... 按鈕以開啟選取類型對話框,以選取目標平台類別路徑上的現有介面作為實作欄位的值。唯有選取了類型欄位中的 java 值時,才可使用這個動作。

相關鏈結