blob: 1fa2083b678d5936dd7cc5c1cacf155a8c946c45 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
/*******************************************************************************
* Copyright (c) 2000, 2003 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Common Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/cpl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
package org.eclipse.search.ui;
import org.eclipse.jface.operation.IRunnableContext;
import org.eclipse.jface.viewers.ISelection;
import org.eclipse.ui.IWorkingSet;
/**
* Offers client access to the search dialog.
* A search page can enable or disable the dialog's action
* button and get an operation context to perform the action.
* The dialog itself cannot be accessed directly.
* <p>
* This interface is not intended to be implemented by clients.
* </p>
*/
public interface ISearchPageContainer {
/**
* Workspace scope (value <code>0</code>).
*
* @since 2.0
*/
public static final int WORKSPACE_SCOPE= 0;
/**
* Selection scope (value <code>1</code>).
*
* @since 2.0
*/
public static final int SELECTION_SCOPE= 1;
/**
* Working set scope (value <code>2</code>).
*
* @since 2.0
*/
public static final int WORKING_SET_SCOPE= 2;
/**
* Current Project scope (value <code>3</code>).
*
* @since 3.0
*/
public static final int SELECTED_PROJECTS_SCOPE= 3;
/**
* Returns the selection with which this container was opened.
*
* @return the selection passed to this container when it was opened
*/
public ISelection getSelection();
/**
* Returns the context for the search operation.
* This context allows progress to be shown inside the search dialog.
*
* @return the <code>IRunnableContext</code> for the search operation
*/
public IRunnableContext getRunnableContext();
/**
* Sets the enable state of the perform action button
* of this container.
*
* @param state <code>true</code> to enable the button which performs the action
*/
public void setPerformActionEnabled(boolean state);
/**
* Returns search container's selected scope.
* The scope is WORKSPACE_SCOPE, SELECTED_PROJECTS_SCOPE, SELECTION_SCOPE or WORKING_SET_SCOPE.
*
* @return the selected scope
* @since 2.0
*/
public int getSelectedScope();
/**
* Sets the selected scope of this search page container.
* The scope is WORKSPACE_SCOPE, SELECTED_PROJECTS_SCOPE, SELECTION_SCOPE or WORKING_SET_SCOPE.
* @param scope the newly selected scope
*
* @since 2.0
*/
public void setSelectedScope(int scope);
/**
* Tells whether a valid scope is selected.
*
* @return a <code>true</code> if a valid scope is selected in this search page container
* @since 2.0
*/
public boolean hasValidScope();
/**
* Returns the selected working sets of this container.
*
* @return an array with the selected working sets or <code>null</code> if the scope is not WORKING_SET_SCOPE
* @since 2.0
*/
public IWorkingSet[] getSelectedWorkingSets();
/**
* Sets the selected working sets of this container.
*
* @param workingSets an array of IWorkingSet
* @since 2.0
*/
public void setSelectedWorkingSets(IWorkingSet[] workingSets);
}
|