Back to Devexpress

GridCommandContext Class

blazor-devexpress-dot-blazor-9187eb8d.md

latest7.1 KB
Original Source

GridCommandContext Class

Contains contextual information for a Grid context menu.

Namespace : DevExpress.Blazor

Assembly : DevExpress.Blazor.v25.2.dll

NuGet Package : DevExpress.Blazor

Declaration

csharp
public class GridCommandContext :
    GridCommandContextBase,
    IGridCommandContext,
    ICommandContextBase

Remarks

The DevExpress Blazor Grid allows you to display context menus with predefined and custom commands. Use the ContextMenus property to activate context menus for specific Grid elements.

Run Demo: Context Menu

Handle the CustomizeContextMenu event to modify the menu item collection. Use the Context event argument to identify the target Grid element and obtain contextual information.

Target ElementContext TypeContextual information
AnyGridCommandContextGrid
Data RowGridDataRowCommandContextGrid, Column, DataItem, RowVisibleIndex
FooterGridFooterCommandContextGrid, Column, SummaryItems
Group FooterGridGroupFooterCommandContextGrid, Column, GroupRowVisibleIndex, SummaryItems
Group PanelGridGroupPanelCommandContextGrid
Group RowGridGroupRowCommandContextGrid, GroupColumn, RowVisibleIndex
HeaderGridHeaderCommandContextGrid, Column

Example

The following example adds custom Show Footer / Hide Footer commands to all context menus:

razor
@inject WeatherForecastService ForecastService

<DxGrid Data="@Data" ContextMenus="GridContextMenus.All" CustomizeContextMenu="OnCustomizeContextMenu">
    <Columns>
        <DxGridDataColumn FieldName="Date" DisplayFormat="D" />
        <DxGridDataColumn FieldName="TemperatureC" Caption="@("Temp. (\x2103)")" Width="120px" />
        <DxGridDataColumn FieldName="TemperatureF" Caption="@("Temp. (\x2109)")" Width="120px" />
        <DxGridDataColumn FieldName="Forecast" />
        <DxGridDataColumn FieldName="CloudCover" />
    </Columns>
    <TotalSummary>
        <DxGridSummaryItem SummaryType="GridSummaryItemType.Count" FieldName="Date" />
    </TotalSummary>
</DxGrid>

@code {
    object Data { get; set; }

    protected override void OnInitialized() {
        Data = ForecastService.GetForecast();
    }

    void OnCustomizeContextMenu(GridCustomizeContextMenuEventArgs args) {
        var isFooterVisible = args.Context.Grid.FooterDisplayMode != GridFooterDisplayMode.Never;
        string footerItemText = isFooterVisible ? "Hide Footer" : "Show Footer";
        var newState = isFooterVisible ? GridFooterDisplayMode.Never : GridFooterDisplayMode.Always;
        args.Items.AddCustomItem(0, footerItemText, () => {
            args.Context.Grid.BeginUpdate();
            args.Context.Grid.FooterDisplayMode = newState;
            args.Context.Grid.EndUpdate();
        });
    }
}
csharp
using System;

public class WeatherForecast {
    public DateTime Date { get; set; }
    public int TemperatureC { get; set; }
    public double TemperatureF => Math.Round((TemperatureC * 1.8 + 32), 2);
    public string Forecast { get; set; }
    public string CloudCover { get; set; }
    public bool Precipitation { get; set; }
}
csharp
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;

public class WeatherForecastService {
    private List<WeatherForecast> Forecast { get; set; }

    private static string[] CloudCover = new[] {
        "Sunny", "Partly cloudy", "Cloudy", "Storm"
    };

    Tuple<int, string>[] ConditionsForForecast = new Tuple<int, string>[] {
        Tuple.Create( 22 , "Hot"),
        Tuple.Create( 13 , "Warm"),
        Tuple.Create( 0 , "Cold"),
        Tuple.Create( -10 , "Freezing")
    };

    public WeatherForecastService() {
        Forecast = CreateForecast();
    }

    private List<WeatherForecast> CreateForecast() {
        var rng = new Random();
        DateTime startDate = DateTime.Now;
        return Enumerable.Range(1, 15).Select(index => {
            var temperatureC = rng.Next(-10, 30);
            return new WeatherForecast {
                Date = startDate.AddDays(index),               
                TemperatureC = temperatureC,
                CloudCover = CloudCover[rng.Next(0, 4)],
                Precipitation = Convert.ToBoolean(rng.Next(0, 2)),
                Forecast = ConditionsForForecast.First(c => c.Item1 <= temperatureC).Item2
            };
        }).ToList();
    }

    public IEnumerable<WeatherForecast> GetForecast() {
        return Forecast.ToArray();
    }
    // ...
}
csharp
// ...
builder.Services.AddSingleton<WeatherForecastService>();

Implements

IGridCommandContext

ICommandContextBase

Inheritance

Object DevExpress.Blazor.Grid.Internal.Base.ContextMenu.GridCommandContextBase GridCommandContext

See Also

GridCommandContext Members

DevExpress.Blazor Namespace