CalendarHandlerUI.java

/*
Copyright (C) 2011, Dirk Trossen, airs@dirk-trossen.de

This program is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation as version 2.1 of the License.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
License for more details.

You should have received a copy of the GNU Lesser General Public License
along with this library; if not, write to the Free Software Foundation, Inc.,
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 
*/
package com.airs.handlerUIs;

import android.annotation.SuppressLint;
import android.content.Context;
import android.database.Cursor;
import android.net.Uri;
import android.os.Build;
import android.preference.PreferenceActivity;
import android.provider.CalendarContract;

import com.airs.*;
import com.airs.helper.ListPreferenceMultiSelect;
import com.airs.platform.HandlerEntry;

/**
 * Class to implement the CalendarHandler configuration UI, based on the HandlerUI interface class
 *
 * @see com.airs.handlerUIs.HandlerUI HandlerUI 
 * @see com.airs.handlers.CalendarHandler CalendarHandler
 */
public class CalendarHandlerUI implements HandlerUI
{
	private Context context; 
	
	/**
	 * Initialises the settings entry with the name, description and icon resource ID
	 * @param context Reference to the {@link android.content.Context} realising this entry
	 */
	public HandlerEntry init(Context context)
	{		
		this.context = context;
		
		HandlerEntry entry = new HandlerEntry();
		entry.name = context.getString(R.string.CalendarHandlerUI_name);
		entry.description = context.getString(R.string.CalendarHandlerUI_description);
		entry.resid = R.drawable.calendar;
		return (entry);
	}

	/**
	 * Returns the resource ID to the preference XML file containing the layout of the preference
	 * @return resource ID
	 */
	public int setDisplay()
	{
		return R.xml.prefscalendar;
	}

	/**
	 * Returns the About String shown when selecting the About menu item in the Options menu
	 * @return About String of the About text
	 */
	public String About()
	{   
		return context.getString(R.string.CalendarHandlerUI_about);
	}
	
	/**
	 * Returns the Title for the About Dialog shown when selecting the About menu item in the Options menu
	 * @return String of the title
	 */
	public String AboutTitle()
	{
		return context.getString(R.string.CalendarHandlerUI_name);
	}
	
    /**
     * Destroys any resources for this {@link HandlerUI}
     */
    public void destroy()
    {
    }
    
	/**
	 * Function to configure the Preference activity with any preset value necessary - here we populate the ListPreference for the calendars with all calendars available on this device
	 * @param prefs Reference to {@link android.preference.PreferenceActivity}
	 */
	@SuppressLint("NewApi")
	public void configurePreference(PreferenceActivity prefs)
	{	
		int i;
		String[] fields = {CalendarContract.Calendars.CALENDAR_DISPLAY_NAME, CalendarContract.Calendars._ID};
    	Cursor eventCursor;

		// try to find the preference we want to configure
		ListPreferenceMultiSelect list = (ListPreferenceMultiSelect)prefs.findPreference("CalendarHandler::Calendar_names");
		if (list==null)
			return;

		try
		{
			// use different way of accessing calendar for Honeycomb
			if (Build.VERSION.SDK_INT>=14)
				eventCursor =  prefs.getContentResolver().query(CalendarContract.Calendars.CONTENT_URI, fields, null, null, null);
			else
				eventCursor =  prefs.getContentResolver().query(Uri.parse("content://com.android.calendar/calendars"), (new String[] { "displayName", "_id"}), null, null, null);
			
	
		    if (eventCursor == null)
		    {
				list.setEntries(null);
				list.setEntryValues(null);
		    	return;
		    }
		    
		    if (eventCursor.getCount() == 0)
		    {
				list.setEntries(null);
				list.setEntryValues(null);
		    	return;
		    }
		    
		    eventCursor.moveToFirst();
		    
	    	CharSequence[] calendars = new CharSequence[eventCursor.getCount()];
	    	CharSequence[] ids = new CharSequence[eventCursor.getCount()];
	
	    	// collect all calendars
		    for(i=0;i<eventCursor.getCount();i++)
		    {
		    	calendars[i] = eventCursor.getString(0);
		    	ids[i] = eventCursor.getString(1);
		    	
		    	eventCursor.moveToNext();
		    }
	
		    // set calendar names as entries in list
			list.setEntries(calendars);
			// set calendar IDs as entries in preference
			list.setEntryValues(ids);
		}
		catch(Exception e)
		{
			list.setEntries(null);
			list.setEntryValues(null);			
		}
	}
}