This Class specifies the rendering of RadToolBarSplitButton.
Definition
Namespace:Telerik.Web.UI
Assembly:Telerik.Web.UI.dll
Syntax:
public class RadToolBarSplitButton : RadToolBarItem, IComponent, IDisposable, IParserAccessor, IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor, IExpressionsAccessor, IAttributeAccessor, IMarkableStateManager, IStateManager, INamingContainer, IXmlSerializable, IRadToolBarButtonContainer, IRadToolBarItemContainer, IControlItemContainer, IRadToolBarButtonInheritance: objectControlWebControlControlItemRadToolBarItemRadToolBarSplitButton...
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadToolBarSplitButton class.
public RadToolBarSplitButton()Use this constructor to create and initialize a new instance of the RadToolBarSplitButton class using default values.
Initializes a new instance of the RadToolBarSplitButton class with the specified text data.
public RadToolBarSplitButton(string text)The text of the split button. The Text property is set to the value of this parameter.
Use this constructor to create and initialize a new instance of the RadToolBarSplitButton class using the specified text.
Properties
Gets a RadToolBarButtonCollection object that contains the child buttons of the split button.
[PersistenceMode(PersistenceMode.InnerProperty)]
[Browsable(false)]
public RadToolBarButtonCollection Buttons { get; }A RadToolBarButtonCollection that contains the child buttons of the split button. By default the collection is empty (the split button has no buttons).
Implements:
Use the Buttons property to access the child buttons of the split button. You can also use the Buttons property to manage the children of the current tab. You can add, remove or modify buttons from the Buttons collection.
Gets or sets a value indicating whether validation is performed when the RadToolBarSplitButton is clicked
public bool CausesValidation { get; set; }true if validation is performed when the RadToolBarSplitButton is clicked otherwise, false. The default value is true.
Implements:
By default, page validation is performed when the button is clicked. Page validation determines whether the input controls associated with a validation control on the page all pass the validation rules specified by the validation control. You can specify or determine whether validation is performed when the button is clicked on both the client and the server by using the CausesValidation property. To prevent validation from being performed, set the CausesValidation property to false.
Gets or sets an optional parameter passed to the Command event of the RadToolBar instance along with the associated CommandName
public string CommandArgument { get; set; }An optional parameter passed to the Command event of the RadToolBar instance along with the associated CommandName. The default value is an empty string.
Implements:
Gets or sets the command name associated with the toolbar button that is passed to the ItemCommand event of the RadToolBar instance.
public string CommandName { get; set; }The command name of the toolbar button. The default value is an empty string.
Implements:
Gets or sets the index of the button which properties will be used by default when the EnableDefaultButton property set to true.
[Bindable(true)]
public int DefaultButtonIndex { get; set; }The index of the button which properties will be used by default when the EnableDefaultButton property set to true. The default value is 0
Use the DefaultButtonIndex property to specify the button which properties RadToolBarSplitButton will use when the RadToolBar is initially displayed.
Gets or sets the height of the dropdown in pixels.
[Bindable(true)]
public Unit DropDownHeight { get; set; }Implements:
Gets or sets the width of the dropdown in pixels.
[Bindable(true)]
public Unit DropDownWidth { get; set; }Implements:
Gets or sets a value, indicating if the RadToolBarSplitButton will use the DefaultButton behavior.
[Bindable(true)]
public bool EnableDefaultButton { get; set; }A value, indicating if the RadToolBarSplitButton wll use the DefaultButton behavior. The default value is true
Use the EnableDefaultButton property to set if RadToolBarSplitButton will use the DefaultButton behavior or not. When the DefaultButton behavior is used, the RadToolBarSplitButton properties are ignored and the properties of the last selected button are used instead. Use the EnableDefaultButton property in conjunction with the DefaultButtonIndex property to specify which of the RadToolBarSplitButton child buttons will be used when the RadToolBar is initially displayed.
Gets or sets the expand direction of the drop down.
public ToolBarDropDownExpandDirection ExpandDirection { get; set; }The expand direction of the drop down. The default value is ToolBarDropDownExpandDirection.Down.
Gets or sets the template for displaying the button.
[TemplateContainer(typeof(RadToolBarButton))]
[PersistenceMode(PersistenceMode.InnerProperty)]
[Browsable(false)]
[Bindable(false)]
public ITemplate ItemTemplate { get; set; }A ITemplate implemented object that contains the template for displaying the button. The default value is a null reference (Nothing in Visual Basic), which indicates that this property is not set.
Implements:
Gets or sets the URL to link to when the button is clicked.
[Bindable(true)]
public string NavigateUrl { get; set; }The URL to link to when the button is clicked. The default value is empty string.
Implements:
Use the NavigateUrl property to specify the URL to link to when the button is clicked. Use "~" (tilde) in front of an URL within the same ASP.NET application. When specifying external URL do not forget the protocol (e.g. "http://").
Gets or sets a value indicating whether clicking on the button will postback.
public bool PostBack { get; set; }True if the toolbar split button should postback; otherwise false. By default all the items will postback provided the user has subscribed to the ButtonClick event.
Implements:
If you subscribe to the ButtonClick all toolbar buttons will postback. To turn off that behavior you should set the PostBack property to false.
Gets or sets the URL of the page to post to from the current page when the RadToolBarSplitButton is clicked.
public string PostBackUrl { get; set; }The URL of the Web page to post to from the current page when the RadToolBarSplitButton is clicked. The default value is an empty string (""), which causes the page to post back to itself.
Implements:
Gets or sets the target window or frame to display the Web page content linked to when the toolbar button is clicked.
[TypeConverter(typeof(TargetConverter))]
public string Target { get; set; }The target window or frame to load the Web page linked to when the button is selected. Values must begin with a letter in the range of a through z (case insensitive), except for the following special values, which begin with an underscore:
The default value is empty string.
Implements:
Use the Target property to specify the frame or window that displays the Web page linked to when the toolbar button is clicked. The Web page is specified by setting the NavigateUrl property.
If this property is not set, the Web page specified by the NavigateUrl property is loaded in the current window.
Gets or sets the name of the validation group to which the RadToolBarSplitButton belongs.
public string ValidationGroup { get; set; }The name of the validation group to which this RadToolBarSplitButton belongs. The default is an empty string (""), which indicates that this property is not set.
Implements:
This property works only when CausesValidation is set to true.
Gets or sets the value associated with the toolbar split button.
public override string Value { get; set; }The value associated with the button. The default value is empty string.
Overrides:
Implements:
Use the Value property to specify or determine the value associated with the button.
Methods
protected override ControlItemCollection CreateChildItemCollection()Overrides:
protected override RadToolBarItem.RendererBase CreateRenderer()Overrides:
protected override void LoadChildViewState(object viewState)Overrides:
protected override void LoadFromDictionary(IDictionary<string, object> dictionary)Overrides:
protected override void SetChildrenDirty()Overrides:
protected override void SetItemContainer(ControlItemContainer itemContainer)Overrides:
protected override void TrackChildViewState()Overrides: