iserverbuddylist.cs

来自「Gibphone is CSharp Program, it can tell 」· CS 代码 · 共 53 行

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

namespace GPCore.Protocols
{
    /// <summary>
    /// An interface to extend IProtocol to support a server-side buddylist.
    /// </summary>
    public interface IServerBuddyList : IProtocol
    {
        /// <summary>
        /// Called to add a contact to the Server's Buddy List.
        /// </summary>
        /// <param name="username">The Username to add.</param>
        /// <param name="groupkey">The Group of the new Contact.</param>
        void AddBuddy(string username, string groupkey);
        /// <summary>
        /// Called to change the Alias of a contact.
        /// </summary>
        /// <param name="username">The Username of the Buddy.</param>
        /// <param name="alias">The new Alias for this Buddy.</param>
        void ChangeAlias(string username, string alias);
        /// <summary>
        /// Called to change the group of a contact.
        /// </summary>
        /// <param name="username">The username of the buddy.</param>
        /// <param name="newgroup">The new group for this buddy.</param>
        void ChangeGroup(string username, string newgroup);
        /// <summary>
        /// Called to remove a buddy from the Server's list.
        /// </summary>
        /// <param name="username">The username of the buddy to remove.</param>
        void RemoveBuddy(string username);
        /// <summary>
        /// Called to add an empty group to the list.
        /// </summary>
        /// <param name="group">The name of the group to add.</param>
        void AddGroup(string group);
        /// <summary>
        /// Called to rename a group.
        /// </summary>
        /// <param name="oldgroup">The old name.</param>
        /// <param name="newgroup">The new name.</param>
        void RenameGroup(string oldgroup, string newgroup);
        /// <summary>
        /// Called to remove a group from the Server's List.
        /// </summary>
        /// <param name="group">The name of the group to remove.</param>
        void RemoveGroup(string group);        
    }
}