rdsCards - A Card Deck Library using RDS

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

using rds;

namespace rdsCards
{
	/// <summary>
	/// Holds a single playing card
	/// </summary>
	public class Card : RDSObject
	{
		#region CONSTRUCTOR
		/// <summary>
		/// Initializes a new instance of the <see cref="Card"/> class.
		/// </summary>
		/// <param name="cardvalue">The cardvalue is a 1-character-string describing the card.
		/// The chars for a card are (A)ce, (K)ing, (Q)ueen, (J)ack, (T)en or the number from 9 to 2 or * for a Joker</param>
		public Card(string cardvalue, Suit suit)
		{
			if (CardDeck.stringcards.Contains(cardvalue))
			{
				mvalue = cardvalue;
				if (cardvalue != "*")
					msuit = suit;
				else
					msuit = Suit.None;
			}
			else
				throw new InvalidOperationException("\"" + cardvalue + "\" is not a valid card value character.");
		}
		#endregion

		#region FIELDS
		/// <summary>
		/// Gets the short display string for the card. This looks like A♥ and is always 2 characters long.
		/// For Jokers, the second character is a blank (no suit).
		/// </summary>
		public string ShortDisplayString
		{
			get { return mvalue + CardDeck.stringsuits[(int)Suit]; }
		}

		/// <summary>
		/// Gets the value of the card. The range is from A to 2
		/// </summary>
		public string Value
		{
			get { return mvalue; }
		}
		private string mvalue = "";

		/// <summary>
		/// Gets the suit of the card or Suit.None when it is a Joker
		/// </summary>
		public Suit Suit
		{
			get { return msuit; }
		}
		private Suit msuit = Suit.None;
		#endregion

		#region INTERNAL MEMBERS AND OVERRIDES FOR THE CARD DECK
		/// <summary>
		/// Card already dealt?
		/// </summary>
		internal bool IsDealt = false;

		/// <summary>
		/// Raises the <see cref="E:PreResultEvaluation"/> event.
		/// </summary>
		/// <param name="e">The <see cref="System.EventArgs"/> instance containing the event data.</param>
		public override void OnRDSPreResultEvaluation(EventArgs e)
		{
			base.OnRDSPreResultEvaluation(e);
			rdsEnabled = !IsDealt;
		}

		/// <summary>
		/// Raises the <see cref="E:Hit"/> event.
		/// </summary>
		/// <param name="e">The <see cref="System.EventArgs"/> instance containing the event data.</param>
		public override void OnRDSHit(EventArgs e)
		{
			base.OnRDSHit(e);
			IsDealt = true;
			rdsEnabled = false;
		}
		#endregion

		public override string ToString()
		{
			return "\"" + ShortDisplayString + "\" " + base.ToString();
		}
	}
}