connectivity/com.nokia.carbide.remoteConnections/src/com/nokia/carbide/remoteconnections/internal/api/IStatusDisplay.java
author dadubrow
Mon, 01 Mar 2010 11:27:50 -0600
changeset 1039 c7873299d91f
permissions -rw-r--r--
Add support for status notification popups and remove ui dependency + use new notification to switch mode

/**
* Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description: 
*
*/

package com.nokia.carbide.remoteconnections.internal.api;

import org.eclipse.core.runtime.IStatus;

public interface IStatusDisplay {

	/**
	 * Asynchronously displays status with notification UI
	 * @param status IStatus
	 */
	void displayStatus(IStatus status);
	
	/**
	 * Synchronously displays status with notification UI
	 * Displays a prompt and runs action if user accepts.
	 * Calling thread will block until notification is closed (either by timer or by user)
	 * and if action will be called on the calling thread.
	 * NOTE: This cannot be called on display thread!<br>
	 * <code>assert Display.getCurrent() == null;</code>
	 * @param status IStatus
	 * @param prompt String
	 * @param action Runnable
	 */
	void displayStatusWithAction(IStatus status, String prompt, Runnable action);
}