A newer version of this page is available. Switch to the current version.

TreeList.ShowTreeListMenu Event

Obsolete. Allows you to customize the default menus for column headers, summary footers and nodes.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v19.2.dll

Declaration

[Browsable(false)]
[Obsolete("You should use the 'PopupMenuShowing' instead", false)]
public event TreeListMenuEventHandler ShowTreeListMenu

Event Data

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

Property Description
Allow Gets or sets if display of the menu is allowed. Inherited from PopupMenuShowingEventArgs.
Menu Gets or sets the control's popup menu that will be shown. Inherited from PopupMenuShowingEventArgs.
Point Gets the position where the menu is to be invoked. Inherited from PopupMenuShowingEventArgs.

Remarks

Use the TreeList.PopupMenuShowing event instead.

Examples

The following sample code handles the TreeList.PopupMenuShowing event for the following two purposes.

  • Disables the summary footer context menu for the "Department" column.
  • Removes the "Runtime columns customization" item of the column header context menu.
using DevExpress.XtraTreeList;

private void treeList1_PopupMenuShowing(object sender, PopupMenuShowingEventArgs e) {
    TreeList treeList = sender as TreeList;
    TreeListHitInfo hitInfo = treeList.CalcHitInfo(e.Point);

    // prohibiting summary footer menu for the "Department" column
    if (hitInfo.HitInfoType == HitInfoType.SummaryFooter &&
      hitInfo.Column.Caption == "Department")
        e.Allow = false;

    // removing the "Runtime columns customization" item of the column header menu
    if (hitInfo.HitInfoType == HitInfoType.Column) {
        string caption = TreeListLocalizer.Active.GetLocalizedString(GetMenuColumnCustomizationStringId(treeList));
        e.Menu.Items.Remove(e.Menu.Items.FirstOrDefault(x => x.Caption == caption));
    }
}

private TreeListStringId GetMenuColumnCustomizationStringId(TreeList treeList) {
    if (treeList.OptionsView.ShowBandsMode == DefaultBoolean.True || (treeList.OptionsView.ShowBandsMode == DefaultBoolean.Default && treeList.Bands.Count > 0))
        return TreeListStringId.MenuColumnBandCustomization;
    return TreeListStringId.MenuColumnColumnCustomization;
}
See Also