refactor QueueMemberEventClasses

Asterisk.2013/Asterisk.NET/Manager/Event/AbstractQueueMemberEvent.cs

@@ -5,20 +5,118 @@ namespace AsterNET.Manager.Event
     /// </summary>
     public abstract class AbstractQueueMemberEvent : ManagerEvent
     {
+        /// <summary>
+        /// AbstractQueueMemberEvent contructor
+        /// </summary>
+        /// <param name="source">ManagerConnection passed through in the event.</param>
         public AbstractQueueMemberEvent(ManagerConnection source)
             : base(source)
         {
         }
 
         /// <summary>
-        ///     Returns the name of the queue.
+        /// The name of the queue.
         /// </summary>
         public string Queue { get; set; }
 
         /// <summary>
         /// Returns the name of the member's interface.<br />
-        ///     E.g. the channel name or agent group.
+        /// E.g. the channel name or agent group.<br />
+        /// <b>Removed since : </b> <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+13+Documentation" target="_blank" alt="Asterisk 12 wiki docs">Asterisk 12</see>.<br/>
+        /// <b>Replaced by : </b> <see cref="Interface"/> since <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Documentation" target="_blank" alt="Asterisk 12 wiki docs">Asterisk 12</see>.
         /// </summary>
         public string Location { get; set; }
+
+        /// <summary>
+        /// The queue member's channel technology or location.<br />
+        /// <b>Available since : </b> <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Documentation" target="_blank" alt="Asterisk 12 wiki docs">Asterisk 12</see>.
+        /// </summary>
+        public string Interface { get; set; }
+
+        /// <summary>
+        /// Channel technology or location from which to read device state changes.<br />
+        /// <b>Available since : </b> <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Documentation" target="_blank" alt="Asterisk 12 wiki docs">Asterisk 12</see>.
+        /// </summary>
+        public string StateInterface { get; set; }
+
+        /// <summary>
+        /// The name of the queue member.<br />
+        /// <b>Available since : </b> <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Documentation" target="_blank" alt="Asterisk 12 wiki docs">Asterisk 12</see>.
+        /// </summary>
+        public string MemberName { get; set; }
+
+        /// <summary>
+		/// "dynamic" if the added member is a dynamic queue member,<br />
+		/// "realtime" if the added member is a realtime queue member,<br />
+		/// "static" if the added member is a static queue member.<br />
+        /// <b>Available since : </b> <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Documentation" target="_blank" alt="Asterisk 12 wiki docs">Asterisk 12</see>.
+        /// </summary>
+        public string Membership { get; set; }
+
+        /// <summary>
+        /// The penalty associated with the queue member. When calls are distributed members with higher penalties are considered last.<br />
+        /// <b>Available since : </b> <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Documentation" target="_blank" alt="Asterisk 12 wiki docs">Asterisk 12</see>.
+        /// </summary>
+        public int Penalty { get; set; }
+
+        /// <summary>
+        /// The number of calls this queue member has serviced.<br />
+        /// <b>Available since : </b> <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Documentation" target="_blank" alt="Asterisk 12 wiki docs">Asterisk 12</see>.
+        /// </summary>
+        public int CallsTaken { get; set; }
+
+        /// <summary>
+        /// The time this member last took a call, expressed in seconds since 00:00, Jan 1, 1970 UTC.<br />
+        /// <b>Available since : </b> <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Documentation" target="_blank" alt="Asterisk 12 wiki docs">Asterisk 12</see>.
+        /// </summary>
+        public long LastCall { get; set; }
+
+        /// <summary>
+        /// When queue member is paused (not accepting calls).<br/>
+        /// Evaluates <see langword="true"/> if this member has been paused,
+        /// <see langword="false"/> if not.<br />
+        /// <b>Available since : </b> <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Documentation" target="_blank" alt="Asterisk 12 wiki docs">Asterisk 12</see>.
+        /// </summary>
+        public bool Paused { get; set; }
+
+        /// <summary>
+        /// The numeric device state status of the queue member.<br/>
+        /// <para>
+        /// Valid status codes are:<br/>
+        /// <list type="number" start="0">
+        /// <item>AST_DEVICE_UNKNOWN</item>
+        /// <item>AST_DEVICE_NOT_INUSE</item>
+        /// <item>AST_DEVICE_INUSE</item>
+        /// <item>AST_DEVICE_BUSY</item>
+        /// <item>AST_DEVICE_INVALID</item>
+        /// <item>AST_DEVICE_UNAVAILABLE</item>
+        /// <item>AST_DEVICE_RINGING</item>
+        /// <item>AST_DEVICE_RINGINUSE</item>
+        /// <item>AST_DEVICE_ONHOLD</item>
+        /// </list>
+        /// </para>
+        /// <b>Available since : </b> <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Documentation" target="_blank" alt="Asterisk 12 wiki docs">Asterisk 12</see>.
+        /// </summary>
+        public int Status { get; set; }
+
+        /// <summary>
+        /// Evaluates <see langword="true"/> if Ringinuse,
+        /// <see langword="false"/> if not.<br />
+        /// <b>Available since : </b> <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Documentation" target="_blank" alt="Asterisk 12 wiki docs">Asterisk 12</see>.
+        /// </summary>
+        public bool Ringinuse { get; set; }
+
+        /// <summary>
+        /// Evaluates <see langword="true"/> if member is in call,
+        /// <see langword="false"/> after LastCall time is updated.<br />
+        /// <b>Available since : </b> <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+13+Documentation" target="_blank" alt="Asterisk 13 wiki docs">Asterisk 13</see>.
+        /// </summary>
+        public bool InCall { get; set; }
+
+        /// <summary>
+        /// If set when paused, the reason the queue member was paused.<br />
+        /// <b>Available since : </b> <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+13+Documentation" target="_blank" alt="Asterisk 13 wiki docs">Asterisk 13</see>.
+        /// </summary>
+        public string PausedReason { get; set; }
     }
 }

Asterisk.2013/Asterisk.NET/Manager/Event/QueueMemberAddedEvent.cs

@@ -3,96 +3,68 @@ namespace AsterNET.Manager.Event
     /// <summary>
     /// A QueueMemberAddedEvent is triggered when a queue member is added to a queue.<br/>
     /// It is implemented in apps/app_queue.c.<br/>
-	/// Available since Asterisk 1.2
+    /// <para>
+    /// <b>Available since : </b> <see href="http://www.voip-info.org/wiki/view/Asterisk+v1.2" target="_blank" alt="Asterisk 1.2 wiki docs">Asterisk 1.2</see>.<br/>
+    /// </para>
     /// </summary>
     public class QueueMemberAddedEvent : AbstractQueueMemberEvent
 	{
-		private string memberName;
-		private string membership;
-		private int penalty;
-		private int callsTaken;
-		private long lastCall;
-		private int status;
-		private bool paused;
-
 		/// <summary>
 		/// Returns the name of the member's interface.<br/>
 		/// E.g. the channel name or agent group.
 		/// </summary>
-		public string MemberName
+		public new string MemberName { get; set; }
-		{
-			get { return this.memberName; }
-			set { this.memberName = value; }
-		}
 
         /// <summary>
         /// Get/Set if the added member is a dynamic or static queue member.
         /// "dynamic" if the added member is a dynamic queue member,
         /// "static" if the added member is a static queue member.
         /// </summary>
-		public string Membership
+        public new string Membership { get; set; }
-		{
+
-			get { return membership; }
-			set { this.membership = value; }
-		}
         /// <summary>
         /// Get/Set the penalty for the added member. When calls are distributed
         /// members with higher penalties are considered last.
         /// </summary>
-		public int Penalty
+        public new int Penalty { get; set; }
-		{
+
-			get { return penalty; }
-			set { this.penalty = value; }
-		}
         /// <summary>
         /// Get/Set the number of calls answered by the member.
         /// </summary>
-		public int CallsTaken
+        public new int CallsTaken { get; set; }
-		{
+
-			get { return callsTaken; }
-			set { this.callsTaken = value; }
-		}
         /// <summary>
         /// Get/Set the time (in seconds since 01/01/1970) the last successful call answered by the added member was hungup.
         /// </summary>
-		public long LastCall
+        public new long LastCall { get; set; }
-		{
+
-			get { return lastCall; }
-			set { this.lastCall = value; }
-		}
         /// <summary>
         /// Get/Set the status of this queue member.<br/>
         /// Valid status codes are:<br/>
-		/// <dl>
+        /// <list type="number" start="0">
-		/// <dt>AST_DEVICE_UNKNOWN (0)</dt>
+        /// <item>AST_DEVICE_UNKNOWN</item>
-		/// <dd>Queue member is available</dd>
+        /// <item>AST_DEVICE_NOT_INUSE</item>
-		/// <dt>AST_DEVICE_NOT_INUSE (1)</dt>
+        /// <item>AST_DEVICE_INUSE</item>
-		/// <dd>?</dd>
+        /// <item>AST_DEVICE_BUSY</item>
-		/// <dt>AST_DEVICE_INUSE (2)</dt>
+        /// <item>AST_DEVICE_INVALID</item>
-		/// <dd>?</dd>
+        /// <item>AST_DEVICE_UNAVAILABLE</item>
-		/// <dt>AST_DEVICE_BUSY (3)</dt>
+        /// <item>AST_DEVICE_RINGING</item>
-		/// <dd>?</dd>
+        /// <item>AST_DEVICE_RINGINUSE</item>
-		/// <dt>AST_DEVICE_INVALID (4)</dt>
+        /// <item>AST_DEVICE_ONHOLD</item>
-		/// <dd>?</dd>
+        /// </list>
-		/// <dt>AST_DEVICE_UNAVAILABLE (5)</dt>
-		/// <dd>?</dd>
-		/// </dl>
         /// </summary>
-		public int Status
+        public new int Status { get; set; }
-		{
+
-			get { return status; }
-			set { this.status = value; }
-		}
         /// <summary>
         /// Get/Set value if this queue member is paused (not accepting calls).<br/>
         /// true if this member has been paused or false if not.
         /// </summary>
-		public bool Paused
+        public new bool Paused { get; set; }
-		{
-			get { return paused; }
-			set { this.paused = value; }
-		}
 
+        /// <summary>
+        /// Creates a new QueueMemberAddedEvent
+        /// </summary>
+        /// <param name="source">ManagerConnection passed through in the event.</param>
         public QueueMemberAddedEvent(ManagerConnection source)
 			: base(source)
 		{

Asterisk.2013/Asterisk.NET/Manager/Event/QueueMemberPauseEvent.cs

@@ -4,39 +4,19 @@ namespace AsterNET.Manager.Event
 {
     /// <summary>
     /// Raised when a member is paused/unpaused in the queue.<br />
-    /// Available since Asterisk 12
+    /// <b>Available since : </b> <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Documentation" target="_blank" alt="Asterisk 12 wiki docs">Asterisk 12</see>.
     /// </summary>
     public class QueueMemberPauseEvent : AbstractQueueMemberEvent
     {
-        /// <summary>
-        /// The name of the queue member.
-        /// </summary>
-        public string MemberName { get; set; }
-
-        /// <summary>
-        /// Get/Set if this queue member is paused (not accepting calls).<br/>
-        /// true if this member has been paused or
-        /// false if not.
-        /// </summary>
-        public bool Paused { get; set; }
-
         /// <summary>
         /// The reason a member was paused.
         /// </summary>
         public string Reason { get; set; }
 
         /// <summary>
-        /// Set to 1 if member is in call. Set to 0 after LastCall time is updated.<br/>
+        /// Creates a new QueueMemberPauseEvent
-        /// Available since Asterisk 13
         /// </summary>
-        public string InCall { get; set; }
+        /// <param name="source">ManagerConnection passed through in the event.</param>
-
-        /// <summary>
-        /// If set when paused, the reason the queue member was paused.<br/>
-        /// Available since Asterisk 13
-        /// </summary>
-        public string PausedReason { get; set; }
-
         public QueueMemberPauseEvent(ManagerConnection source)
 			: base(source)
 		{

Asterisk.2013/Asterisk.NET/Manager/Event/QueueMemberPausedEvent.cs

@@ -6,43 +6,32 @@ namespace AsterNET.Manager.Event
     /// A QueueMemberPausedEvent is triggered when a queue member is paused or unpaused.<br/>
     /// It is implemented in apps/app_queue.c.<br/>
     /// <para>
-    /// Available since Asterisk 1.2.<br/>
+    /// <b>Available since : </b> <see href="http://www.voip-info.org/wiki/view/Asterisk+v1.2" target="_blank" alt="Asterisk 1.2 wiki docs">Asterisk 1.2</see>.<br/>
-    /// Replaced by <see cref="QueueMemberPauseEvent"/> since Asterisk 12.<br/>
+    /// <b>Replaced by : </b> <see cref="QueueMemberPauseEvent"/> since <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Documentation" target="_blank" alt="Asterisk 12 wiki docs">Asterisk 12</see>.<br/>
-    /// Removed since Asterisk 13.<br/>
+    /// <b>Removed since : </b> <see href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+13+Documentation" target="_blank" alt="Asterisk 13 wiki docs">Asterisk 13</see>.<br/>
     /// </para>
     /// </summary>
 	public class QueueMemberPausedEvent : AbstractQueueMemberEvent
 	{
-		private string memberName;
+        /// <summary>
-		private bool paused;
+        /// The reason a member was paused
-		private string reason;
+        /// </summary>
+        public string Reason { get; set; }
 
         /// <summary>
-		/// Returns the name of the member's interface.<br/>
+        /// <b>Not Available</b>, use <see cref="QueueMemberPauseEvent"/> instead.
-		/// E.g. the channel name or agent group.
         /// </summary>
-		public string MemberName
+        public new string PausedReason { get; set; }
-		{
-			get { return this.memberName; }
-			set { this.memberName = value; }
-		}
 
         /// <summary>
-		/// Get/Set if this queue member is paused (not accepting calls).<br/>
+        /// <b>Not Available</b>, use <see cref="QueueMemberPauseEvent"/> instead.
-		/// true if this member has been paused or
-		/// false if not.
         /// </summary>
-		public bool Paused
+        public new bool InCall { get; set; }
-		{
-			get { return this.paused; }
-			set { this.paused = value; }
-		}
 
-		public string Reason
+        /// <summary>
-		{
+        /// Creates a new QueueMemberPausedEvent
-			get { return this.reason; }
+        /// </summary>
-			set { this.reason = value; }
+        /// <param name="source">ManagerConnection passed through in the event.</param>
-		}
         public QueueMemberPausedEvent(ManagerConnection source)
 			: base(source)
 		{

Asterisk.2013/Asterisk.NET/Manager/Event/QueueMemberPenaltyEvent.cs

@@ -5,17 +5,15 @@ namespace AsterNET.Manager.Event
 	/// </summary>
 	public class QueueMemberPenaltyEvent : AbstractQueueMemberEvent
 	{
-		private int penalty;
-
 		/// <summary>
 		/// Get/Set the penalty for the queue location.
 		/// </summary>
-		public int Penalty
+		public new int Penalty { get; set; }
-		{
-			get { return this.penalty; }
-			set { this.penalty = value; }
-		}
 
+        /// <summary>
+        /// Creates a new QueueMemberPenaltyEvent
+        /// </summary>
+        /// <param name="source">ManagerConnection passed through in the event.</param>
         public QueueMemberPenaltyEvent(ManagerConnection source)
 			: base(source)
 		{

Asterisk.2013/Asterisk.NET/Manager/Event/QueueMemberRemovedEvent.cs

@@ -3,22 +3,22 @@ namespace AsterNET.Manager.Event
     /// <summary>
     /// A QueueMemberRemovedEvent is triggered when a queue member is removed from a queue.<br/>
     /// It is implemented in apps/app_queue.c.<br/>
-	/// Available since Asterisk 1.2
+    /// <para>
+    /// <b>Available since : </b> <see href="http://www.voip-info.org/wiki/view/Asterisk+v1.2" target="_blank" alt="Asterisk 1.2 wiki docs">Asterisk 1.2</see>.<br/>
+    /// </para>
     /// </summary>
     public class QueueMemberRemovedEvent : AbstractQueueMemberEvent
 	{
-		private string memberName;
-
 		/// <summary>
 		/// Returns the name of the member's interface.<br/>
 		/// E.g. the channel name or agent group.
 		/// </summary>
-		public string MemberName
+		public new string MemberName { get; set; }
-		{
-			get { return this.memberName; }
-			set { this.memberName = value; }
-		}
 
+        /// <summary>
+        /// Creates a new QueueMemberRemovedEvent
+        /// </summary>
+        /// <param name="source">ManagerConnection passed through in the event.</param>
 		public QueueMemberRemovedEvent(ManagerConnection source)
 			: base(source)
 		{

Asterisk.2013/Asterisk.NET/Manager/Event/QueueMemberRinginuseEvent.cs

@@ -0,0 +1,24 @@
+namespace AsterNET.Manager.Event
+{
+    /// <summary>
+    /// Raised when a member's ringinuse setting is changed
+    /// </summary>
+    public class QueueMemberRinginuseEvent : AbstractQueueMemberEvent
+    {
+
+        /// <summary>
+        /// Evaluates <see langword="true"/> if Ringinuse,
+        /// <see langword="false"/> if not.<br />
+        /// </summary>
+        public new bool Ringinuse { get; set; }
+
+        /// <summary>
+        /// Creates a new QueueMemberRinginuseEvent
+        /// </summary>
+        /// <param name="source">ManagerConnection passed through in the event.</param>
+		public QueueMemberRinginuseEvent(ManagerConnection source)
+			: base(source)
+		{
+		}
+	}
+}

Asterisk.2013/Asterisk.NET/Manager/Event/QueueMemberStatusEvent.cs

@@ -1,10 +1,77 @@
 namespace AsterNET.Manager.Event
 {
     /// <summary>
-	/// A QueueMemberStatusEvent shows the status of a QueueMemberEvent
+    /// Raised when a Queue member's status has changed
     /// </summary>
-	public class QueueMemberStatusEvent : QueueMemberEvent
+    public class QueueMemberStatusEvent : AbstractQueueMemberEvent
     {
+        /// <summary>
+        /// Returns the name of the member's interface.<br/>
+        /// E.g. the channel name or agent group.
+        /// </summary>
+        public new string MemberName { get; set; }
+
+        /// <summary>
+        /// Channel technology or location from which to read device state changes.<br />
+        /// </summary>
+        public new string StateInterface { get; set; }
+
+        /// <summary>
+        /// Get/Set if the added member is a dynamic or static queue member.
+        /// "dynamic" if the added member is a dynamic queue member,
+        /// "static" if the added member is a static queue member.
+        /// </summary>
+        public new string Membership { get; set; }
+
+        /// <summary>
+        /// Get/Set the penalty for the added member. When calls are distributed
+        /// members with higher penalties are considered last.
+        /// </summary>
+        public new int Penalty { get; set; }
+
+        /// <summary>
+        /// Get/Set the number of calls answered by the member.
+        /// </summary>
+        public new int CallsTaken { get; set; }
+
+        /// <summary>
+        /// Get/Set the time (in seconds since 01/01/1970) the last successful call answered by the added member was hungup.
+        /// </summary>
+        public new long LastCall { get; set; }
+
+        /// <summary>
+        /// Evaluates <see langword="true"/> if member is in call,
+        /// <see langword="false"/> after LastCall time is updated.<br />
+        /// </summary>
+        public new bool InCall { get; set; }
+
+        /// <summary>
+        /// Get/Set the status of this queue member.<br/>
+        /// Valid status codes are:<br/>
+        /// <list type="number" start="0">
+        /// <item>AST_DEVICE_UNKNOWN</item>
+        /// <item>AST_DEVICE_NOT_INUSE</item>
+        /// <item>AST_DEVICE_INUSE</item>
+        /// <item>AST_DEVICE_BUSY</item>
+        /// <item>AST_DEVICE_INVALID</item>
+        /// <item>AST_DEVICE_UNAVAILABLE</item>
+        /// <item>AST_DEVICE_RINGING</item>
+        /// <item>AST_DEVICE_RINGINUSE</item>
+        /// <item>AST_DEVICE_ONHOLD</item>
+        /// </list>
+        /// </summary>
+        public new int Status { get; set; }
+
+        /// <summary>
+        /// Get/Set value if this queue member is paused (not accepting calls).<br/>
+        /// true if this member has been paused or false if not.
+        /// </summary>
+        public new bool Paused { get; set; }
+
+        /// <summary>
+        /// Creates a new QueueMemberStatusEvent
+        /// </summary>
+        /// <param name="source">ManagerConnection passed through in the event.</param>
 		public QueueMemberStatusEvent(ManagerConnection source)
 			: base(source)
 		{