當 Readme 檔編輯器擁有焦點時,會出現一個稱為 Readme 的下拉功能表。它含有先前所說明的動作:Readme 編輯器動作 1、Readme 編輯器動作 2、Readme 編輯器動作 3。
副檔名為 .readme 的檔案可拆開成為若干區段,每個區段的開頭都是一個數字。 例如,如果在 Readme 檔編輯器中輸入下列文字,Readme 工具會偵測到兩個區段。 如果要知道 Readme 工具是如何偵測區段的,請在 Readme 檔編輯器中輸入若干文字, 按 Ctrl-S 或選取「檔案 -> 儲存」來儲存檔案。 請開啟「Readme 區段」檢視畫面,並在「導覽器」檢視畫面中選取 .readme 檔。
範例文字:
99.1 這是我的第一個區段
這是我的第一個區段中的部份文字。
99.1.1 這是一個子區段
這是我的子區段中的部份文字。
您可以在「概要」檢視畫面中選取一個區段,將選項拖到文字檔上,以瞭解拖放功能。 選項內容會附加到檔案中。
這個範例也提供外掛程式中所宣告的延伸點。 任何使用這個範例所定義 org.eclipse.ui.examples.readmetool.sectionParser 延伸項目的外掛程式都需要 IReadmeFileParser 類別。 DefaultSectionParser 類別是 IReadmeFileParser 的實作範例。
ReadmeEditor 類別實作 IEditorPart,且在 plug.xml 中,利用 org.eclipse.ui.editors 延伸點定義為含 .readme 副檔名的檔案所用的編輯器。 ReadmeSectionsView 類別實作 IViewPart,且定義為使用 org.eclipse.ui.views 延伸點的檢視畫面。 這個延伸點也定義檢視畫面選項中所用之檢視畫面的種類。
這個範例中定義了兩類型的喜好設定:工作台喜好設定和資源內容。 工作台喜好設定定義在實作 IWorkbenchPreferencePage 的 ReadmePreferencePage 類別中,因此,它會新增到「工作台 -> 喜好設定」對話框中。 類別定義在 plugin.xml 中的 org.eclipse.ui.preferencePages 延伸點中。 兩個資源內容分別是 ReadmeFilePropertyPage 和 ReadmeFilePropertyPage2,它們都實作 IWorkbenchPropertyPage。 它們都定義成由 org.eclipse.ui.propertyPages 延伸點中的 plugin.xml 其中的 objectClass,就 IFile 類型來進行呼叫。
ReadmeCreationWizard 類別會實作 INewWizard,且會定義在 plugin.xml 中的 org.eclipse.ui.newWizards 延伸點中。 這個延伸點也會定義使用者選取「檔案 -> 新建 -> 其他...」時所顯示的精靈種類。
這個範例中加入了若干動作 Stub。 動作集宣告一個要利用 org.eclipse.ui.actionSets 延伸點併入工作台視窗功能表列且標籤為 Readme 檔編輯器的功能表。 它也利用 toolbarPath 和 menubarPath 這兩個標示來定義了工作台工具列和功能表列的動作。 它利用實作 IWorkbenchWindowActionDelegate 的 WindowActionDelegate 類別來實作動作。 蹦現功能表的動作由 PopupMenuActionDelegate 類別在 org.eclipse.ui.popupMenus 延伸點中定義為 objectContribution。 PopupMenuActionDelegate 實作 IObjectActionDelegate 並利用所提供的 IWorkbenchPart 來開啟訊息對話框。 檢視畫面動作 ViewActionDelegate 定義在 org.eclipse.ui.viewActions 延伸點中且會實作 IViewActionDelegate。 它所在的檢視畫面是 targetID 標示所定義的,在這個範例中,是 org.eclipse.ui.views.ResourceNavigator。 編輯器動作是實作 IEditorActionDelegate 的 EditorActionDelegate 類別所定義,是利用 org.eclipse.ui.editorActions 延伸點來新增的。 它所適用的編輯器由 targetID 標示來定義,在這個範例中,是定義在 org.eclipse.ui.examples.readmetool.ReadmeEditor 中。
ReadmeDropActionDelegate 類別實作 IDropDelegate。 每次工作台執行放下動作時,都會通知 IDropDelegates。 這個動作的延伸點是 org.eclipse.ui.dropActions。