1
|
/*******************************************************************************
|
2
|
* Copyright (c) 2003, 2006 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.ui.internal.navigator.extensions;
|
12
|
|
13
|
import org.eclipse.ui.internal.navigator.TextActionHandler;
|
14
|
|
15
|
|
16
|
/**
|
17
|
* An INavigatorSiteEditor is used to edit (i.e., rename) elements in a NavigatorViewer.
|
18
|
* <p>
|
19
|
* This interface is not intended to be implemented by clients.
|
20
|
* </p>
|
21
|
* <p>
|
22
|
* This interface is experimental and is subject to change.
|
23
|
* </p>
|
24
|
* <p>
|
25
|
* <strong>EXPERIMENTAL</strong>. This class or interface has been added as part of a work in
|
26
|
* progress. There is a guarantee neither that this API will work nor that it will remain the same.
|
27
|
* Please do not use this API without consulting with the Platform/UI team.
|
28
|
* </p>
|
29
|
*
|
30
|
* @since 3.2
|
31
|
*/
|
32
|
public interface INavigatorSiteEditor {
|
33
|
/**
|
34
|
* Starts the editing. An editor box will be overlaid on the selected element in the Navigator
|
35
|
* tree.
|
36
|
*
|
37
|
* @param runnable
|
38
|
* Runnable to execute when editing ends successfully
|
39
|
*/
|
40
|
public void edit(Runnable runnable);
|
41
|
|
42
|
/**
|
43
|
* Returns the new text. Returns <code>null</code> if editing was cancelled. Editing is
|
44
|
* cancelled when the user pressed the Escape key.
|
45
|
*
|
46
|
* @return the new text or <code>null</code> if editing was cancelled
|
47
|
*/
|
48
|
public String getText();
|
49
|
|
50
|
/**
|
51
|
* Set the text handler that handles cut, copy, paste, delete and select all operations within
|
52
|
* the editor box.
|
53
|
*
|
54
|
* @param actionHandler
|
55
|
* the text action handler
|
56
|
*/
|
57
|
public void setTextActionHandler(TextActionHandler actionHandler);
|
58
|
}
|