RadAjaxLoadingPanel
RadAjaxPanel is one of the two major controls of the Telerik RadAjax suite. The other one is RadAjaxManager. The RadAjaxPanel control provides the easiest way to AJAX-enable ASP.NET web control(s). To do this you simply need to place the controls that you want ajaxified into RadAjaxPanel and Telerik RadAjax takes care of the rest. Best of all this happens transparently to the framework and the controls that are being ajaxified.
Definition
Namespace:Telerik.Web.UI
Assembly:Telerik.Web.UI.dll
Syntax:
[ToolboxBitmap(typeof(RadAjaxLoadingPanel), "Toolbox.Icons.Ajax.png")]
[TelerikToolboxCategory("Miscellaneous")]
[EmbeddedSkin("Ajax")]
[EmbeddedSkin("Ajax", "Default")]
[ClientScriptResource("Telerik.Web.UI.RadAjaxLoadingPanel", "Telerik.Web.UI.Ajax.Ajax.js")]
[ClientScriptResource("Telerik.Web.UI.RadAjaxLoadingPanel", "Telerik.Web.UI.Common.Navigation.OverlayScript.js")]
[RequiredScript(typeof(Core))]
[RequiredScript(typeof(jQuery))]
public class RadAjaxLoadingPanel : Panel, IComponent, IDisposable, IParserAccessor, IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor, IExpressionsAccessor, IAttributeAccessor, IScriptControl, IControlResolver, ISkinnableControl, IControl
Inheritance: objectControlWebControlPanelRadAjaxLoadingPanel
Implements:
Inherited Members
Properties
Gets or sets animation duration in milliseconds. Default value is 0, i.e. no animation.
public int AnimationDuration { get; set; }
Gets or sets the position of the skin background image. Default value is center.
public AjaxLoadingPanelBackgroundPosition BackgroundPosition { get; set; }
Gets or sets transparency of the loading panel without affecting the icon. Default value is 0 percents.
public int BackgroundTransparency { get; set; }
protected virtual string CssClassFormatString { get; }
Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests
public virtual bool EnableAjaxSkinRendering { get; set; }
Implements:
If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax.
When set to true enables support for WAI-ARIA
public bool EnableAriaSupport { get; set; }
Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not.
public virtual bool EnableEmbeddedBaseStylesheet { get; set; }
Implements:
If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand.
Gets or sets the value, indicating whether to render script references to the embedded scripts or not.
public virtual bool EnableEmbeddedScripts { get; set; }
Implements:
If EnableEmbeddedScripts is set to false you will have to register the needed Scripts files by hand.
Gets or sets the value, indicating whether to render links to the embedded skins or not.
public virtual bool EnableEmbeddedSkins { get; set; }
Implements:
If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand.
Defines whether the transparency set in the skin will be applied. Default value is True.
public bool EnableSkinTransparency { get; set; }
Gets or sets a value specifying the delay in milliseconds, after which the RadAjaxLoadingPanel will be shown. If the request returns before this time, the RadAjaxLoadingPanel will not be shown.
public int InitialDelayTime { get; set; }
The IsSticky property of the Loading Panel controls where the panel will appear during the AJAX request. If this property is set to true, the panel will appear where you have placed it on your webform. If this property is set to false, the Loading panel will appear on the place of the updated control(s).
By default this property is set to false.
public bool IsSticky { get; set; }
Gets or sets a value that specifies the minimum time in milliseconds that the RadAjaxLoadingPanel will last. The control will not be updated before this period has passed even if the request returns. This will ensure more smoother interface for your page.
public int MinDisplayTime { get; set; }
Gets or sets the value, indicating whether the loading panel will be displayed over the entire visible area of the page.
[ClientControlProperty]
public virtual bool Modal { get; set; }
[ClientControlEvent]
[ClientPropertyName("hiding")]
public string OnClientHiding { get; set; }
[ClientControlEvent]
[ClientPropertyName("showing")]
public string OnClientShowing { get; set; }
Gets or sets a value indicating whether the loading panel will create an overlay element to ensure popups are over a flash element or Java applet.
[Browsable(true)]
[Bindable(true)]
public bool Overlay { get; set; }
The default value is false.
Gets or sets the value, indicating whether to register with the ScriptManager control on the page.
public virtual bool RegisterWithScriptManager { get; set; }
Implements:
If RegisterWithScriptManager is set to false the control can be rendered on the page using Web Services or normal callback requests/page methods.
Specifies the rendering mode of the control. Setting the mode to Lightweight will yield HTML 5/CSS 3 html and css.
[ClientControlProperty]
public RenderMode RenderMode { get; set; }
Implements:
Lightweight rendering mode might change the outlook of the component in some older browsers that don't support CSS3/HTML5.
Returns resolved RenderMode should the original value was Auto
public virtual RenderMode ResolvedRenderMode { get; }
Implements:
Gets the real skin name for the control user interface. If Skin is not set, returns an empty string, otherwise returns Skin.
protected string RuntimeSkin { get; }
Gets or sets the skin name for the control user interface.
[TypeConverter("Telerik.Web.Design.SkinTypeConverter, Telerik.Web.Design, Version=2026.3.812.462, Culture=neutral, PublicKeyToken=121fae78165ba3d4")]
public virtual string Skin { get; set; }
A string containing the skin name for the control user interface. The default is string.Empty.
Implements:
If this property is not set, the control will not use any skin (backwards compatibility) If EnableEmbeddedSkins is set to false, the control will not register a skin CSS file automatically.
Gets or sets transparency in percentage. Default value is 0 percents.
public int Transparency { get; set; }
Methods
protected override void AddAttributesToRender(HtmlTextWriter writer)
Overrides:
protected void ConfigureCombinedBaseSkinFile()
protected void ConfigureCombinedScriptFile()
protected virtual void ControlPreRender()
For internal use only
public virtual RenderMode PreferredRenderMode(RenderModeBrowserAdaptor browser)
RenderModeBrowserAdaptor instance
Returns:Returns the preferred RenderMode
Implements:
Registers the CSS references
protected virtual void RegisterCssReferences()
protected override void RenderContents(HtmlTextWriter writer)
Overrides: