ASPxCaptcha.RefreshButton Property

Accesses the settings of the CAPTCHA editor’s refresh button.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.2.dll

Declaration

C#

public RefreshButtonProperties RefreshButton { get; }

VB.NET

Public ReadOnly Property RefreshButton As RefreshButtonProperties

Property Value

Type	Description
RefreshButtonProperties	A RefreshButtonProperties object that contains settings specific to an editor’s refresh button.

Remarks

The RefreshButton property allows you to access and customize the settings of the ASPxCaptcha‘s refresh button.

Example

The following part of the ASPxCaptcha - Custom Appearance online demo illustrates how to implement a captcha control with a custom appearance.

In this example, the control’s Refresh Button.ASPxCaptcha and Text Box.ASPxCaptcha are hidden, and their functionaliry is implemented in a custom manner using separate controls (the IMG element, ASPxLabel, ASPxTextBox).

JS

function GetRefreshButton() {
    return document.getElementById("refreshButton");
}        

function OnCaptchaBeginCallback(s, e) {
    var refreshButton = GetRefreshButton();
    refreshButton.src = "Images/refreshButtonAnimated.gif";
}

function OnCaptchaEndCallback(s, e) {
    var refreshButton = GetRefreshButton();
    refreshButton.src = "Images/refreshButton.gif"; 
    tbCode.SetValue("");
...   
}

ASPX

<img id="refreshButton" src="Images/refreshButton.gif" alt="Show another code" title="" 
class="refreshButton" onclick="captcha.Refresh();" />
...
<dx:ASPxCaptcha ID="Captcha" runat="server" SkinID="dummy" ClientInstanceName="captcha" 
CodeLength="6">
    <ChallengeImage BackgroundColor="Transparent" ForegroundColor="#676767" BorderWidth="0"
        Height="72" />
    <ValidationSettings EnableValidation="False">
    </ValidationSettings>
    <TextBox Visible="False" />
    <RefreshButton Visible="False">
    </RefreshButton>
    <LoadingPanel Enabled="False" />
    <ClientSideEvents BeginCallback="OnCaptchaBeginCallback" 
        EndCallback="OnCaptchaEndCallback" />
</dx:ASPxCaptcha>
...
<dx:ASPxLabel ID="lblCode" runat="server" AssociatedControlID="tbCode" Text="Type the code">
</dx:ASPxLabel>
...
<dx:ASPxTextBox ID="tbCode" runat="server" Width="200px" AutoCompleteType="Disabled"
    BackColor="Transparent" ClientInstanceName="tbCode">
    <Border BorderWidth="0px" />
</dx:ASPxTextBox>
...
<dx:ASPxButton ID="btnSubmit" runat="server" Text="Submit" UseSubmitBehavior="true"
    AutoPostBack="true" Width="175px">
</dx:ASPxButton>