blob: 7e542cf02e4aa775f024f2cd627d086484c1de99 (
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
122
123
124
125
126
127
128
129
130
131
|
/*******************************************************************************
* Copyright (c) 2005, 2010 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
* Pawel Piech (Wind River) - added a breadcrumb mode to Debug view (Bug 252677)
*******************************************************************************/
package org.eclipse.debug.internal.ui.viewers.model.provisional;
import org.eclipse.jface.util.IPropertyChangeListener;
import org.eclipse.ui.IWorkbenchPart;
import org.eclipse.ui.IWorkbenchWindow;
/**
* Context in which an asynchronous request has been made.
* <p>
* Clients may implement and extend this interface to provide
* special contexts. Implementations must subclass {@link PresentationContext}.
* </p>
* @since 3.2
*/
public interface IPresentationContext {
/**
* Property name used for property change notification when the columns
* in a presentation context change.
*/
public static final String PROPERTY_COLUMNS = "PROPERTY_COLUMNS"; //$NON-NLS-1$
/**
* Property indicating whether the presentation context is disposed.
* It is set to <code>Boolean.TRUE</code> after the presentation context
* is disposed. This property may be <code>null</code>, which indicates
* that context is not yet disposed.
*
* @since 3.6
*/
public static final String PROPERTY_DISPOSED = "PROPERTY_DISPOSED"; //$NON-NLS-1$
/**
* Returns identifiers of the visible columns in the order
* labels should be provided, or <code>null</code> if columns
* are not being displayed. Label providers use this
* information.
*
* @return visible column identifiers or <code>null</code>
* @see IColumnPresentation
*/
public String[] getColumns();
/**
* Registers the given listener for property change notification.
*
* @param listener property listener
*/
public void addPropertyChangeListener(IPropertyChangeListener listener);
/**
* Unregisters the given listener from property change notification.
*
* @param listener property listener.
*/
public void removePropertyChangeListener(IPropertyChangeListener listener);
/**
* Returns the id of this presentation context. Usually this is the id of
* the associated part. However, when no part is associated with this context,
* the id may exist on its own. Allows for a context that is not tied to a part.
*
* @return id
* @since 3.3
*/
public String getId();
/**
* Sets the specified property and notifies listeners of changes.
*
* @param property property name
* @param value property value
*/
public void setProperty(String property, Object value);
/**
* Returns the property with the specified name or <code>null</code>
* if none.
*
* @param property property name
* @return property value or <code>null</code>
*/
public Object getProperty(String property);
/**
* Disposes this presentation context. Called by the framework
* when the associated viewer is disposed.
*/
public void dispose();
/**
* Returns all keys of properties currently set in this context,
* possibly an empty collection
*
* @return keys of all current properties
* @since 3.4
*/
public String[] getProperties();
/**
* Returns the part that this presentation context is associated with.
* May return <code>null</code> if the presentation is not associated
* with a part.
*
* @return IWorkbenchPart or <code>null</code>
* @since 3.6
*/
public IWorkbenchPart getPart();
/**
* Returns the window that this presentation context is associated with.
* May return <code>null</code> if the presentation is not associated
* with a window.
*
* @return IWorkbenchWindow or <code>null</code>
* @since 3.6
*/
public IWorkbenchWindow getWindow();
}
|
