Skip to main content

ASPxClientFileManager.ToolbarUpdating Event

Fires on the client side when the file manager updates the state of toolbar or context menu items.

Declaration

ToolbarUpdating: ASPxClientEvent<ASPxClientFileManagerToolbarUpdatingEventHandler<ASPxClientFileManager>>

Event Data

The ToolbarUpdating event's data class is ASPxClientFileManagerToolbarUpdatingEventArgs. The following properties provide information specific to this event:

Property Description
activeAreaName Gets the name of the currently active file manager area.

Remarks

Write the ToolbarUpdating event handler to control the state of custom toolbar and context menu items. You can use the ASPxClientFileManagerToolbarUpdatingEventArgs.activeAreaName event argument property to determine the currently active area.

A particular item can be accessed by its command name using the ASPxClientFileManager.GetToolbarItemByCommandName and ASPxClientFileManager.GetContextMenuItemByCommandName methods, which return a ASPxClientFileManagerToolbarItem object. You can use the object members to control the item availability.

Example

The complete example is available in the following DevExpress online demo: File Manager - Custom Toolbar.

<dx:ASPxFileManager ID="FileManager" ClientInstanceName="FileManager" runat="server">
     <ClientSideEvents ToolbarUpdating="OnToolbarUpdating" />
     <SettingsToolbar>
          <Items>
               <dx:FileManagerToolbarCustomButton CommandName="Properties">
                    <Image IconID="setup_properties_16x16" />
               </dx:FileManagerToolbarCustomButton>
...
function OnToolbarUpdating(s, e) {
     var enabled = (e.activeAreaName == "Folders" || FileManager.GetSelectedItems().length > 0) && e.activeAreaName != "None";
     FileManager.GetToolbarItemByCommandName("Properties").SetEnabled(enabled);
}
See Also