BootstrapToolbar.Items Property

Provides access to a collection of toolbar items.

Namespace: DevExpress.Web.Bootstrap

Assembly: DevExpress.Web.Bootstrap.v19.1.dll

Declaration

C#

[PersistenceMode(PersistenceMode.InnerProperty)]
public BootstrapToolbarItemCollection Items { get; }

VB.NET

<PersistenceMode(PersistenceMode.InnerProperty)>
Public ReadOnly Property Items As BootstrapToolbarItemCollection

Property Value

Type	Description
BootstrapToolbarItemCollection	A BootstrapToolbarItemCollection object representing the collection of the toolbar’s items.

Remarks

The Items property provides access to a collection that contains all the items of the current toolbar. This collection provides the standard means to manipulate (add or remove) items within a toolbar.

Example

This example demonstrates the basic functionality of the Toolbar control.

1. Initialize a new instance of the BootstrapToolbar class.
2. Add required toolbar items (BootstrapToolbarItem objects) to the BootstrapToolbar.Items collection.

3. Additional members:

   • BootstrapToolbar.ItemClick occurs when an end-user clicks a toolbar button.
   • MenuItem.Name specifies a button’s name, which identifies the item in the toolbar’s Items collection.
   • MenuItem.Text specifies a button’s display text.
   • MenuItem.BeginGroup – if set to true, the button becomes the first button in a new button group.
   • BootstrapToolbarItemBase.IconCssClass specifies the CSS class of an icon displayed by a toolbar item.
   • MenuItem.NavigateUrl specifies a button’s navigation location. When this property is specified, the button is rendered as a hyperlink.

The image below shows the result:

JS

function onDefaultToolbarItemClick(s, e) {
    dxbsDemo.showToast("The button '" + e.item.name + "' has been clicked.");
}

ASPX

<dx:BootstrapToolbar runat="server">
    <Items>
        <dx:BootstrapToolbarItem Name="Copy" IconCssClass="fa fa-copy" />
        <dx:BootstrapToolbarItem Name="Paste" IconCssClass="fa fa-paste" />
        <dx:BootstrapToolbarItem Name="Item1" Text="Item" />
        <dx:BootstrapToolbarItem Name="Link" Text="Link" NavigateUrl="#DefaultToolbar" />
        <dx:BootstrapToolbarItem Name="Left" BeginGroup="true" IconCssClass="fa fa-align-left" />
        <dx:BootstrapToolbarItem Name="Center" IconCssClass="fa fa-align-center" />
        <dx:BootstrapToolbarItem Name="Right" IconCssClass="fa fa-align-right" />
    </Items>
    <ClientSideEvents ItemClick="onDefaultToolbarItemClick" />
</dx:BootstrapToolbar>