ToggleButton is an ASP.NET AJAX extender that can be attached to an ASP.NET CheckBox control. ToggleButton enables the use of custom images to show the state of the CheckBox. The behavior of the CheckBox is unaffected.

The control above is initialized with this code. The italic properties are optional:

<ajaxToolkit:ToggleButtonExtender ID="ToggleEx" runat="server"

    TargetControlID="CheckBox1"

    ImageWidth="19"

    ImageHeight="19"

    CheckedImageAlternateText="Check"

    UncheckedImageAlternateText="UnCheck"

    UncheckedImageUrl="ToggleButton_Unchecked.gif"

    CheckedImageUrl="ToggleButton_Checked.gif" />

    * TargetControlID - The ID of the CheckBox to modify

    * ImageHeight\ImageWidth - The height and width of the image

    * CheckedImageUrl - the URL of the image to show when the toggle button is in the checked state.

    * UncheckedImageUrl - the URL of the image to show when the toggle button is in the unchecked state.

    * DisabledCheckedImageUrl - the URL of the image to show when the toggle button is disabled and in the checked state.

    * DisabledUncheckedImageUrl - the URL of the image to show when the toggle button is disabled and in the unchecked state.

    * CheckedImageOverUrl - the URL of the image to show when the toggle button is in the checked state and the mouse is over the button.

    * UncheckedImageOverUrl - the URL of the image to show when the toggle button is in the unchecked state and the mouse is over the button.

    * CheckedImageAlternateText - the alt text to show when the toggle button is in the checked state.

    * UncheckedImageAlternateText - the alt text to show when the toggle button is in the unchecked state.

    * CheckedImageOverAlternateText - the alt text to show when the toggle button is in the checked state and the mouse is over the button.

    * UncheckedImageOverAlternateText - the alt text to show when the toggle button is in the unchecked state and the mouse is over the button.

    * ImageHeight/ImageWidth - The height and width, respectively, of the image that will be displayed.