/* 
 * ILWordTask.cs @Microsoft Visual Studio 2005 <.NET Framework 3.5>
 * AfritXia
 * 2007-12-05
 * 
 * Copyright(c) http://www.AfritXia.NET/
 * 
 */

using System;
using System.Collections.Generic;

using NET.AfritXia.MyHome.Model.Message;

namespace NET.AfritXia.MyHome.DBTask.Definition
{
	/// <summary>
	/// 留言任務(wù)接口
	/// </summary>
	public interface ILWordTask : IDBTask
	{
		/// <summary>
		/// 添加新留言
		/// </summary>
		/// <param name="newLword">新留言</param>
		void Append(LWord newLword);

		/// <summary>
		/// 刪除留言
		/// </summary>
		/// <param name="lwordUID">要刪除的留言 ID</param>
		void Delete(int lwordUID);

		/// <summary>
		/// 獲取留言列表
		/// </summary>
		/// <param name="startRecord">開始記錄位置</param>
		/// <param name="maxRecords">返回結(jié)果的最大記錄個(gè)數(shù)</param>
		/// <param name="allRecordCount">總記錄個(gè)數(shù)</param>
		/// <returns></returns>
		IList<LWord> ViewLWordList(int startRecord, int maxRecords, out int allRecordCount);

		/// <summary>
		/// 瀏覽留言
		/// </summary>
		/// <param name="lwordUID">留言 ID</param>
		/// <returns></returns>
		LWord ViewLWord(int lwordUID);
	}
}