trayiconmanager.java

java实现msn的功能

/*
 * @(#)TrayIconManager.java
 *
 * Copyright (c) 2001 Jangho Hwang,
 * All rights reserved.
 * 
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 
 * 	1. Redistributions of source code must retain the above copyright
 * notice, this list of conditions and the following disclaimer.
 * 
 * 	2. Redistributions in binary form must reproduce the above copyright
 * notice, this list of conditions and the following disclaimer in the
 * documentation and/or other materials provided with the distribution.
 * 
 * 	3. Neither the name of the JangHo Hwang nor the names of its contributors
 * may be used to endorse or promote products derived from this software
 * without specific prior written permission.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 *    $Id: TrayIconManager.java,v 1.2 2002/07/23 05:05:24 xrath Exp $
 */
package rath.tools.tray;

import java.awt.Frame;
import java.awt.Point;
import java.io.*;
import java.util.HashMap;
import java.util.Iterator;
import rath.tools.Win32Toolkit;
/**
 * 飘饭捞 酒捞能甸阑 包府秦林绰 努贰胶捞促.
 * 捞 努贰胶绰 汗荐狼 牢胶畔胶 积己阑 倾侩窍瘤 臼绰促.
 * <p>
 * 肚茄 飘饭捞 酒捞能篮 厚沥惑 辆丰窍看阑锭, 矫胶袍 飘饭捞俊 酒捞能捞 弊措肺
 * 巢酒乐绰 版快啊 腹促. 捞巴阑 规瘤窍扁 困秦 Runtime.addShutdownHook 窃荐甫 荤侩茄促. 
 * 捞巴阑 荤侩窍扁 锭巩俊, JDK 1.3 捞惑阑 鞘夸肺 茄促.
 * <p>
 * 措脚 Platform篮 Windows 95/98/ME客 NT 4.0/2000 捞惑阑 葛滴 瘤盔茄促.
 * <br>窜, 浅急档框富 扁瓷阑 捞侩窍扁 困秦 AdvancedTrayIcon阑 荤侩窍妨 茄促搁, 
 * Windows ME/2000 捞惑狼 敲阀汽捞咯具父 茄促. (Shell32.dll version 5.0捞 鞘夸窍促. 
 * ME唱 2000俊绰 扁夯利栏肺 5.0 滚怜狼 Shell32.dll 捞 器窃登绢 乐促)
 * <p>
 * 酒贰狼 抗力甫 焊搁 奖霸 荤侩规过阑 劳鳃 荐 乐阑 巴捞促.
 * <p>
 * <pre><code>
 * Win32Toolkit toolkit = Win32Toolkit.getInstance();
 * ...
 * TrayIconManager tray = new TrayIconManager( tookit );
 * 
 * <font color=green><i>// 浅急档框富阑 啊瘤绰 飘饭捞酒捞能 按眉甫 积己茄促.</font></i>
 * AdvancedTrayIcon icon = new AdvancedTrayIcon( 
 *     new ImageIcon("cute.gif").getImage(), "捞慧飘饭捞" );
 *
 * <font color=green><i>// 浅急档框富狼 力格阑 汲沥茄促.</font></i>
 * icon.setBaloonTitle( "酒锐 贰静 岗里捞" ); 
 * <font color=green><i>// 浅急档框富 郴侩阑 沥茄促. 俺青巩磊(\n)捞 利侩等促.</font></i>
 * icon.setBaloonText( "贰静丛捞 殿厘 窍看嚼聪促.\n葛滴 磊府俊辑 老绢唱林技夸" );
 * <font color=green><i>// 浅急档框富 力格 糠俊 钎矫且 酒捞能阑 汲沥茄促.</font></i>
 * icon.setBaloonIcon( icon.ICON_INFORMATION );
 * 
 * <font color=green><i>// 捞亥飘府胶呈客 窃膊, 矫胶袍 飘饭捞俊 角力肺 殿废茄促.</font></i>
 * tray.addTrayIcon( icon, new TrayEventAdapter() {
 *     public void mouseDblClicked( Point p )
 *     {
 *         System.out.println( p + " 谅钎俊辑 歹喉努腐沁促." );
 *     }
 * });
 * 
 * <font color=green><i>// 吝埃 函版 扁瓷阑 抛胶飘 窍扁 困秦 10檬父 疆促.</font></i>
 * Thread.currentThread().sleep( 10000L );
 *
 * <font color=green><i>// 酒捞能 沥焊甫 荐沥茄促.</font></i>
 * icon.setIcon( new ImageIcon("angry.gif").getImage() );
 * icon.setBaloonTitle( "岗里捞 亮酒窍备 乐匙" );
 * icon.setBaloonIcon( icon.ICON_ERROR );
 * 
 * <font color=green><i>// 函版等 鞘靛沥焊客 窃膊 角力肺 函版郴侩阑 利侩矫挪促.</font></i>
 * tray.modifyTrayIcon( info, TrayIcon.TYPE_ICON | TypeIcon.TYPE_BALOON );
 * 
 * </code></pre>
 *
 * Windows 95/98 棺 NT 4.0捞惑 荤侩磊狼 版快 浅急档框富父 荤侩窍瘤 给且挥 老馆 
 * 扁瓷篮 葛滴 荤侩且 荐 乐促. 窜, {@link AdvancedTrayIcon AdvancedTrayIcon}捞 酒囱 
 * {@link TrayIcon TrayIcon} 努贰胶甫 荤侩秦具 且 巴捞促.
 *
 * @author Jangho Hwang, [e-mail]
 * @version $Id: TrayIconManager.java,v 1.2 2002/07/23 05:05:24 xrath Exp $, since 2001/12/17
 */
public class TrayIconManager
{
	private final Win32Toolkit toolkit;
	private int uniqueId = 0;
	private long handle = 0L;
	private HashMap listenerMap = null;

	/**
	 * Windows狼 矫胶袍 飘饭捞甫 荤侩且 荐 乐霸 秦林绰 TrayIconManager 牢胶畔胶甫
	 * 积己茄促. Windows 绊蜡 扁瓷捞扁 锭巩俊, Win32Toolkit 牢胶畔胶甫 逞败林绢具 茄促.
	 */
	public TrayIconManager( Win32Toolkit toolkit )
	{
		this.toolkit = toolkit;
		this.listenerMap = new HashMap();
	}

	/**
	 * 矫胶袍飘饭捞康开俊 货肺款 飘饭捞 酒捞能阑 殿废茄促. 
	 *
	 * @param  info     货肺款 飘饭捞 酒捞能狼 沥焊甫 啊柳 按眉
	 * @param  listener 殿废等 飘饭捞 康开俊 措茄 捞亥飘甫 没秒且 捞亥飘府胶呈
	 */
	public synchronized void addTrayIcon( TrayIcon info, TrayEventListener listener )
	{
		if( listenerMap.size()==0 )
		{
			final Frame temp = new Frame("");
			new Thread( new Runnable() {
				public void run()
				{
					temp.pack();
					handle = createTrayHandle(temp);
					temp.dispose();
				}
			}).start();
			
			try {
				int retry = 0;
				while( handle==0 || retry < 20)
				{
					Thread.currentThread().sleep(50L);
					retry++;
				}
			} catch( InterruptedException e ) {}
			if( handle==0 )
				throw new IllegalStateException( "handle is not valid" );

			Runtime.getRuntime().addShutdownHook( new Thread() {
				public void run()
				{
					if( listenerMap.size()==0 )
						return;
					
					for( Iterator i=listenerMap.keySet().iterator(); i.hasNext(); )
					{
						String id = (String)i.next();
						removeTrayIcon0( handle, Integer.parseInt(id) );
					}
				}
			});
		}
		if( handle==0 )
			throw new IllegalStateException( "handle is not valid" );

		info.setUniqueID( uniqueId++ );

		NativeIcon nicon = info.getIcon();
		if( !nicon.isHandleCreated() )
			nicon.setIconHandle( toolkit.createIconFromImage(nicon.getImage()) );

		listenerMap.put( String.valueOf(info.getUniqueID()), listener );

		addTrayIcon0( handle, info );
	}

	/**
	 * 扁粮俊 殿废登绢乐带 飘饭捞酒捞能狼 加己阑 函版茄促. 
	 * <p>
	 * 林狼: TrayIconInfo 按眉甫 货肺 积己窍搁 救登哥, 馆靛矫 addTrayIcon俊 笼绢持菌带 
	 * 按眉俊辑 加己父 函版窍咯具 茄促. 弊犯瘤 臼栏搁 IllegalArgumentException阑 带龙 巴捞促.
	 * 
	 * @param  info        函版等 沥焊甫 啊瘤绊 乐绰 扁粮 TrayIconInfo 按眉
	 * @param  modifyField TrayIconInfo.ICON, TrayIconInfo.TIP 殿 角力肺 蔼捞 函茄
	 *                     鞘靛甸狼 稠府 钦. (ex: <b>TrayIconInfo.ICON | TrayIconInfo.TIP</b> )
	 */
	public synchronized void modifyTrayIcon( TrayIcon info, int modifyField )
	{
		long iconHandle = 0L;
		String tipMessage = null;

		if( !listenerMap.containsKey( String.valueOf(info.getUniqueID()) ) )
			throw new IllegalArgumentException( "unregistered trayicon" );
		if( handle==0 )
			throw new IllegalStateException( "handle is not valid" );

		if( (modifyField & TrayIcon.TYPE_ICON)==TrayIcon.TYPE_ICON )
		{
			NativeIcon nicon = info.getIcon();
			if( !nicon.isHandleCreated() )
			{
				iconHandle = toolkit.createIconFromImage( nicon.getImage() );
				nicon.setIconHandle( iconHandle );
			}
			else
				iconHandle = nicon.getIconHandle();
		}

		setTrayIcon0( handle, info, modifyField );
	}

	/**
	 * 秦寸 飘饭捞 酒捞能阑 矫胶袍 飘饭捞俊辑 秦力茄促. 
	 * 父距 殿废窍瘤 臼篮 TrayIconInfo 按眉甫 秦力窍妨 茄促搁, 
	 * java.lang.IllegalArgumentException阑 带龙 巴捞促.
	 */
	public synchronized void removeTrayIcon( TrayIcon info )
	{
		// getUniqueID客 HWND肺 Shell_NotifyIcon( NIM_REMOVE )甫 荐青窍档废 茄促.
		int uid = info.getUniqueID();
		if( listenerMap.remove(String.valueOf(uid))==null )
			throw new IllegalArgumentException( "unregistered trayicon" );
		if( handle==0 )
			throw new IllegalStateException( "handle is not valid" );

		removeTrayIcon0( handle, uid );
		toolkit.destroyIcon( info.getIconHandle() );


		if( listenerMap.size()==0 )
		{
			destroyTrayHandle( handle );
		}
	}

	/**
	 * 漂沥 NativeIcon捞 歹捞惑 鞘夸窍瘤 臼阑锭, Java image客 os specify 窍霸 
	 * 积己等 酒捞能 勤甸阑 葛滴 秦力秦霖促.
	 */
	public void removeNativeIcon( NativeIcon icon )
	{
		long iconHandle = icon.getIconHandle();
		if( iconHandle!=0 )
			toolkit.destroyIcon( iconHandle );

		icon.flush();
	}

	/**
	 * native WindowProc 栏肺何磐 龋免登绰 捞亥飘 惯价 皋家靛捞促.
	 */
	private void fireTrayEvent( int uid, int eventCode, Point point )
	{
		TrayEventListener listener = (TrayEventListener)listenerMap.get( String.valueOf(uid) );
		if( listener!=null )
		{
			switch( eventCode )
			{
			case 0:
				listener.mouseLeftClicked( point );
				break;
			case 1:
				listener.mouseRightClicked( point );
				break;
			case 2:
				listener.mouseDblClicked( point );
				break;
			case 3:
				listener.mouseMove( point );
				break;
			}
		}
	}

	private native void addTrayIcon0( long handle, TrayIcon info );

	private native void setTrayIcon0( long handle, TrayIcon info, int modifyField );

	private native void removeTrayIcon0( long handle, int uid );

	/**
	 * native 内靛俊辑绰 捞 TrayIconManager狼 牢胶畔胶俊 措茄 GlobalReference甫
	 * 傈开函荐肺 急攫秦初酒具 且 巴捞促. 弊贰具 捞亥飘甫 烹瘤罐阑 荐 乐促.
	 * <p>
	 * JNIEnv绰 傈开函荐肺 棱囚具窍哥
	 * jobject客 fireTrayEvent狼 jmethodID狼 GlobalRefenrence啊 傈开函荐肺 棱囚具父 茄促.
	 * 弊贰具 CallVoidMethod甫 荐青且 荐 乐促.
	 */
	private native long createTrayHandle( Frame temp );

	/**
	 * native 内靛俊辑绰 捞 TrayIconManager狼 牢胶畔胶俊 措秦 积己等 GlobalReference甫
	 * 昏力秦林绢具 且 巴捞促.
	 */
	private native void destroyTrayHandle( long handle );

}