diff -r 4ad59aaee882 -r 2f468c1958d0 javauis/nokiauiapi_qt/javasrc/com/nokia/mid/ui/SoftNotificationListener.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/javauis/nokiauiapi_qt/javasrc/com/nokia/mid/ui/SoftNotificationListener.java Mon Oct 04 00:10:53 2010 +0300 @@ -0,0 +1,57 @@ +/* +* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of "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.mid.ui; + +/** + * SoftNotificationListener interface is used by applications which + * need callbacks from soft notifications. Listener will get a notification when the + * soft notification is either selected or dismissed by the user. Listener + * interface can be registered with + * {@link SoftNotification#setListener(SoftNotificationListener)} method. + * + * @see SoftNotification + */ +public interface SoftNotificationListener +{ + + /** + * Indicates that a soft notification was selected by the user. The + * platform calls {@link SoftNotification#remove()} before + * notificationSelected() is called. Application that posted the soft + * notification is activated before the listener will get the notification. + * + * @param notification A notification object identifying the soft + * notification being responded to by the user. The MIDlet must + * implement the functionality to be performed when the + * notification is selected. + */ + public abstract void notificationSelected(SoftNotification notification); + + /** + * Indicates that a soft notification was dismissed by the user. The + * platform calls {@link SoftNotification#remove()} before + * notificationDismissed() is called. + * + * @param notification A notification object identifying the soft + * notification being responded to by the user. The application must + * implement the functionality to be performed when the soft + * notification is dismissed, it is not required to do anything. + */ + public abstract void notificationDismissed(SoftNotification notification); + +}