Render Modes
Some controls from the UI for ASP.NET AJAX suite can produce different (usually more lightweight) markup and make styling easier through CSS3. Below you can find a list with the modes each control supports. For more information on the feature and its benefits, examine the Render modes help article.
| Control | Lightweight Rendering | Mobile Rendering |
|---|---|---|
| Ajax | N/A | - |
| AutoCompleteBox | Yes (by design) | - |
| AsyncUpload | Yes (render mode) | - |
| BarCode | N/A | - |
| Button | Yes (render mode) | - |
| HtmlChart | N/A | - |
| Calendar | Yes (render mode) | - |
| Captcha | N/A | - |
| CheckBox | Yes (by design) | - |
| ColorPicker | Yes (render mode) | - |
| Combobox | Yes (render mode) | - |
| DataForm | Yes (by design) | - |
| DataPager | Yes (render mode) | Yes (render mode) |
| Diagram | Yes (by design) | - |
| Dock | Yes (render mode) | - |
| DropDownList | Yes (by design) | - |
| DropDownTree | Yes (by design) | - |
| Editor | Yes (render mode) | Yes (render mode) |
| FileExplorer | Yes (render mode) | - |
| Filter | Yes (render mode) | - |
| FormDecorator | Yes (render mode) | - |
| Gantt | Yes (by design) | - |
| Gauge | N/A | - |
| Grid | Yes (render mode) | Yes (render mode) |
| HtmlChart | Yes (by design) | - |
| ImageButton | Yes (render mode) | - |
| ImageEditor | Yes (render mode) | - |
| ImageGallery | Yes (by design) | Yes (render mode) |
| Input | Yes (render mode) | - |
| LightBox | Yes (by design) | Yes (render mode) |
| LinkButton | Yes (by design) | - |
| ListBox | Yes (render mode) | - |
| Map | N/A | - |
| MediaPlayer | Yes (by design) | Yes (render mode) |
| Menu | Yes (render mode) | Yes (render mode) |
| Notification | Yes (render mode) | - |
| OrgChart | Yes (render mode) | - |
| PanelBar | Yes (render mode) | - |
| PivotGrid | Yes (render mode) | - |
| ProgressArea | - | - |
| ProgressBar | Yes (by design) | - |
| PushButton | Yes (by design) | - |
| Rating | Yes (render mode) | - |
| RibbonBar | - | - |
| Rotator | Yes (by design) | - |
| SearchBox | Yes (by design) | - |
| Scheduler | - | Yes (render mode) |
| SiteMap | - | - |
| Slider | Yes (render mode) | - |
| SocialShare | Yes (render mode) | - |
| Spell | Yes (child control - Window) | - |
| Splitter | Yes (render mode) | - |
| TabStrip | - | - |
| TagCloud | Yes (by design) | - |
| Ticker | Yes (by design) | - |
| Tile | Yes (by design) | - |
| TileList | Yes (by design) | - |
| ToolBar | - | - |
| ToolTip | Yes(render mode) | - |
| ToggleButton | Yes(render mode) | - |
| TreeList | Yes (render mode) | - |
| TreeMap | Yes (by design) | - |
| TreeView | Yes (render mode) | - |
| Wizard | Yes (by design) | Yes (render mode) |
| Window | Yes (render mode) | - |
| XmlHttpPanel | N/A | - |
If you are extending the Telerik controls that support render modes through a property (i.e., they are not lightweight by design, for example), you need to addseveral properties to your class that will provide this functionality:
Example 1: Properties that enable you to use RenderModes for controls inherited from the Telerik controls.
public class BaseScheduler : RadScheduler
{
public BaseScheduler()
{
SetDefaultValues();
}
private void SetDefaultValues()
{
if (DesignMode)
{
return;
}
}
//only add this property if the base control implements Lightweight rendering via the RenderMode property
protected override bool SupportsLightweightRendering
{
get
{
return true;
}
}
//only add this property if the base control implements Adaptive (Mobile) rendering via the RenderMode property
protected override bool SupportsAdaptiveRendering
{
get
{
return true;
}
}
//only add this property if the base control implements Native rendering via the RenderMode property
protected override bool SupportsNativeRendering
{
get
{
return true;
}
}
}
Public Class BaseScheduler
Inherits RadScheduler
Public Sub New()
SetDefaultValues()
End Sub
Private Sub SetDefaultValues()
If DesignMode Then
Return
End If
End Sub
'only add this property if the base control implements Lightweight rendering via the RenderMode property
Protected Overrides ReadOnly Property SupportsLightweightRendering() As Boolean
Get
Return True
End Get
End Property
'only add this property if the base control implements Adaptive (Mobile) rendering via the RenderMode property
Protected Overrides ReadOnly Property SupportsAdaptiveRendering() As Boolean
Get
Return True
End Get
End Property
'only add this property if the base control implements Native rendering via the RenderMode property
Protected Overrides ReadOnly Property SupportsNativeRendering() As Boolean
Get
Return True
End Get
End Property
End Class
