Ajax Control Toolkit
ToggleButton Demonstration





[No response provided yet]
ToggleButton Description

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 Properties

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.
ToggleButton Video
Watch the Video How Do I: Use the ASP.NET AJAX ToggleButton Extender?
Demonstrates using the ToggleButton extender control to modify the behavior and appearance of the standard ASP.NET CheckBox control to enhance the user interface.

Watch the Video
Copyright © 2006-2007 Microsoft Corporation. All Rights Reserved.