Ajax Control Toolkit ToggleButton

Modified on 2010/04/16 01:17 by Stephen Walther — Categorized as: Uncategorized

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.

ToggleButton Server Properties

The properties in italics 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.