WinExplorerView.ContextButtonClick Event

Occurs when a context button in this WinExplorerView is clicked.

Namespace: DevExpress.XtraGrid.Views.WinExplorer

Assembly: DevExpress.XtraGrid.v20.1.dll

Declaration

[DXCategory("Context Buttons")]
public event ContextItemClickEventHandler ContextButtonClick
<DXCategory("Context Buttons")>
Public Event ContextButtonClick As ContextItemClickEventHandler

Event Data

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

Property Description
DataItem Gets or sets an Object that contains a clicked ContextItem. This object is a control or a control's item.
Item Gets a clicked ContextItem.
ItemInfo Gets or sets a clicked ContextItem's ContextItemViewInfo.
ScreenBounds Returns a Rectangle that contains a ContextItem.

Remarks

Handling the ContextButtonClick event allows you to respond to an end-user clicking a context button stored within the WinExplorerView.ContextButtons collection. See the Context Buttons section of the WinExplorer View to learn more.

Examples

If the ShowCheckBoxes option is enabled, the view displays check boxes in each record (row). The CheckBoxColumn property specifies the data field (column) that contains values for the check boxes. The code below shows how to use context check buttons instead of check boxes in the view.

using DevExpress.Utils;
using DevExpress.XtraGrid.Views.WinExplorer;
using DevExpress.XtraGrid.Views.Base;

winExplorerView1.OptionsView.ShowCheckBoxes = false;

private void winExplorerView1_ContextButtonClick(object sender, ContextItemClickEventArgs e) {
    WinExplorerView view = sender as WinExplorerView;
    if (e.Item.Name == "itemCheck") {
        view.SetRowCellValue((int)e.DataItem, view.ColumnSet.CheckBoxColumn, ((CheckContextButton)e.Item).Checked);
    }
}

private void winExplorerView1_ContextButtonCustomize(object sender, WinExplorerViewContextButtonCustomizeEventArgs e) {
    WinExplorerView view = sender as WinExplorerView;
    if (e.Item.Name == "itemCheck") {
        ((CheckContextButton)(e.Item)).Checked = Convert.ToBoolean(view.GetRowCellValue(e.RowHandle, view.ColumnSet.CheckBoxColumn));
    }
}

private void winExplorerView1_CellValueChanged(object sender, CellValueChangedEventArgs e) {
    WinExplorerView view = sender as WinExplorerView;
    if (e.Column == view.ColumnSet.CheckBoxColumn) {
        view.RefreshContextButtons();
    }
}
See Also