projects/dwt-addons: dwtx/jface/action/ExternalActionManager.d annotate

annotate dwtx/jface/action/ExternalActionManager.d @ 90:7ffeace6c47f

Update 3.4M7 to 3.4

author	Frank Benoit <benoit@tionex.de>
date	Sun, 06 Jul 2008 23:30:07 +0200
parents	5df4896124c7
children	04b47443bb01

rev	line source
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	1 /*******************************************************************************
90 7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	2 * Copyright (c) 2000, 2008 IBM Corporation and others.
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	3 * All rights reserved. This program and the accompanying materials
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	4 * are made available under the terms of the Eclipse Public License v1.0
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	5 * which accompanies this distribution, and is available at
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	6 * http://www.eclipse.org/legal/epl-v10.html
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	7 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	8 * Contributors:
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	9 * IBM Corporation - initial API and implementation
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	10 * Port to the D programming language:
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	11 * Frank Benoit <benoit@tionex.de>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	12 *******************************************************************************/
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	13
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	14 module dwtx.jface.action.ExternalActionManager;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	15
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	16 import dwtx.jface.action.IAction;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	17
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	18 import tango.util.collection.HashMap;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	19 import tango.util.collection.HashSet;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	20 import tango.util.collection.model.Map;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	21 import tango.util.collection.model.Set;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	22
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	23 import dwt.widgets.Event;
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	24 import dwtx.core.commands.Command;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	25 import dwtx.core.commands.CommandEvent;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	26 import dwtx.core.commands.CommandManager;
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	27 import dwtx.core.commands.ExecutionEvent;
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	28 import dwtx.core.commands.ExecutionException;
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	29 import dwtx.core.commands.ICommandListener;
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	30 import dwtx.core.commands.NotEnabledException;
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	31 import dwtx.core.commands.ParameterizedCommand;
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	32 import dwtx.core.commands.common.NotDefinedException;
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	33 import dwtx.core.runtime.IStatus;
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	34 import dwtx.core.runtime.ListenerList;
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	35 import dwtx.core.runtime.Status;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	36 import dwtx.jface.bindings.BindingManager;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	37 import dwtx.jface.bindings.BindingManagerEvent;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	38 import dwtx.jface.bindings.IBindingManagerListener;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	39 import dwtx.jface.bindings.Trigger;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	40 import dwtx.jface.bindings.TriggerSequence;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	41 import dwtx.jface.bindings.keys.KeySequence;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	42 import dwtx.jface.bindings.keys.KeyStroke;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	43 import dwtx.jface.bindings.keys.SWTKeySupport;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	44 import dwtx.jface.util.IPropertyChangeListener;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	45 import dwtx.jface.util.Policy;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	46 import dwtx.jface.util.PropertyChangeEvent;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	47 import dwtx.jface.util.Util;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	48
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	49 import dwt.dwthelper.utils;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	50 import dwt.dwthelper.ResourceBundle;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	51 import tango.text.convert.Format;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	52
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	53 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	54 * <p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	55 * A manager for a callback facility which is capable of querying external
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	56 * interfaces for additional information about actions and action contribution
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	57 * items. This information typically includes things like accelerators and
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	58 * textual representations.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	59 * </p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	60 * <p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	61 * <em>It is only necessary to use this mechanism if you will be using a mix of
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	62 * actions and commands, and wish the interactions to work properly.</em>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	63 * </p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	64 * <p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	65 * For example, in the Eclipse workbench, this mechanism is used to allow the
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	66 * command architecture to override certain values in action contribution items.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	67 * </p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	68 * <p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	69 * This class is not intended to be called or extended by any external clients.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	70 * </p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	71 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	72 * @since 3.0
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	73 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	74 public final class ExternalActionManager {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	75
72 5df4896124c7 JFace and its examples do compile Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	76 private static HashMap!(String,String) EMPTY_MAP;
5df4896124c7 JFace and its examples do compile Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	77 static this(){
5df4896124c7 JFace and its examples do compile Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	78 EMPTY_MAP = new HashMap!(String,String);
5df4896124c7 JFace and its examples do compile Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	79 }
5df4896124c7 JFace and its examples do compile Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	80
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	81 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	82 * A simple implementation of the <code>ICallback</code> mechanism that
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	83 * simply takes a <code>BindingManager</code> and a
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	84 * <code>CommandManager</code>.
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	85 * <p>
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	86 * <b>Note:</b> this class is not intended to be subclassed by clients.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	87 * </p>
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	88 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	89 * @since 3.1
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	90 */
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	91 public static class CommandCallback :
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	92 IBindingManagerListener, IBindingManagerCallback, IExecuteCallback {
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	93
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	94 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	95 * The internationalization bundle for text produced by this class.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	96 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	97 private static const ResourceBundle RESOURCE_BUNDLE;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	98
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	99 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	100 * The callback capable of responding to whether a command is active.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	101 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	102 private const IActiveChecker activeChecker;
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	103
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	104 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	105 * Check the applicability of firing an execution event for an action.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	106 */
72 5df4896124c7 JFace and its examples do compile Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	107 private /+final+/ IExecuteApplicable applicabilityChecker;
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	108
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	109 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	110 * The binding manager for your application. Must not be
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	111 * <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	112 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	113 private const BindingManager bindingManager;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	114
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	115 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	116 * Whether a listener has been attached to the binding manager yet.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	117 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	118 private bool bindingManagerListenerAttached = false;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	119
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	120 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	121 * The command manager for your application. Must not be
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	122 * <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	123 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	124 private const CommandManager commandManager;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	125
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	126 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	127 * A set of all the command identifiers that have been logged as broken
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	128 * so far. For each of these, there will be a listener on the
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	129 * corresponding command. If the command ever becomes defined, the item
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	130 * will be removed from this set and the listener removed. This value
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	131 * may be empty, but never <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	132 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	133 private const Set!(String) loggedCommandIds;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	134
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	135 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	136 * The list of listeners that have registered for property change
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	137 * notification. This is a map of command identifiers (<code>String</code>)
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	138 * to listeners (<code>IPropertyChangeListener</code> or
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	139 * <code>ListenerList</code> of <code>IPropertyChangeListener</code>).
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	140 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	141 private const Map!(String,IPropertyChangeListener) registeredListeners;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	142
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	143 static this(){
39 644f1334b451 fix anon classes Frank Benoit <benoit@tionex.de> parents: 37 diff changeset	144 RESOURCE_BUNDLE = ResourceBundle.getBundle(
48 7a3e6c1a4eae import data with getImportData!() Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	145 getImportData!("dwtx.jface.action.ExternalActionManager.properties"));
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	146 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	147 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	148 * Constructs a new instance of <code>CommandCallback</code> with the
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	149 * workbench it should be using. All commands will be considered active.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	150 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	151 * @param bindingManager
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	152 * The binding manager which will provide the callback; must
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	153 * not be <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	154 * @param commandManager
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	155 * The command manager which will provide the callback; must
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	156 * not be <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	157 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	158 * @since 3.1
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	159 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	160 public this(BindingManager bindingManager,
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	161 CommandManager commandManager) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	162 this(bindingManager, commandManager, new class IActiveChecker {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	163 public bool isActive(String commandId) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	164 return true;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	165 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	166
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	167 }, new class IExecuteApplicable {
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	168 public bool isApplicable(IAction action) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	169 return true;
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	170 }
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	171 });
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	172 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	173 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	174 * Constructs a new instance of <code>CommandCallback</code> with the
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	175 * workbench it should be using.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	176 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	177 * @param bindingManager
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	178 * The binding manager which will provide the callback; must
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	179 * not be <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	180 * @param commandManager
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	181 * The command manager which will provide the callback; must
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	182 * not be <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	183 * @param activeChecker
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	184 * The callback mechanism for checking whether a command is
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	185 * active; must not be <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	186 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	187 * @since 3.1
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	188 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	189 public this(BindingManager bindingManager,
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	190 CommandManager commandManager,
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	191 IActiveChecker activeChecker) {
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	192 this(bindingManager, commandManager, activeChecker,
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	193 new class IExecuteApplicable {
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	194 public bool isApplicable(IAction action) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	195 return true;
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	196 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	197 });
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	198 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	199 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	200 * Constructs a new instance of <code>CommandCallback</code> with the
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	201 * workbench it should be using.
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	202 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	203 * @param bindingManager
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	204 * The binding manager which will provide the callback; must
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	205 * not be <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	206 * @param commandManager
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	207 * The command manager which will provide the callback; must
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	208 * not be <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	209 * @param activeChecker
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	210 * The callback mechanism for checking whether a command is
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	211 * active; must not be <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	212 * @param checker
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	213 * The callback to check if an IAction should fire execution
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	214 * events.
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	215 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	216 * @since 3.4
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	217 */
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	218 public this(BindingManager bindingManager,
4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	219 CommandManager commandManager,
4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	220 IActiveChecker activeChecker,
4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	221 IExecuteApplicable checker) {
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	222 loggedCommandIds = new HashSet!(String);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	223 registeredListeners = new HashMap!(String,IPropertyChangeListener);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	224 if (bindingManager is null) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	225 throw new NullPointerException(
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	226 "The callback needs a binding manager"); //$NON-NLS-1$
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	227 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	228
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	229 if (commandManager is null) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	230 throw new NullPointerException(
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	231 "The callback needs a command manager"); //$NON-NLS-1$
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	232 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	233
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	234 if (activeChecker is null) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	235 throw new NullPointerException(
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	236 "The callback needs an active callback"); //$NON-NLS-1$
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	237 }
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	238 if (checker is null) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	239 throw new NullPointerException(
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	240 "The callback needs an applicable callback"); //$NON-NLS-1$
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	241 }
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	242
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	243 this.activeChecker = activeChecker;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	244 this.bindingManager = bindingManager;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	245 this.commandManager = commandManager;
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	246 this.applicabilityChecker = checker;
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	247 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	248
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	249 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	250 * @see dwtx.jface.action.ExternalActionManager.ICallback#addPropertyChangeListener(String,
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	251 * IPropertyChangeListener)
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	252 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	253 public final void addPropertyChangeListener(String commandId,
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	254 IPropertyChangeListener listener) {
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	255 auto existing = cast(Object)registeredListeners.get(commandId);
4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	256 if (null !is cast(ListenerList)existing ) {
4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	257 (cast(ListenerList) existing).add(cast(Object)listener);
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	258 } else if (existing !is null) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	259 ListenerList listeners = new ListenerList(ListenerList.IDENTITY);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	260 listeners.add(existing);
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	261 listeners.add(cast(Object)listener);
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	262 } else {
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	263 registeredListeners.add(commandId, listener);
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	264 }
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	265 if (!bindingManagerListenerAttached) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	266 bindingManager.addBindingManagerListener(this);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	267 bindingManagerListenerAttached = true;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	268 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	269 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	270
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	271 public final void bindingManagerChanged(BindingManagerEvent event) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	272 if (event.isActiveBindingsChanged()) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	273 foreach( k,v; registeredListeners ){
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	274 // Iterator listenerItr = registeredListeners.entrySet()
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	275 // .iterator();
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	276 // while (listenerItr.hasNext()) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	277 // Map.Entry entry = cast(Map.Entry) listenerItr.next();
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	278 String commandId = k;//stringcast(k);// entry.getKey();
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	279 Command command = commandManager.getCommand(commandId);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	280 ParameterizedCommand parameterizedCommand = new ParameterizedCommand(
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	281 command, null);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	282 if (event.isActiveBindingsChangedFor(parameterizedCommand)) {
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	283 Object value = cast(Object) v;
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	284 PropertyChangeEvent propertyChangeEvent = new PropertyChangeEvent(event
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	285 .getManager(), IAction.TEXT, null, null);
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	286 if (null !is cast(ListenerList)value ) {
4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	287 Object[] listeners= (cast(ListenerList) value).getListeners();
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	288 for (int i = 0; i < listeners.length; i++) {
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	289 final IPropertyChangeListener listener = cast(IPropertyChangeListener) listeners[i];
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	290 listener.propertyChange(propertyChangeEvent);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	291 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	292 } else {
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	293 final IPropertyChangeListener listener = cast(IPropertyChangeListener) value;
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	294 listener.propertyChange(propertyChangeEvent);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	295 }
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	296 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	297 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	298 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	299 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	300
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	301 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	302 * @see dwtx.jface.action.ExternalActionManager.ICallback#getAccelerator(String)
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	303 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	304 public ValueWrapperInt getAccelerator(String commandId) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	305 TriggerSequence triggerSequence = bindingManager
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	306 .getBestActiveBindingFor(commandId);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	307 if (triggerSequence !is null) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	308 Trigger[] triggers = triggerSequence.getTriggers();
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	309 if (triggers.length is 1) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	310 Trigger trigger = triggers[0];
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	311 if ( auto keyStroke = cast(KeyStroke) trigger ) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	312 int accelerator = SWTKeySupport
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	313 .convertKeyStrokeToAccelerator(keyStroke);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	314 return new ValueWrapperInt(accelerator);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	315 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	316 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	317 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	318
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	319 return null;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	320 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	321
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	322 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	323 * @see dwtx.jface.action.ExternalActionManager.ICallback#getAcceleratorText(String)
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	324 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	325 public final String getAcceleratorText(String commandId) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	326 TriggerSequence triggerSequence = bindingManager
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	327 .getBestActiveBindingFor(commandId);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	328 if (triggerSequence is null) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	329 return null;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	330 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	331
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	332 return triggerSequence.format();
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	333 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	334
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	335 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	336 * Returns the active bindings for a particular command identifier.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	337 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	338 * @param commandId
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	339 * The identifier of the command whose bindings are
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	340 * requested. This argument may be <code>null</code>. It
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	341 * is assumed that the command has no parameters.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	342 * @return The array of active triggers (<code>TriggerSequence</code>)
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	343 * for a particular command identifier. This value is guaranteed
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	344 * not to be <code>null</code>, but it may be empty.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	345 * @since 3.2
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	346 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	347 public final TriggerSequence[] getActiveBindingsFor(
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	348 String commandId) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	349 return bindingManager.getActiveBindingsFor(commandId);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	350 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	351
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	352 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	353 * @see dwtx.jface.action.ExternalActionManager.ICallback#isAcceleratorInUse(int)
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	354 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	355 public final bool isAcceleratorInUse(int accelerator) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	356 KeySequence keySequence = KeySequence
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	357 .getInstance(SWTKeySupport
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	358 .convertAcceleratorToKeyStroke(accelerator));
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	359 return bindingManager.isPerfectMatch(keySequence)
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	360 \|\| bindingManager.isPartialMatch(keySequence);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	361 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	362
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	363 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	364 * {@inheritDoc}
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	365 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	366 * Calling this method with an undefined command id will generate a log
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	367 * message.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	368 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	369 public final bool isActive(String commandId) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	370 if (commandId !is null) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	371 Command command = commandManager.getCommand(commandId);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	372
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	373 if (!command.isDefined()
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	374 && (!loggedCommandIds.contains(commandId))) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	375 // The command is not yet defined, so we should log this.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	376 String message = Format(Util
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	377 .translateString(RESOURCE_BUNDLE,
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	378 "undefinedCommand.WarningMessage", null), //$NON-NLS-1$
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	379 [ command.getId() ]);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	380 IStatus status = new Status(IStatus.ERROR,
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	381 "dwtx.jface", //$NON-NLS-1$
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	382 0, message, new Exception(null));
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	383 Policy.getLog().log(status);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	384
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	385 // And remember this item so we don't log it again.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	386 loggedCommandIds.add(commandId);
39 644f1334b451 fix anon classes Frank Benoit <benoit@tionex.de> parents: 37 diff changeset	387 command.addCommandListener(new class(command,commandId) ICommandListener {
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	388 Command command_;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	389 String commandId_;
39 644f1334b451 fix anon classes Frank Benoit <benoit@tionex.de> parents: 37 diff changeset	390 this(Command a,String b){
644f1334b451 fix anon classes Frank Benoit <benoit@tionex.de> parents: 37 diff changeset	391 command_=a;
644f1334b451 fix anon classes Frank Benoit <benoit@tionex.de> parents: 37 diff changeset	392 commandId_=b;
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	393 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	394 /*
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	395 * (non-Javadoc)
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	396 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	397 * @see dwtx.ui.commands.ICommandListener#commandChanged(dwtx.ui.commands.CommandEvent)
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	398 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	399 public final void commandChanged(
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	400 CommandEvent commandEvent) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	401 if (command_.isDefined()) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	402 command_.removeCommandListener(this);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	403 loggedCommandIds.remove(commandId_);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	404 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	405 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	406 });
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	407
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	408 return true;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	409 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	410
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	411 return activeChecker.isActive(commandId);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	412 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	413
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	414 return true;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	415 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	416
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	417 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	418 * @see dwtx.jface.action.ExternalActionManager.ICallback#removePropertyChangeListener(String,
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	419 * IPropertyChangeListener)
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	420 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	421 public final void removePropertyChangeListener(String commandId,
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	422 IPropertyChangeListener listener) {
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	423 Object existing = cast(Object) registeredListeners.get(commandId);
4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	424 if (existing is cast(Object)listener) {
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	425 registeredListeners.removeKey(commandId);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	426 if (registeredListeners.drained()) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	427 bindingManager.removeBindingManagerListener(this);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	428 bindingManagerListenerAttached = false;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	429 }
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	430 } else if (null !is cast(ListenerList)existing ) {
4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	431 ListenerList existingList = cast(ListenerList) existing;
4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	432 existingList.remove(cast(Object)listener);
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	433 if (existingList.size() is 1) {
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	434 registeredListeners.add(commandId, cast(IPropertyChangeListener)existingList.getListeners()[0]);
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	435 }
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	436 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	437 }
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	438
90 7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	439 /**
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	440 * @since 3.4
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	441 */
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	442 public void preExecute(IAction action, Event event) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	443 String actionDefinitionId = action.getActionDefinitionId();
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	444 if (actionDefinitionId is null
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	445 \|\| !applicabilityChecker.isApplicable(action)) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	446 return;
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	447 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	448 Command command = commandManager.getCommand(actionDefinitionId);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	449 ExecutionEvent executionEvent = new ExecutionEvent(command,
72 5df4896124c7 JFace and its examples do compile Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	450 EMPTY_MAP, event, null);
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	451
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	452 commandManager.firePreExecute(actionDefinitionId, executionEvent);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	453 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	454
90 7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	455 /**
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	456 * @since 3.4
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	457 */
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	458 public void postExecuteSuccess(IAction action, Object returnValue) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	459 String actionDefinitionId = action.getActionDefinitionId();
72 5df4896124c7 JFace and its examples do compile Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	460 if (actionDefinitionId is null
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	461 \|\| !applicabilityChecker.isApplicable(action)) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	462 return;
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	463 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	464 commandManager.firePostExecuteSuccess(actionDefinitionId, returnValue);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	465 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	466
90 7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	467 /**
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	468 * @since 3.4
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	469 */
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	470 public void postExecuteFailure(IAction action,
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	471 ExecutionException exception) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	472 String actionDefinitionId = action.getActionDefinitionId();
72 5df4896124c7 JFace and its examples do compile Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	473 if (actionDefinitionId is null
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	474 \|\| !applicabilityChecker.isApplicable(action)) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	475 return;
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	476 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	477 commandManager.firePostExecuteFailure(actionDefinitionId, exception);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	478 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	479
90 7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	480 /**
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	481 * @since 3.4
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	482 */
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	483 public void notDefined(IAction action, NotDefinedException exception) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	484 String actionDefinitionId = action.getActionDefinitionId();
72 5df4896124c7 JFace and its examples do compile Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	485 if (actionDefinitionId is null
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	486 \|\| !applicabilityChecker.isApplicable(action)) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	487 return;
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	488 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	489 commandManager.fireNotDefined(actionDefinitionId, exception);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	490 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	491
90 7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	492 /**
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	493 * @since 3.4
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 72 diff changeset	494 */
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	495 public void notEnabled(IAction action, NotEnabledException exception) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	496 String actionDefinitionId = action.getActionDefinitionId();
72 5df4896124c7 JFace and its examples do compile Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	497 if (actionDefinitionId is null
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	498 \|\| !applicabilityChecker.isApplicable(action)) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	499 return;
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	500 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	501 commandManager.fireNotEnabled(actionDefinitionId, exception);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	502 }
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	503 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	504
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	505 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	506 * Defines a callback mechanism for developer who wish to further control
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	507 * the visibility of legacy action-based contribution items.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	508 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	509 * @since 3.1
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	510 */
37 e10d9c2648be fix static interface and static this Frank Benoit <benoit@tionex.de> parents: 16 diff changeset	511 public interface IActiveChecker {
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	512 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	513 * Checks whether the command with the given identifier should be
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	514 * considered active. This can be used in systems using some kind of
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	515 * user interface filtering (e.g., activities in the Eclipse workbench).
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	516 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	517 * @param commandId
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	518 * The identifier for the command; must not be
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	519 * <code>null</code>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	520 * @return <code>true</code> if the command is active;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	521 * <code>false</code> otherwise.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	522 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	523 public bool isActive(String commandId);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	524 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	525
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	526 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	527 * <p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	528 * A callback which communicates with the applications binding manager. This
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	529 * interface provides more information from the binding manager, which
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	530 * allows greater integration. Implementing this interface is preferred over
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	531 * {@link ExternalActionManager.ICallback}.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	532 * </p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	533 * <p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	534 * Clients may implement this interface, but must not extend.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	535 * </p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	536 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	537 * @since 3.2
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	538 */
37 e10d9c2648be fix static interface and static this Frank Benoit <benoit@tionex.de> parents: 16 diff changeset	539 public interface IBindingManagerCallback : ICallback {
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	540
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	541 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	542 * <p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	543 * Returns the active bindings for a particular command identifier.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	544 * </p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	545 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	546 * @param commandId
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	547 * The identifier of the command whose bindings are
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	548 * requested. This argument may be <code>null</code>. It
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	549 * is assumed that the command has no parameters.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	550 * @return The array of active triggers (<code>TriggerSequence</code>)
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	551 * for a particular command identifier. This value is guaranteed
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	552 * not to be <code>null</code>, but it may be empty.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	553 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	554 public TriggerSequence[] getActiveBindingsFor(String commandId);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	555 }
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	556
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	557 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	558 * An overridable mechanism to filter certain IActions from the execution
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	559 * bridge.
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	560 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	561 * @since 3.4
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	562 */
72 5df4896124c7 JFace and its examples do compile Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	563 public interface IExecuteApplicable {
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	564 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	565 * Allow the callback to filter out actions that should not fire
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	566 * execution events.
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	567 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	568 * @param action
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	569 * The action with an actionDefinitionId
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	570 * @return true if this action should be considered.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	571 */
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	572 public bool isApplicable(IAction action);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	573 }
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	574
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	575 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	576 * <p>
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	577 * A callback for executing execution events. Allows
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	578 * <code>ActionContributionItems</code> to fire useful events.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	579 * </p>
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	580 * <p>
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	581 * Clients must not implement this interface and must not extend.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	582 * </p>
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	583 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	584 * @since 3.4
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	585 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	586 */
72 5df4896124c7 JFace and its examples do compile Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	587 public interface IExecuteCallback {
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	588
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	589 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	590 * Fires a <code>NotEnabledException</code> because the action was not
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	591 * enabled.
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	592 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	593 * @param action
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	594 * The action contribution that caused the exception,
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	595 * never <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	596 * @param exception
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	597 * The <code>NotEnabledException</code>, never <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	598 */
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	599 public void notEnabled(IAction action, NotEnabledException exception);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	600
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	601 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	602 * Fires a <code>NotDefinedException</code> because the action was not
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	603 * defined.
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	604 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	605 * @param action
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	606 * The action contribution that caused the exception,
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	607 * never <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	608 * @param exception
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	609 * The <code>NotDefinedException</code>, never <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	610 */
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	611 public void notDefined(IAction action, NotDefinedException exception);
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	612
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	613 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	614 * Fires an execution event before an action is run.
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	615 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	616 * @param action
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	617 * The action contribution that requires an
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	618 * execution event to be fired. Cannot be <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	619 * @param e
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	620 * The DWT Event, may be <code>null</code>.
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	621 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	622 */
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	623 public void preExecute(IAction action,
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	624 Event e);
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	625
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	626 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	627 * Fires an execution event when the action returned a success.
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	628 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	629 * @param action
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	630 * The action contribution that requires an
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	631 * execution event to be fired. Cannot be <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	632 * @param returnValue
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	633 * The command's result, may be <code>null</code>.
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	634 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	635 */
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	636 public void postExecuteSuccess(IAction action,
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	637 Object returnValue);
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	638
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	639 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	640 * Creates an <code>ExecutionException</code> when the action returned
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	641 * a failure.
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	642 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	643 * @param action
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	644 * The action contribution that caused the exception,
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	645 * never <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	646 * @param exception
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	647 * The <code>ExecutionException</code>, never <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	648 */
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	649 public void postExecuteFailure(IAction action,
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	650 ExecutionException exception);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	651 }
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	652
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	653 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	654 * A callback mechanism for some external tool to communicate extra
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	655 * information to actions and action contribution items.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	656 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	657 * @since 3.0
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	658 */
37 e10d9c2648be fix static interface and static this Frank Benoit <benoit@tionex.de> parents: 16 diff changeset	659 public interface ICallback {
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	660
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	661 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	662 * <p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	663 * Adds a listener to the object referenced by <code>identifier</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	664 * This listener will be notified if a property of the item is to be
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	665 * changed. This identifier is specific to mechanism being used. In the
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	666 * case of the Eclipse workbench, this is the command identifier.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	667 * </p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	668 * <p>
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	669 * Has no effect if an identical listener has already been added for
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	670 * the <code>identifier</code>.
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	671 * </p>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	672 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	673 * @param identifier
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	674 * The identifier of the item to which the listener should be
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	675 * attached; must not be <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	676 * @param listener
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	677 * The listener to be added; must not be <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	678 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	679 public void addPropertyChangeListener(String identifier,
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	680 IPropertyChangeListener listener);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	681
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	682 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	683 * An accessor for the accelerator associated with the item indicated by
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	684 * the identifier. This identifier is specific to mechanism being used.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	685 * In the case of the Eclipse workbench, this is the command identifier.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	686 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	687 * @param identifier
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	688 * The identifier of the item from which the accelerator
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	689 * should be obtained ; must not be <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	690 * @return An integer representation of the accelerator. This is the
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	691 * same accelerator format used by DWT.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	692 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	693 public Integer getAccelerator(String identifier);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	694
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	695 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	696 * An accessor for the accelerator text associated with the item
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	697 * indicated by the identifier. This identifier is specific to mechanism
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	698 * being used. In the case of the Eclipse workbench, this is the command
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	699 * identifier.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	700 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	701 * @param identifier
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	702 * The identifier of the item from which the accelerator text
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	703 * should be obtained ; must not be <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	704 * @return A string representation of the accelerator. This is the
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	705 * string representation that should be displayed to the user.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	706 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	707 public String getAcceleratorText(String identifier);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	708
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	709 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	710 * Checks to see whether the given accelerator is being used by some
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	711 * other mechanism (outside of the menus controlled by JFace). This is
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	712 * used to keep JFace from trying to grab accelerators away from someone
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	713 * else.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	714 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	715 * @param accelerator
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	716 * The accelerator to check -- in DWT's internal accelerator
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	717 * format.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	718 * @return <code>true</code> if the accelerator is already being used
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	719 * and shouldn't be used again; <code>false</code> otherwise.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	720 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	721 public bool isAcceleratorInUse(int accelerator);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	722
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	723 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	724 * Checks whether the item matching this identifier is active. This is
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	725 * used to decide whether a contribution item with this identifier
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	726 * should be made visible. An inactive item is not visible.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	727 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	728 * @param identifier
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	729 * The identifier of the item from which the active state
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	730 * should be retrieved; must not be <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	731 * @return <code>true</code> if the item is active; <code>false</code>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	732 * otherwise.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	733 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	734 public bool isActive(String identifier);
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	735
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	736 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	737 * Removes a listener from the object referenced by
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	738 * <code>identifier</code>. This identifier is specific to mechanism
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	739 * being used. In the case of the Eclipse workbench, this is the command
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	740 * identifier.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	741 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	742 * @param identifier
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	743 * The identifier of the item to from the listener should be
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	744 * removed; must not be <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	745 * @param listener
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	746 * The listener to be removed; must not be <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	747 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	748 public void removePropertyChangeListener(String identifier,
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	749 IPropertyChangeListener listener);
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 48 diff changeset	750
16 e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	751 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	752
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	753 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	754 * The singleton instance of this class. This value may be <code>null</code>--
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	755 * if it has not yet been initialized.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	756 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	757 private static ExternalActionManager instance;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	758
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	759 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	760 * Retrieves the current singleton instance of this class.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	761 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	762 * @return The singleton instance; this value is never <code>null</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	763 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	764 public static ExternalActionManager getInstance() {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	765 if (instance is null) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	766 instance = new ExternalActionManager();
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	767 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	768
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	769 return instance;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	770 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	771
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	772 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	773 * The callback mechanism to use to retrieve extra information.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	774 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	775 private ICallback callback;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	776
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	777 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	778 * Constructs a new instance of <code>ExternalActionManager</code>.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	779 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	780 private this() {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	781 // This is a singleton class. Only this class should create an instance.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	782 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	783
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	784 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	785 * An accessor for the current call back.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	786 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	787 * @return The current callback mechanism being used. This is the callback
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	788 * that should be queried for extra information about actions and
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	789 * action contribution items. This value may be <code>null</code>
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	790 * if there is no extra information.
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	791 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	792 public ICallback getCallback() {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	793 return callback;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	794 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	795
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	796 /**
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	797 * A mutator for the current call back
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	798 *
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	799 * @param callbackToUse
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	800 * The new callback mechanism to use; this value may be
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	801 * <code>null</code> if the default is acceptable (i.e., no
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	802 * extra information will provided to actions).
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	803 */
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	804 public void setCallback(ICallback callbackToUse) {
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	805 callback = callbackToUse;
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	806 }
e0f0aaf75edd PopupDialog, bindings and actions Frank Benoit <benoit@tionex.de> parents: diff changeset	807 }

Mercurial > projects > dwt-addons

annotate dwtx/jface/action/ExternalActionManager.d @ 90:7ffeace6c47f