[Magicajax-cvs] magicajax/Core/Interfaces ICallBackEventHandler.cs,NONE,1.1 IFormDataLoadedEventHandler.cs,NONE,1.1 IPreWriteScriptEventHandler.cs,NONE,1.1 IScriptWriter.cs,NONE,1.1

[Argiris K. <be...@us...>]

Update of /cvsroot/magicajax/magicajax/Core/Interfaces
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv6302/Core/Interfaces

Added Files:
	ICallBackEventHandler.cs IFormDataLoadedEventHandler.cs 
	IPreWriteScriptEventHandler.cs IScriptWriter.cs 
Log Message:
Put source files to module 'magicajax' divided in directories Core, Examples, and CustomControls.

--- NEW FILE: ICallBackEventHandler.cs ---
#region LGPL License
/*
MagicAjax Library
Copyright (C) 2005  MagicAjax Project Team

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
#endregion

using System;

namespace MagicAjax
{
	/// <summary>
	/// Interface for controls that do no inherit from AjaxControl and want to receive
	/// CallBack events.
	/// </summary>
	/// <remarks>
	/// The Load event of the page and its child controls is not raised during a CallBack.
	/// If you want to handle the CallBack event instead, implement the ICallBackEventHandler
	/// on the page or on a cuatom control.
	/// </remarks>
	/// <example>
	///	public class CustomTextBox : System.Web.UI.WebControls.TextBox, ICallBackEventHandler
	///	{
	///		public void RaiseCallBackEvent()
	///		{
	///			OnCallBack(EventArgs.Empty);
	///		}
	///	}
	/// </example>
	public interface ICallBackEventHandler
	{
		void RaiseCallBackEvent();
	}
}

--- NEW FILE: IFormDataLoadedEventHandler.cs ---
#region LGPL License
/*
MagicAjax Library
Copyright (C) 2005  MagicAjax Project Team

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
#endregion

using System;

namespace MagicAjax
{
	/// <summary>
	/// Interface for controls that want to receive the PostDataLoaded event that is
	/// raised by MagicAjaxModule.
	/// </summary>
	/// <remarks>
	/// The PostDataLoadedEvent is raised by MagicAjaxModule after it loads the post data
	/// to the controls of the page, and before it raises the CallBack event. The event
	/// handler should not alter any IPostBackDataHandler controls because it may
	/// interfere with the functionality of other IFormDataLoadedEventHandler handlers.
	/// 
	/// i.e. the AjaxPanel is handling this event in order to cache the html rendering
	/// of the controls that receive post data. If you change such a control during
	/// the PostDataLoaded event, the AjaxPanel will cache the change and it will not
	/// render it on the client.
	/// </remarks>
	public interface IFormDataLoadedEventHandler
	{
		/// <summary>
		/// Raises the PostDataLoaded event
		/// </summary>
		/// <param name="changedControls">A list of controls with changed post data</param>
		void RaiseFormDataLoadedEvent(MagicAjax.Collections.ReadOnlyArrayList changedControls);
	}
}

--- NEW FILE: IPreWriteScriptEventHandler.cs ---
#region LGPL License
/*
MagicAjax Library
Copyright (C) 2005  MagicAjax Project Team

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
#endregion

using System;

namespace MagicAjax
{
	/// <summary>
	/// Interface for controls and pages that do no inherit from RenderedByScriptControl
	/// and want to receive PreWriteScript events.
	/// </summary>
	public interface IPreWriteScriptEventHandler
	{
		void RaisePreWriteScriptEvent();
	}
}

--- NEW FILE: IScriptWriter.cs ---
#region LGPL License
/*
MagicAjax Library
Copyright (C) 2005  MagicAjax Project Team

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
#endregion

using System;

namespace MagicAjax
{
	/// <summary>
	/// Interface for controls and pages that do no inherit from RenderedByScriptControl
	/// and want to get the WriteScript call.
	/// </summary>
	/// <remarks>
	/// WriteScript is called by MagicAjaxModule. A control that implements this method
	/// must use CallBackHelper.Write and the rest Write methods to send javascript
	/// code to the client.
	public interface IScriptWriter
	{
		void WriteScript();
	}
}