blob: 6b7015d9b1b054e6a51d04af6f66e63e0107baa6 [file] [log] [blame]
/*******************************************************************************
* Copyright (c) 2000, 2018 IBM Corporation and others.
*
* This program and the accompanying materials
* are made available under the terms of the Eclipse Public License 2.0
* which accompanies this distribution, and is available at
* https://www.eclipse.org/legal/epl-2.0/
*
* SPDX-License-Identifier: EPL-2.0
*
* Contributors:
* IBM Corporation - initial API and implementation
* Kiryl Kazakevich, Intel - bug 88359
* Tonny Madsen, RCP Company - bug 201055
* Mark Hoffmann <mark.hoffmann@web.de> - Fix for bug 84603
* Lars Vogel <Lars.Vogel@vogella.com> - Bug 440136
*******************************************************************************/
package org.eclipse.ui;
import org.eclipse.swt.SWT;
/**
* Preference ids exposed by the Eclipse Platform User Interface. These
* preference settings can be obtained from the UI plug-in's preference store.
* <p>
* <b>Note:</b>This interface should not be implemented or extended.
* </p>
*
* @see PlatformUI#PLUGIN_ID
* @see PlatformUI#getPreferenceStore()
* @noimplement This interface is not intended to be implemented by clients.
* @noextend This interface is not intended to be extended by clients.
*/
public interface IWorkbenchPreferenceConstants {
/**
* A named preference for whether to show an editor when its input file is
* selected in the Navigator (and vice versa).
* <p>
* Value is of type <code>boolean</code>.
* </p>
*/
String LINK_NAVIGATOR_TO_EDITOR = "LINK_NAVIGATOR_TO_EDITOR"; //$NON-NLS-1$
/**
* A named preference for how a new perspective is opened.
* <p>
* Value is of type <code>String</code>. The possible values are defined by
* <code>OPEN_PERSPECTIVE_WINDOW, OPEN_PERSPECTIVE_PAGE and
* OPEN_PERSPECTIVE_REPLACE</code>.
* </p>
*
* @see #OPEN_PERSPECTIVE_WINDOW
* @see #OPEN_PERSPECTIVE_PAGE
* @see #OPEN_PERSPECTIVE_REPLACE
* @see #NO_NEW_PERSPECTIVE
*/
String OPEN_NEW_PERSPECTIVE = "OPEN_NEW_PERSPECTIVE"; //$NON-NLS-1$
/**
* A named preference for how a new perspective is opened when the alternate key
* modifiers are pressed. The alternate key modifiers are platform dependent.
* <p>
* Value is of type <code>String</code>. The possible values are defined by
* <code>OPEN_PERSPECTIVE_WINDOW, OPEN_PERSPECTIVE_PAGE and
* OPEN_PERSPECTIVE_REPLACE</code>.
* </p>
*
* @deprecated Workbench no longer supports alternate key modifier to open a new
* perspective. Callers should use IWorkbench.showPerspective
* methods.
*/
@Deprecated
String ALTERNATE_OPEN_NEW_PERSPECTIVE = "ALTERNATE_OPEN_NEW_PERSPECTIVE"; //$NON-NLS-1$
/**
* A named preference for how a new perspective is opened when the shift key
* modifier is pressed.
* <p>
* Value is of type <code>String</code>. The possible values are defined by
* <code>OPEN_PERSPECTIVE_WINDOW, OPEN_PERSPECTIVE_PAGE and
* OPEN_PERSPECTIVE_REPLACE</code>.
* </p>
*
* @deprecated Workbench no longer supports shift key modifier to open a new
* perspective. Callers should use IWorkbench.showPerspective
* methods.
*/
@Deprecated
String SHIFT_OPEN_NEW_PERSPECTIVE = "SHIFT_OPEN_NEW_PERSPECTIVE"; //$NON-NLS-1$
/**
* A named preference for how a new perspective should be opened when a new
* project is created.
* <p>
* Value is of type <code>String</code>. The possible values are defined by the
* constants <code>OPEN_PERSPECTIVE_WINDOW, OPEN_PERSPECTIVE_PAGE,
* OPEN_PERSPECTIVE_REPLACE, and NO_NEW_PERSPECTIVE</code>.
* </p>
*
* @see #OPEN_PERSPECTIVE_WINDOW
* @see #OPEN_PERSPECTIVE_PAGE
* @see #OPEN_PERSPECTIVE_REPLACE
* @see #NO_NEW_PERSPECTIVE
* @deprecated in 3.0. This preference is IDE-specific, and is therefore found
* only in IDE configurations. IDE-specific tools should use
* <code>org.eclipse.ui.ide.IDE.Preferences.PROJECT_OPEN_NEW_PERSPECTIVE</code>
* instead.
*/
@Deprecated
String PROJECT_OPEN_NEW_PERSPECTIVE = "PROJECT_OPEN_NEW_PERSPECTIVE"; //$NON-NLS-1$
/**
* A preference value indicating that an action should open a new perspective in
* a new window.
*
* @see #PROJECT_OPEN_NEW_PERSPECTIVE
*/
String OPEN_PERSPECTIVE_WINDOW = "OPEN_PERSPECTIVE_WINDOW"; //$NON-NLS-1$
/**
* A preference value indicating that an action should open a new perspective in
* a new page.
*
* @see #PROJECT_OPEN_NEW_PERSPECTIVE
* @deprecated Opening a Perspective in a new page is no longer supported
* functionality as of 2.0.
*/
@Deprecated
String OPEN_PERSPECTIVE_PAGE = "OPEN_PERSPECTIVE_PAGE"; //$NON-NLS-1$
/**
* A preference value indicating that an action should open a new perspective by
* replacing the current perspective.
*
* @see #PROJECT_OPEN_NEW_PERSPECTIVE
*/
String OPEN_PERSPECTIVE_REPLACE = "OPEN_PERSPECTIVE_REPLACE"; //$NON-NLS-1$
/**
* A preference value indicating that an action should not open a new
* perspective.
*
* @see #PROJECT_OPEN_NEW_PERSPECTIVE
*/
String NO_NEW_PERSPECTIVE = "NO_NEW_PERSPECTIVE"; //$NON-NLS-1$
/**
* A named preference indicating the default workbench perspective.
*/
String DEFAULT_PERSPECTIVE_ID = "defaultPerspectiveId"; //$NON-NLS-1$
/**
* A named preference indicating where the perspective bar should be docked. The
* default value (when this preference is not set) is <code>TOP_RIGHT</code>.
* <p>
* This preference may be one of the following values: {@link #TOP_RIGHT},
* {@link #TOP_LEFT}, or {@link #LEFT}.
* </p>
*
* @since 3.0
*/
String DOCK_PERSPECTIVE_BAR = "DOCK_PERSPECTIVE_BAR"; //$NON-NLS-1$
/**
* A preference indication the initial size of the perspective bar. The default
* value is 160. This preference only works when
* <code>configurer.setShowPerspectiveBar(true)</code> is set in
* WorkbenchWindowAdvisor#preWindowOpen()
*
* This preference only uses integer values bug 84603: [RCP] [PerspectiveBar]
* New API or pref to set default perspective bar size
*
* @since 3.5
*/
String PERSPECTIVE_BAR_SIZE = "PERSPECTIVE_BAR_SIZE"; //$NON-NLS-1$
/**
* A named preference indicating where the fast view bar should be docked in a
* fresh workspace. This preference is meaningless after a workspace has been
* setup, since the fast view bar state is then persisted in the workbench. This
* preference is intended for applications that want the initial docking
* location to be somewhere specific. The default value (when this preference is
* not set) is the bottom.
*
* @see #LEFT
* @see #BOTTOM
* @see #RIGHT
* @since 3.0
*/
String INITIAL_FAST_VIEW_BAR_LOCATION = "initialFastViewBarLocation"; //$NON-NLS-1$
/**
* Constant to be used when referring to the top right of the workbench window.
*
* @see #DOCK_PERSPECTIVE_BAR
* @since 3.0
*/
String TOP_RIGHT = "topRight"; //$NON-NLS-1$
/**
* Constant to be used when referring to the top left of the workbench window.
*
* @see #DOCK_PERSPECTIVE_BAR
* @since 3.0
*/
String TOP_LEFT = "topLeft"; //$NON-NLS-1$
/**
* Constant to be used when referring to the left side of the workbench window.
*
* @see #DOCK_PERSPECTIVE_BAR
* @see #INITIAL_FAST_VIEW_BAR_LOCATION
* @since 3.0
*/
String LEFT = "left"; //$NON-NLS-1$
/**
* Constant to be used when referring to the bottom of the workbench window.
*
* @see #INITIAL_FAST_VIEW_BAR_LOCATION
* @since 3.0
*/
String BOTTOM = "bottom"; //$NON-NLS-1$
/**
* Constant to be used when referring to the right side of the workbench window.
*
* @see #INITIAL_FAST_VIEW_BAR_LOCATION
* @since 3.0
*/
String RIGHT = "right"; //$NON-NLS-1$
/**
* A named preference indicating whether the workbench should show the
* introduction component (if available) on startup.
*
* <p>
* The default value for this preference is: <code>true</code> (show intro)
* </p>
*
* @see org.eclipse.ui.application.WorkbenchWindowAdvisor#openIntro()
* @since 3.0
*/
String SHOW_INTRO = "showIntro"; //$NON-NLS-1$
/**
* A named preference for whether the workbench should show traditional style
* tabs in editors and views.
*
* Boolean-valued: <code>true</code> if editors and views should use a
* traditional style of tab and <code>false</code> if editors should show new
* style tab (3.0 style)
* <p>
* The default value for this preference is: <code>true</code>
* </p>
*
* @deprecated not supported since the 4.x migration
* @since 3.0
*/
@Deprecated
String SHOW_TRADITIONAL_STYLE_TABS = "SHOW_TRADITIONAL_STYLE_TABS"; //$NON-NLS-1$
/**
* A named preference for whether the workbench should show text on the
* perspective bar.
*
* Boolean-valued: <code>true</code>, if editors should show text on the
* perspective bar, <code>false</code> otherwise.
* <p>
* The default value for this preference is: <code>true</code> (show text on the
* perspective bar)
* </p>
*
* @since 3.0
*/
String SHOW_TEXT_ON_PERSPECTIVE_BAR = "SHOW_TEXT_ON_PERSPECTIVE_BAR"; //$NON-NLS-1$
/**
* A named preference for whether the workbench should show text on the find
* actions bar.
*
* Boolean-valued: <code>true</code>, if the application should show text on the
* find action bar, <code>false</code> otherwise.
* <p>
* The default value for this preference is: <code>false</code> (do not show
* text on the find actions bar)
* </p>
*
* @since 3.117
*/
String SHOW_TEXT_ON_QUICK_ACCESS = "SHOW_TEXT_ON_QUICK_ACCESS"; //$NON-NLS-1$
/**
* A named preference for whether the workbench should show the "open
* perspective" button on the perspective bar.
*
* Boolean-valued: <code>true</code>, if editors should show "open perspective"
* button on the perspective bar, <code>false</code> otherwise.
* <p>
* The default value for this preference is: <code>true</code> (show "open
* perspective" button on the perspective bar)
* </p>
*
* @since 3.4
*/
String SHOW_OPEN_ON_PERSPECTIVE_BAR = "SHOW_OPEN_ON_PERSPECTIVE_BAR"; //$NON-NLS-1$
/**
* A named preference for whether the workbench should show the "Other..." menu
* item in the perspective menu.
*
* Boolean-valued: <code>true</code>, if editors should show text on the
* "Other..." menu item, <code>false</code> otherwise.
* <p>
* The default value for this preference is: <code>true</code> (show the
* "Other..." menu item in the perspective menu)
* </p>
*
* @since 3.4
*/
String SHOW_OTHER_IN_PERSPECTIVE_MENU = "SHOW_OTHER_IN_PERSPECTIVE_MENU"; //$NON-NLS-1$
/**
* A named preference for the text of the Help Contents action.
*
* String-valued. If not specified, <code>"&amp;Help Contents"</code> is used.
* <p>
* The default value for this preference is: <code>null</code>
* </p>
*
* @since 3.0
*/
String HELP_CONTENTS_ACTION_TEXT = "helpContentsActionText"; //$NON-NLS-1$
/**
* A named preference for the text of the Help Search action.
*
* String-valued. If not specified, <code>"S&amp;earch"</code> is used.
* <p>
* The default value for this preference is: <code>null</code>
* </p>
*
* @since 3.1
*/
String HELP_SEARCH_ACTION_TEXT = "helpSearchActionText"; //$NON-NLS-1$
/**
* A named preference for the text of the Dynamic Help action.
*
* String-valued. If not specified, <code>"&amp;Dynamic Help"</code> is used.
* <p>
* The default value for this preference is: <code>null</code>
* </p>
*
* @since 3.1
*/
String DYNAMIC_HELP_ACTION_TEXT = "dynamicHelpActionText"; //$NON-NLS-1$
/**
* A named preference for enabling animations when a layout transition occurs
* <p>
* The default value for this preference is: <code>true</code> (show animations
* when a transition occurs)
* </p>
*
* @since 3.1
*/
String ENABLE_ANIMATIONS = "ENABLE_ANIMATIONS"; //$NON-NLS-1$
/**
* A named preference that view implementors can used to determine whether or
* not they should utilize colored labels.
*
* <p>
* The default value for this preference is: <code>true</code> (show colored
* labels)
* </p>
*
* @since 3.4
*/
String USE_COLORED_LABELS = "USE_COLORED_LABELS"; //$NON-NLS-1$
/**
* <p>
* Workbench preference id for the key configuration identifier to be treated as
* the default.
* </p>
* <p>
* The default value for this preference is
* <code>"org.eclipse.ui.defaultAcceleratorConfiguration"</code>.
* <p>
*
* @since 3.1
*/
String KEY_CONFIGURATION_ID = "KEY_CONFIGURATION_ID"; //$NON-NLS-1$
/**
* <p>
* Workbench preference identifier for the minimum width of editor tabs. By
* default, Eclipse does not define this value and allows SWT to determine this
* constant. We use <code>-1</code> internally to signify "use default".
* </p>
* <p>
* The default value for this preference is <code>-1</code>.
* </p>
*
* @since 3.1
*/
String EDITOR_MINIMUM_CHARACTERS = "EDITOR_MINIMUM_CHARACTERS"; //$NON-NLS-1$
/**
* <p>
* Workbench preference identifier for the minimum width of view tabs.
* </p>
* <p>
* The default value for this preference is <code>1</code>.
* </p>
*
* @since 3.2
*/
String VIEW_MINIMUM_CHARACTERS = "VIEW_MINIMUM_CHARACTERS"; //$NON-NLS-1$
/**
* Stores whether or not system jobs are being shown.
*
* @since 3.1
*/
String SHOW_SYSTEM_JOBS = "SHOW_SYSTEM_JOBS";//$NON-NLS-1$
/**
* Workbench preference for the current theme.
*
* @since 3.1
*/
String CURRENT_THEME_ID = "CURRENT_THEME_ID"; //$NON-NLS-1$
/**
* A preference value indicating whether editors should be closed before saving
* the workbench state when exiting. The default is <code>false</code>.
*
* @since 3.1
*/
String CLOSE_EDITORS_ON_EXIT = "CLOSE_EDITORS_ON_EXIT"; //$NON-NLS-1$
/**
* Stores whether or not to show progress while starting the workbench. The
* default is <code>false</code>.
*
* @since 3.1
*/
String SHOW_PROGRESS_ON_STARTUP = "SHOW_PROGRESS_ON_STARTUP"; //$NON-NLS-1$
/**
* Stores whether or not to show the memory monitor in the workbench window.
*
* @since 3.1
*/
String SHOW_MEMORY_MONITOR = "SHOW_MEMORY_MONITOR"; //$NON-NLS-1$
/**
* Stores whether or not to use the window working set as the default working
* set for newly created views (without previously stored state). This is a hint
* that view implementors should honor.
*
* @since 3.2
*/
String USE_WINDOW_WORKING_SET_BY_DEFAULT = "USE_WINDOW_WORKING_SET_BY_DEFAULT"; //$NON-NLS-1$
/**
* Stores whether or not to show the text widget that allows type-ahead search
* in the case where a FilteredTree is used to display and filter tree items.
*
* @since 3.2
*/
String SHOW_FILTERED_TEXTS = "SHOW_FILTERED_TEXTS"; //$NON-NLS-1$
/**
* Stores whether or not views may be detached. The default is
* <code>true</code>.
*
* @since 3.2
*/
String ENABLE_DETACHED_VIEWS = "ENABLE_DETACHED_VIEWS"; //$NON-NLS-1$
/**
* Stores whether or not the workbench prompts for saving when a dirty editor or
* view is closed, but the Saveable objects are still open in other parts. If
* <code>true</code> (default), the user will be prompted. If
* <code>false</code>, there will be no prompt.
*
* @see Saveable
* @since 3.2
*/
String PROMPT_WHEN_SAVEABLE_STILL_OPEN = "PROMPT_WHEN_SAVEABLE_STILL_OPEN"; //$NON-NLS-1$
/**
* Lists the extra perspectives to show in the perspective bar. The value is a
* comma-separated list of perspective ids. The default is the empty string.
*
* @since 3.2
*/
String PERSPECTIVE_BAR_EXTRAS = "PERSPECTIVE_BAR_EXTRAS"; //$NON-NLS-1$
/**
* Allows locking the trim to prevent user dragging on startup. The default is
* <code>false</code>.
*
* @since 3.2
*/
String LOCK_TRIM = "LOCK_TRIM"; //$NON-NLS-1$
/**
* A named preference for providing the 3.3 presentation's min/max behaviour
* <p>
* The default value for this preference is: <code>false</code>; use the 3.2
* behaviour.
* </p>
*
* @since 3.3
*/
String ENABLE_NEW_MIN_MAX = "ENABLE_MIN_MAX"; //$NON-NLS-1$
/**
* A named preference for disabling opening a new fast view from the fast view
* bar controls ("Show View as a fast view" button or "New Fast View" submenu).
* <p>
* Value is of type <code>boolean</code>.
* </p>
* <p>
* The default is <code>false</code>.
* </p>
*
* @since 3.3
*/
String DISABLE_NEW_FAST_VIEW = "disableNewFastView"; //$NON-NLS-1$
/**
* A named preference for enabling the 3.2 behavior for closing sticky views.
* When not enabled a sticky view is closed in all perspectives when the view is
* closed.
* <p>
* The default value for this preference is: <code>false</code>; use the 3.2
* behaviour.
* </p>
*
* @since 3.3
*/
String ENABLE_32_STICKY_CLOSE_BEHAVIOR = "ENABLE_32_STICKY_CLOSE_BEHAVIOR"; //$NON-NLS-1$
/**
* An named preference for whether or not tabs are on the top or bottom for
* views. Values are either {@link SWT#TOP} or {@link SWT#BOTTOM}.
* <p>
* The default value for this preference is: <code>SWT.TOP</code>.
* </p>
*
* @since 3.4
*/
String VIEW_TAB_POSITION = "VIEW_TAB_POSITION"; //$NON-NLS-1$
/**
* An named preference for whether or not tabs are on the top or bottom for
* editors. Values are either {@link SWT#TOP} or {@link SWT#BOTTOM}.
* <p>
* The default value for this preference is: <code>SWT.TOP</code>.
* </p>
*
* @since 3.4
*/
String EDITOR_TAB_POSITION = "EDITOR_TAB_POSITION"; //$NON-NLS-1$
/**
* Workbench preference id for whether the workbench should show multiple editor
* tabs.
*
* Boolean-valued: <code>true</code> if editors should show multiple editor
* tabs, and <code>false</code> if editors should show a single editor tab.
* <p>
* The default value for this preference is: <code>true</code>
* </p>
*
* @since 3.4
*/
String SHOW_MULTIPLE_EDITOR_TABS = "SHOW_MULTIPLE_EDITOR_TABS"; //$NON-NLS-1$
/**
* Workbench preference id for whether the workbench may open editors in-place.
* Note that editors will only be opened in-place if this preference is
* <code>false</code> and if the current platform supports in-place editing.
*
* Boolean-valued: <code>false</code> if editors may be opened in-place, and
* <code>true</code> if editors should never be opened in-place.
* <p>
* The default value for this preference is: <code>false</code>
* </p>
*
* @since 3.4
*/
String DISABLE_OPEN_EDITOR_IN_PLACE = "DISABLE_OPEN_EDITOR_IN_PLACE"; //$NON-NLS-1$
/**
* Workbench preference id for indicating the size of the list of most recently
* used working sets.
* <p>
* Integer-valued. The default value for this preference is: <code>5</code>.
* </p>
*
* @since 3.7
*/
String RECENTLY_USED_WORKINGSETS_SIZE = "RECENTLY_USED_WORKINGSETS_SIZE"; //$NON-NLS-1$
/**
* Workbench preference id for hiding the quick access search field per default.
* <p>
* Boolean-valued. The default value for this preference is: <code>false</code>.
* </p>
*
* @since 3.112
*/
String HIDE_QUICK_ACCESS_PER_DEFAULT = "hideQuickAccessPerDefault"; //$NON-NLS-1$
/**
* <p>
* Whether to use inline or dialog rename on resources.
* </p>
*
* @since 3.118
*/
String RESOURCE_RENAME_MODE = "RESOURCE_RENAME_MODE"; //$NON-NLS-1$
/**
* <p>
* Preference value for {@link #RESOURCE_RENAME_MODE}, indicating that
* inline rename should be used.
* </p>
*
* @since 3.118
*/
String RESOURCE_RENAME_MODE_INLINE = "inline"; //$NON-NLS-1$
/**
* <p>
* Preference value for {@link #RESOURCE_RENAME_MODE}, indicating that
* dialog rename should be used.
* </p>
*
* @since 3.118
*/
String RESOURCE_RENAME_MODE_DIALOG = "dialog"; //$NON-NLS-1$
}