延伸頁面

使用「延伸」頁面瀏覽和編輯外掛程式延伸。 延伸是對平台提供行為的主要機制。 除非您的外掛程式是其他外掛程式可使用的簡單 Java API 程式庫,否則會以延伸項 目來提供新的行為。

外掛程式提供它們需要的外掛程式所定義的延伸點。延伸語法必須 符合延伸點定義才能正確處理。 PDE 透過遍訪所有可見的外掛程式(工作區和外部)計算合格延伸點清單總計。

PDE 提供的通用延伸精靈只掃描延伸點。如果有提供延伸綱目(請參閱延伸點綱目),那麼精靈會從綱目擷 取文法和延伸點 meta 資料。

除了通用精靈之外,有數個可用的延伸項目範本。 這些是相同的範本,可用來產生外掛程式專案的起始內容。 他們的存在讓您可以安排延伸項目的建立。 您可以使用簡單檢視畫面建立外掛程式,然後新增編輯器或精靈。

範例:新增動作集延伸

為了說明「延伸」頁面的作業,我們會將 'Hello, PDE world' 動作新增至外掛 程式。 我們會提供 org.eclipse.ui.actionSets 延伸點。這個範例假設您熟悉延伸點。

第一步是按新增...按鈕選取延伸精靈:

延伸精靈選項

綱目型延伸精靈是預設值,因為它使用最常見的方式處理 延伸。 它會掃描外掛程式並提供找到的所有延伸點(有或沒有綱目)。 含有綱目的延伸點允許 PDE 提供更好的協助。 如果遺漏延伸點綱目,那麼 PDE 可讓您將元素和屬性新增至延伸,但是如果對於選 取的延伸點來說這些元素和屬性有效,則無法驗證延伸。

下一步,就會提供延伸點清單。選取 org.eclipse.ui.actionSets 並按 完成

綱目為準的精靈 - 延伸點選項

精靈會將新延伸新增至延伸清單。 因為這個延伸有一個相關聯的綱目,所以我們可以進一步編輯延伸定義。 我們選取新增加的延伸並從蹦現功能表選取新建->動作集。 這個 XML 元素已定義為可以顯示在延伸定義中的唯一有效元素。

對於所有必要的屬性來說,PDE 會建立預設值。我們可以 變更動作集的預設名稱成為 "Sample Action Set",方法是選取元素並在 「內容」檢視畫面變更標籤內容。 新名稱會顯示在延伸清單。

延伸編輯器頁面

現在我們需要定義動作集的功能表和動作。 如果選取動作集並在 "Extension Element Children" 區段蹦現功能表, 那麼「新建」功能表會提供兩個選項: 功能表和動作。這些 選項依據動作集延伸的綱目資訊。首先,我們建立功能表。

  1. 選取新建->功能表建立功能表。
  2. 選取它並變更它的內容。變更 ID 成為 "sampleMenu",變更它的標籤成為 "Sample Menu。"
  3. 仍選取功能表物件時,將蹦現一個功能表,請選取新建->分隔字元。 應該出現新子項。
  4. 選取「分隔字元」並變更它的名稱成為 "sampleGroup"。 這樣會在功能表中建立可用來提供動作的具名群組。

我們可以採取類似方法建立動作:

  1. 選取新建->動作建立動作。
  2. 選取它並變更它的內容。變更它的標籤成為 "&Sample Action",變更它的功能表列路徑成為 "sampleMenu/sampleGroup" 。 這樣會新增動作到剛才定義的功能表。

我們需要設定的最後一項是動作的 Java 類別。 延伸點定義指定動作必須實作  IWorkbenchWindowActionDelegate 。PDE 可以提供協助,因為它從綱目知道這個資訊:

  1. 按一下類別內容使它進入編輯模式。 選取按鈕開啟資料格編輯器對話框。
  2. 選取圓鈕建立新類別。
  3. 按一下瀏覽按鈕,選取來源儲存器並選取「XYZ 外掛程式」。
  4. 變更類別名稱成為 "SampleAction"。

完成之前,對話框應該如下:

Java 屬性編輯器

完成時,會依據必要的介面(含有每一種抽象方法的 Stub 實作) 產生新類別。 此外,會為類別內容值設定新類別的名稱。 依預設精靈也會開啟要編輯的新 Java 類別。您可以尋找 "run" 方法並 新增下列陳述式:

      System.out.println("Hello, PDE world!");

儲存新的原始碼並關閉 Java 編輯器。然後返回 Manifest 編輯器的「延伸」頁面並儲存。

執行外掛程式時我們會繼續這 個範例。

 
Copyright IBM Corporation and others 2000, 2003