1 /******************************************************************************* 2 * Copyright (c) 2006, 2011 IBM Corporation and others. 3 * 4 * This program and the accompanying materials 5 * are made available under the terms of the Eclipse Public License 2.0 6 * which accompanies this distribution, and is available at 7 * https://www.eclipse.org/legal/epl-2.0/ 8 * 9 * SPDX-License-Identifier: EPL-2.0 10 * 11 * Contributors: 12 * IBM Corporation - initial API and implementation 13 * Wind River - Pawel Piech - Need a clarification on usage of IElement*Provider interfaces with update arrays (Bug 213609) 14 *******************************************************************************/ 15 package org.eclipse.debug.internal.ui.viewers.model.provisional; 16 17 /** 18 * Provides context sensitive labels. Can be registered as an adapter for an element, 19 * or implemented directly. 20 * <p> 21 * Note: provider methods are called in the Display thread of the viewer. 22 * To avoid blocking the UI, long running operations should be performed 23 * asynchronously. 24 * </p> 25 * 26 * @since 3.3 27 */ 28 public interface IElementLabelProvider { 29 30 /** 31 * Updates the specified labels. 32 * 33 * @param updates Each update specifies the element and context for which a label is requested and 34 * stores label attributes. The update array is guaranteed to have at least one element, and for 35 * all updates to have the same presentation context. 36 */ update(ILabelUpdate[] updates)37 void update(ILabelUpdate[] updates); 38 } 39