Click here to Skip to main content
15,896,606 members
Articles / Mobile Apps / Windows Phone 7

A Gesture-Driven Windows Phone To-Do List

Rate me:
Please Sign up or sign in to vote.
4.94/5 (63 votes)
6 Sep 2012CPOL23 min read 141.3K   2K   83  
This article describes the development of a Windows Phone to-do list application that eschews buttons and checkboxes in favour of gestures.
using System;
using System.Diagnostics;
using System.Linq;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Threading;
using ClearStyle.ViewModel;
using LinqToVisualTree;
using Microsoft.Xna.Framework;
using Microsoft.Xna.Framework.Audio;

namespace ClearStyle.Interactions
{
  /// <summary>
  /// Adds the ability to be able to drag items within the list
  /// </summary>
  public class DragReOrderInteraction : InteractionBase
  {
    private static readonly int AutoScrollHitRegionSize = 80;

    private DispatcherTimer _autoScrollTimer;
    private DragImage _dragImage;
    private int _initialDragIndex;
    private SoundEffect _moveSound;
    
    public DragReOrderInteraction(DragImage dragImage)
    {
      _dragImage = dragImage;

      // a timer which is used to periodically detect the position of the
      // item being dragged in order to allow auto-scroll behaviour
      _autoScrollTimer = new DispatcherTimer();
      _autoScrollTimer.Interval = TimeSpan.FromMilliseconds(50);
      _autoScrollTimer.Tick += (s, e) =>
      {
        AutoScrollList();
        ShuffleItemsOnDrag();
      };

      _moveSound = SoundEffect.FromStream(TitleContainer.OpenStream("Sounds/Windows XP Menu Command.wav"));
    }

    public override void AddElement(FrameworkElement rootElement)
    {
      rootElement.Hold += Element_Hold;
      rootElement.ManipulationDelta += Element_ManipulationDelta;
      rootElement.ManipulationCompleted += Element_ManipulationCompleted;
    }


    private void Element_ManipulationCompleted(object sender, ManipulationCompletedEventArgs e)
    {
      if (!IsActive)
        return;

      IsActive = false;
      _autoScrollTimer.Stop();

      int dragIndex = GetDragIndex();

      // fade in the list
      _todoList.Animate(null, 1.0, FrameworkElement.OpacityProperty, 200, 0);

      // animated the dragged item into location
      double targetLocation = dragIndex * _dragImage.ActualHeight - _scrollViewer.VerticalOffset;
      var trans = _dragImage.GetVerticalOffset().Transform;
      trans.Animate(null, targetLocation, TranslateTransform.YProperty, 200, 0, null,
        () =>
        {
          // move the dragged item
          var draggedItem = _todoItems[_initialDragIndex];
          _todoItems.Remove(draggedItem);
          _todoItems.Insert(dragIndex, draggedItem);

          // re-populate our ObservableCollection
          RefreshView();

          // fade out the dragged image and collapse on completion
          _dragImage.Animate(null, 0.0, FrameworkElement.OpacityProperty, 1000, 0, null, ()
            => _dragImage.Visibility = Visibility.Collapsed);
        });
    }

    private void Element_ManipulationDelta(object sender, ManipulationDeltaEventArgs e)
    {
      Debug.WriteLine("ManipulationDelta");

      if (!IsActive)
        return;
      
      // set the event to handled in order to avoid scrolling the ScrollViewer
      e.Handled = true;

      // move our 'drag image'.
      _dragImage.SetVerticalOffset(_dragImage.GetVerticalOffset().Value + e.DeltaManipulation.Translation.Y);
    }

    private void Element_Hold(object sender, GestureEventArgs e)
    {
      if (IsEnabled == false)
        return;

      IsActive = true;

      // copy the dragged item to our 'dragImage' 
      FrameworkElement draggedItem = sender as FrameworkElement;
      var bitmap = new WriteableBitmap(draggedItem, null);
      _dragImage.Image.Source = bitmap;
      _dragImage.Visibility = Visibility.Visible;
      _dragImage.Opacity = 1.0;
      _dragImage.SetVerticalOffset(draggedItem.GetRelativePosition(_todoList).Y);

      // hide the real item
      draggedItem.Opacity = 0.0;

      // fade out the list
      _todoList.Animate(1.0, 0.7, FrameworkElement.OpacityProperty, 300, 0);

      _initialDragIndex = _todoItems.IndexOf(((ToDoItemViewModel)draggedItem.DataContext));

      _autoScrollTimer.Start();
    }

    // Determines the index that the dragged item would occupy when dropped
    private int GetDragIndex()
    {
      double dragLocation = _dragImage.GetRelativePosition(_todoList).Y +
                             _scrollViewer.VerticalOffset +
                             _dragImage.ActualHeight / 2;
      int dragIndex = (int)(dragLocation / _dragImage.ActualHeight);
      dragIndex = Math.Min(_todoItems.Count - 1, dragIndex);
      return dragIndex;
    }

    private void ShuffleItemsOnDrag()
    {
      // find its current index
      int dragIndex = GetDragIndex();

      // iterate over the items in the list and offset as required
      double offset = _dragImage.ActualHeight;
      for (int i = 0; i < _todoItems.Count; i++)
      {
        FrameworkElement item = _todoList.ItemContainerGenerator.ContainerFromIndex(i) as FrameworkElement;

        // determine which direction to offset this item by
        if (i <= dragIndex && i > _initialDragIndex)
        {
          OffsetItem(-offset, item);
        }
        else if (i >= dragIndex && i < _initialDragIndex)
        {
          OffsetItem(offset, item);
        }
        else
        {
          OffsetItem(0, item);
        }
      }
    }

    private void OffsetItem(double offset, FrameworkElement item)
    {
      double targetLocation = item.Tag != null ? (double)item.Tag : 0;
      if (targetLocation != offset)
      {
        var trans = item.GetVerticalOffset().Transform;
        trans.Animate(null, offset, TranslateTransform.YProperty, 500, 0);
        item.Tag = offset;
        _moveSound.Play();
      }
    }

    // checks the current location of the item being dragged, and scrolls if it is
    // close to the top or the bottom
    private void AutoScrollList()
    {
      // where is the dragged item relative to the list bounds?
      double draglocation = _dragImage.GetRelativePosition(_todoList).Y + _dragImage.ActualHeight / 2;

      if (draglocation < AutoScrollHitRegionSize)
      {
        // if close to the top, scroll up
        double velocity = (AutoScrollHitRegionSize - draglocation);
        _scrollViewer.ScrollToVerticalOffset(_scrollViewer.VerticalOffset - velocity);
      }
      else if (draglocation > _todoList.ActualHeight - AutoScrollHitRegionSize)
      {
        // if close to the bottom, scroll down
        double velocity = (AutoScrollHitRegionSize - (_todoList.ActualHeight - draglocation));
        _scrollViewer.ScrollToVerticalOffset(_scrollViewer.VerticalOffset + velocity);
      }
    }
  }
}

By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.

If a file you wish to view isn't highlighted, and is a text file (not binary), please let us know and we'll add colourisation support for it.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Architect Scott Logic
United Kingdom United Kingdom
I am CTO at ShinobiControls, a team of iOS developers who are carefully crafting iOS charts, grids and controls for making your applications awesome.

I am a Technical Architect for Visiblox which have developed the world's fastest WPF / Silverlight and WP7 charts.

I am also a Technical Evangelist at Scott Logic, a provider of bespoke financial software and consultancy for the retail and investment banking, stockbroking, asset management and hedge fund communities.

Visit my blog - Colin Eberhardt's Adventures in .NET.

Follow me on Twitter - @ColinEberhardt

-

Comments and Discussions