ASPxButton.RenderMode Property

Specifies whether the button is rendered as a button or as a link.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v18.2.dll

Declaration

C#

[DefaultValue(ButtonRenderMode.Button)]
public ButtonRenderMode RenderMode { get; set; }

VB.NET

<DefaultValue(ButtonRenderMode.Button)>
Public Property RenderMode As ButtonRenderMode

Property Value

Type	Default	Description
ButtonRenderMode	**Button**	One of the ButtonRenderMode enumeration values.

Available values:

Name	Description
Button	The button is rendered as an input HTML element.
Link	The button is rendered as a hyperlink HTML element.
Secondary	Identifies a button of secondary importance.
Outline	Represents the button with a colored border and without a background color.
Danger	The button indicates a dangerous or potentially negative action.

Remarks

Use the RenderMode property to specify which element is used to render a button: a hyperlink (the Link value) or an input (the others values).

Use the Link mode to create a hyperlink-style button on the Web page. In this mode, a button control has the same appearance as a ASPxHyperLink control, but has the same functionality as a ASPxButton control. If you want to link to another Web page when the control is clicked, use the ASPxHyperLink control.

The code samples below demonstrate a button’s ASP markup and the corresponding HTML code rendered for this button.

• Button Render Mode

  

  ASPX

  
  <dx:ASPxButton ID="ASPxButton1" runat="server" Text="OK" >
       <Image IconID="actions_apply_16x16">
       </Image>
  </dx:ASPxButton>
  

  HTML

  
  <div id="ASPxButton1" class="dxbButton_MetropolisBlue dxbButtonSys" style="-moz-user-select: none; width: 52px; height: 24px;">
       <div id="ASPxButton1_CD" class="dxb" style="padding-top: 2px; padding-bottom: 3px;">
            <input class="dxb-hb" type="submit" name="ASPxButton1" value="OK">
            <img id="ASPxButton1Img" class="dxIcon_actions_apply_16x16 dx-vam" style="margin-right:4px;" alt="" src="/DXR.axd?r=1_11-10NW7">
            <span class="dx-vam" style="">OK</span>
       </div>
  </div>
  

• Link Render Mode

  Note

  In the Link render mode, the ASPxButton.UseSubmitBehavior and ASPxButton.Checked properties are not in effect.

  

  ASPX

  
  <dx:ASPxButton ID="ASPxButton3" runat="server" RenderMode="Link" Text="OK">
       <Image IconID="actions_apply_16x16">
       </Image>
  </dx:ASPxButton>
  

  HTML

  
  <a id="ASPxButton3" class="dxbButton_MetropolisBlue dxbButtonSys" href="javascript:;">
       <img id="ASPxButton3Img" class="dxIcon_actions_apply_16x16 dx-vam" style="margin-right:4px;" alt="" src="/DXR.axd?r=1_11-10NW7">
       <span class="dx-vam">OK</span>
  </a>