blob: f8ef9101949a3546fa4076d82644b64d55b6ece5 (
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
|
/*******************************************************************************
* Copyright (c) 2005, 2009 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;
/**
* 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();
}
|
