Class WorkbenchAdvisor的部分译文

最新推荐文章于 2022-04-09 11:15:26 发布

seawavecau

最新推荐文章于 2022-04-09 11:15:26 发布

阅读量899

点赞数

分类专栏：技术原创文章标签： class exception 工作 initialization string shell

技术原创专栏收录该内容

24 篇文章 0 订阅

订阅专栏

org.eclipse.ui.application
Class WorkbenchAdvisor

java.lang.Object
  org.eclipse.ui.application.WorkbenchAdvisor

public abstract class WorkbenchAdvisor extends Object

Public base class for configuring the workbench.

注意，工作台引导器( workbench advisor)对象先于工作台( workbench )被创建。尽管如此，使用PlatformUI.getWorkbench 确保已经完全初始化。

创建并运行Workbench(在IPlatformRunnab中)的示例:

 
 public class MyApplication implements IPlatformRunnable {
   public Object run(Object args) {
     WorkbenchAdvisor workbenchAdvisor = new MyWorkbenchAdvisor();
     Display display = PlatformUI.createDisplay();
     int returnCode = PlatformUI.createAndRunWorkbench(display, workbenchAdvisor);
     if (returnCode == PlatformUI.RETURN_RESTART) {
        return IPlatformRunnable.EXIT_RESTART;
     } else {
        return IPlatformRunnable.EXIT_OK;
   }
 }

应用程序应该继承自WorkbenchAdvisor类，并覆写方法使工作台的配置符合特殊应用的需求。
以下的引导方法在工作台(workbench)的生命周期的关键点被调用(在动态调用PlatformUI.createAndRunWorkbench时，全部都触发.)

initialize – 在所有窗体之前最先调用，可用于注册实体。
preStartup – 在initialize之后但在第一个打开窗体之前调用，可用于在启动或恢复时临时禁用实体。
postStartup – 在preStartup之后但在第一个打开窗体之前调用，可用于重新启用上一步骤禁用的实体。
postRestore – 在工作台的窗体从先前保存的状态中恢复后调用。可用于调整恢复的工作台。
preWindowOpen – 在窗体打开之前调用，用于配置窗体的外貌除了工具条（菜单、工具条等）。
fillActionBars – 在preWindowOpen后调用，用来配置窗体的工具条。
postWindowRestore - 在窗体从先前保存的状态或从一个初始的状态中恢复后调用，用于调整窗体。
postWindowCreate – 在窗体从一个初始的状态或从一个恢复的状态中创建后调用，用于调整窗体。
openIntro – 打开窗体前调用，为了创建介绍组件。
postWindowOpen – 在窗体打开后调用，可用于调用窗体监听器或其他。
preWindowShellClose – 在窗体的Shell被用户关闭后调用，用来关闭屏幕窗体。
eventLoopException – 当事件循环（Event Loop）崩溃时用来操作异常事件，用来通知用户出现问题了。
eventLoopIdle – 当当前没有可以处理的事件时调用，用来执行其他工作或挂起直到新的时间进入了队列。
preShutdown – 在事件循环终止后窗体被关闭前调用，用来注销在初始化时注册的实体。
postShutdown –在事件循环终止且所有的窗体都被关闭后最后调用，用来注销在初始化时注册的实体。

Since:

3.0

字段摘要
`static int`	`FILL_COOL_BAR` Deprecated. use `instead`
`static int`	`FILL_MENU_BAR` Deprecated. use `instead`
`static int`	`FILL_PROXY` Deprecated. use `instead`
`static int`	`FILL_STATUS_LINE` Deprecated. use `instead`

构造方法摘要
`protected`	`WorkbenchAdvisor()` Creates and initializes a new workbench advisor instance.

方法摘要
`void`	`createWindowContents(IWorkbenchWindowConfigurer configurer, Shell shell)` Deprecated. since 3.1, override `WorkbenchWindowAdvisor.createWindowContents(Shell)` instead
`WorkbenchWindowAdvisor`	`createWorkbenchWindowAdvisor(IWorkbenchWindowConfigurer configurer)` Creates a new workbench window advisor for configuring a new workbench window via the given workbench window configurer.
`void`	`eventLoopException(Throwable exception)` Performs arbitrary actions when the event loop crashes (the code that handles a UI event throws an exception that is not caught).
`void`	`eventLoopIdle(Display display)` Performs arbitrary work or yields when there are no events to be processed.
`void`	`fillActionBars(IWorkbenchWindow window, IActionBarConfigurer configurer, int flags)` Deprecated. since 3.1, override `ActionBarAdvisor.fillActionBars(int)` instead
`IAdaptable`	`getDefaultPageInput()` Returns the default input for newly created workbench pages when the input is not explicitly specified.
`abstract String`	`getInitialWindowPerspectiveId()` Returns the id of the perspective to use for the initial workbench window, or `null` if no initial perspective should be shown in the initial workbench window.
`String`	`getMainPreferencePageId()` Returns the id of the preference page that should be presented most prominently.
`protected IWorkbenchConfigurer`	`getWorkbenchConfigurer()` Returns the workbench configurer for the advisor.
`void`	`initialize(IWorkbenchConfigurer configurer)` Performs arbitrary initialization before the workbench starts running.
`void`	`internalBasicInitialize(IWorkbenchConfigurer configurer)` Remembers the configurer and calls `initialize`.
`boolean`	`isApplicationMenu(IWorkbenchWindowConfigurer configurer, String menuId)` Deprecated. since 3.1, override `ActionBarAdvisor.isApplicationMenu(String)` instead
`void`	`openIntro(IWorkbenchWindowConfigurer configurer)` Deprecated. since 3.1, override `WorkbenchWindowAdvisor.openIntro()` instead
`boolean`	`openWindows()` Opens the workbench windows on startup.
`void`	`postShutdown()` Performs arbitrary finalization after the workbench stops running.
`void`	`postStartup()` Performs arbitrary actions after the workbench windows have been opened (or restored), but before the main event loop is run.
`void`	`postWindowClose(IWorkbenchWindowConfigurer configurer)` Deprecated. since 3.1, override `WorkbenchWindowAdvisor.postWindowClose()` instead
`void`	`postWindowCreate(IWorkbenchWindowConfigurer configurer)` Deprecated. since 3.1, override `WorkbenchWindowAdvisor.postWindowCreate()` instead
`void`	`postWindowOpen(IWorkbenchWindowConfigurer configurer)` Deprecated. since 3.1, override `WorkbenchWindowAdvisor.postWindowOpen()` instead
`void`	`postWindowRestore(IWorkbenchWindowConfigurer configurer)` Deprecated. since 3.1, override `WorkbenchWindowAdvisor.postWindowRestore()` instead
`boolean`	`preShutdown()` Performs arbitrary finalization before the workbench is about to shut down.
`void`	`preStartup()` Performs arbitrary actions just before the first workbench window is opened (or restored).
`void`	`preWindowOpen(IWorkbenchWindowConfigurer configurer)` Deprecated. since 3.1, override `WorkbenchWindowAdvisor.preWindowOpen()` instead
`boolean`	`preWindowShellClose(IWorkbenchWindowConfigurer configurer)` Deprecated. since 3.1, override `WorkbenchWindowAdvisor.preWindowShellClose()` instead
`IStatus`	`restoreState(IMemento memento)` Restores arbitrary application-specific state information for this workbench advisor.
`IStatus`	`saveState(IMemento memento)` Saves arbitrary application-specific state information for this workbench advisor.