1 /******************************************************************************* 2 * Copyright (c) 2000, 2005 IBM Corporation and others. 3 * All rights reserved. This program and the accompanying materials 4 * are made available under the terms of the Eclipse Public License v1.0 5 * which accompanies this distribution, and is available at 6 * http://www.eclipse.org/legal/epl-v10.html 7 * 8 * Contributors: 9 * IBM Corporation - initial API and implementation 10 *******************************************************************************/ 11 package org.eclipse.debug.internal.ui.stringsubstitution; 12 13 import org.eclipse.core.variables.IStringVariable; 14 import org.eclipse.swt.widgets.Shell; 15 16 17 /** 18 * A variable presentation extension can contribute an argument selector 19 * which is use to configure the argument for a string substitution 20 * variable. 21 * 22 * @since 3.0 23 */ 24 public interface IArgumentSelector { 25 26 /** 27 * Selects and returns an argument for the given variable, 28 * or <code>null</code> if none. 29 * 30 * @param variable the variable an arugment is being seleted for 31 * @param the shell to create any dialogs on, or <code>null</code> if none 32 * @return argument for the given variable or <code>null</code> 33 * if none 34 */ 35 public String selectArgument(IStringVariable variable, Shell shell); 36 } 37