Click or drag to resize
KaxToolBarOnClientCheckedStateChanged Property
Gets or sets a value indicating the client-side event handler that is called after a KaxToolBarButton is checked.

Namespace: Kettic.AspNet.Controls
Assembly: Kettic.AspNet.Controls (in Kettic.AspNet.Controls.dll) Version: 2014.4.1129.0 (2014.04.1129.0)
Syntax
public string OnClientCheckedStateChanged { get; set; }

Property Value

Type: String
A string specifying the name of the JavaScript function that will handle the event. The default value is empty string.
Remarks

Use the OnClientCheckedStateChanged property to specify a JavaScript function that will be executed after a toolbar dropdown button is checked - either by left-clicking a checkable button or pressing the ENTER key after tabbing to that button.

Two parameters are passed to the handler

  • sender (the client-side KaxToolBar object)
  • eventArgs with two properties
    • item - the instance of the button which is checked
    • domEvent - the reference to the browser DOM event (null if the event was initiated by calling a client-side method such as button.toggle())

Examples
The following example demonstrates how to use the OnClientCheckedStateChanged property.

<script language="javascript">
function clientCheckedStateChanged(sender, eventArgs)
{
var toolBar = sender;
var button = eventArgs.get_item();

alert(String.format("You just changed the checked state of the '{0}' button in the '{1}' toolBar.", button.get_text(), toolBar.get_id()));

}
</script>

<kettic:KaxToolBar id="KaxToolBar1" runat="server" OnClientCheckedStateChanged="clientCheckedStateChanged">
<Items>
<kettic:KaxToolBarButton Text="Left" CheckOnClick="true" Group="Align" ></kettic:KaxToolBarButton>
<kettic:KaxToolBarButton Text="Center" CheckOnClick="true" Group="Align" ></kettic:KaxToolBarButton>
<kettic:KaxToolBarButton Text="Right" CheckOnClick="true" Group="Align" ></kettic:KaxToolBarButton>
<kettic:KaxToolBarDropDown Text="Align">
<Buttons>
<kettic:KaxToolBarButton Text="Left" CheckOnClick="true" Group="Align" ></kettic:KaxToolBarButton>
<kettic:KaxToolBarButton Text="Center" CheckOnClick="true" Group="Align" ></kettic:KaxToolBarButton>
<kettic:KaxToolBarButton Text="Right" CheckOnClick="true" Group="Align" ></kettic:KaxToolBarButton>
</Buttons>
</kettic:KaxToolBarDropDown>
<kettic:KaxToolBarSplitButton Text="Reset">
<Buttons>
<kettic:KaxToolBarButton Text="Left" CheckOnClick="true" Group="Align" ></kettic:KaxToolBarButton>
<kettic:KaxToolBarButton Text="Center" CheckOnClick="true" Group="Align" ></kettic:KaxToolBarButton>
<kettic:KaxToolBarButton Text="Right" CheckOnClick="true" Group="Align" ></kettic:KaxToolBarButton>
</Buttons>
</kettic:KaxToolBarSplitButton>
</Items>
</kettic:KaxToolBar>

See Also