SuperButton Object's Properties

Properties

Id Component Id. Optional CanBeFocused New Bool. If this property is set to true the button can be focused. 'ENTER' key press on focused button causes 'Click' effect. Optional, default: "false". oBut.CanBeFocused = true See also DefaultButton of HtmlForm working example. CausesValidation New Bool. Indicates whether clicking the control causes page validation to occur. This property has an effect only when isSubmit property is set to true. Optional, default: "false". oBut.CausesValidation = true See also ASP.NET validation working example. ValidationGroup New String. Name for the group of validation controls for which the button control causes validation when it posts back to the server. This property has an effect only when the value of the CausesValidation property is set to true and isSubmit property is set to true. Optional, default: empty string (""). oBut.ValidationGroup = "Validators_Group_1" See also ASP.NET validation working example. CommandName New String. Command name that is propagated to the Command event. This property has an effect only when isSubmit property is set to true. Optional, default: empty string (""). oBut.CommandName = "Sort" See also Command buttons working example. CommandArgument New String. Optional argument that is propagated to the Command event. This property has an effect only when isSubmit property is set to true. Optional, default: empty string (""). oBut.CommandArgument = "Descending" See also Command buttons working example. PostBackUrl New String. URL of the Web page to post to from the current page when the control is clicked. This property has an effect only when isSubmit property is set to true. Optional, default: empty string (""). oBut.PostBackUrl = "Target_Page.aspx" See also Cross-page posting working example. Width String. Width of the button. Optional By default button's width depends on its content. oBut.Width = "100%" Height String. Height of the button. Optional By default button's height depends on its content. oBut.Height = "30px" Text String. Text that appears inside the button. Optional oBut.Text = "Check" RightText Bool. Indicates text position relative to image when both text and image are used for the button. Optional, default: "true". oBut.RightText = false See also Text position inside button working example. Title String. Title of the button. Optional oBut.Title = "Save the content" GroupName String. Name of buttons group. Optional, by default a button doesn't belong to any group oBut.GroupName = "toolBar" SkinStyle String. The name of button's style ("normal", "pressEffected", "classic", "xp" etc.). Optional, default: "normal" oBut.SkinStyle = "smooth" SkinFolder String. Path to directory with skin CSS files. Optional, default: "osbSkins". If no default, should be set for the first SuperButton object oBut.SkinFolder = "." ImageNormal String. File name of image inside the button, when the button is enabled. Optional oBut.ImageNormal = "printer_n.gif" ImageHover String. File name of image inside the button, when the button is hovered. When not specified, ImageNormal is used. Optional oBut.ImageHover = "printer_h.gif" ImagePressed String. File name of image inside the button, when the button is pressed. When not specified, ImageNormal is used. Optional oBut.ImagePressed = "printer_p.gif" ImageActive String. File name of image inside the button, when the button is set as active. When not specified, ImageNormal is used. Optional oBut.ImageActive = "printer_a.gif" ImageDisabled String. File name of image inside the button, when the button is disabled. When not specified, ImageNormal is used. Optional oBut.ImageDisabled = "printer_d.gif" ImageFolder String. Path to directory with images. Optional, default: "osbImages". If no default, should be set for the first SuperButton object oBut.ImageFolder = "./images" mouseClick String. JavaScript code executing on button click. Optional oBut.mouseClick = "alert('button is clicked');" onActive String. JavaScript code executing when the button is set as active. Optional oBut.onActive = "but_01.disable();" onUnActive String. JavaScript code executing when the button is unset as active. Optional oBut.onUnActive = "but_01.enable();" isSubmit Bool. Indicates that the button click forces submit of corresponding Form. Optional, default: "false". oBut.isSubmit = true Validate String. JavaScript code executing before Form submitting after this button was clicked (when isSubmit = true). The Form will be submitted if this code returns true only. Optional oBut.Validate = "return myValidate();" See also .NET Validation working example. Disabled Bool. Indicates that the button is initialy disabled. Optional, default: "false". oBut.Disabled = true Activated Bool. Indicates that the button is initialy activated. Optional, default: "false". oBut.Activated = true ScriptFolder String. Path to directory with JavaScript file. Optional, by default - current directory. If no default, should be set for the first SuperButton object oBut.ScriptFolder = "." PathPrefix String. Path prefix for ImageFolder , SkinFolder and ScriptFolder directories. Default empty. Optional oBut.PathPrefix = "../"

If Text property is specified and ImageNormal- not, the button will be text type. If ImageNormal property is specified and Text- not, the button will be image type. Both Text and ImageNormal properties can be specified for a button, in this case the button will be mixed type (contain both image and text).

Events

Click System.EventHandler delegate. This event is raised when SuperButton is clicked. isSubmit property should be set to true. C# code sample. using System; ... oBut.Click +=new EventHandler(oBut_OnClick); ... private void oBut_OnClick(object sender, EventArgs e) {    ... } See also working example. Command New System.Web.UI.WebControls.CommandEventHandler delegate. This event is raised when SuperButton is clicked. isSubmit property should be set to true. C# code sample. using System.Web.UI.WebControls; ... oBut.Command +=new CommandEventHandler(oBut_OnCommand); ... private void oBut_OnCommand(object sender, CommandEventArgs e) {    string command = e.CommandName;    string argument = (String)e.CommandArgument;    ... } See also working example.

Sample ASP.NET <osb:SuperButton Id="but1" runat="server" Text="button 1" SkinStyle="classic" mouseClick="alert('button1 clicked')" />

Please visit HOW-TO and Help page for any questions.

"I like the controls you guys have...nice stuff." Paul Millefolie