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

VGridControlBase.ShowCustomizationForm Event

Fires after the Customization Form has been invoked.

Namespace: DevExpress.XtraVerticalGrid

Assembly: DevExpress.XtraVerticalGrid.v18.2.dll

Declaration

public event EventHandler ShowCustomizationForm

Event Data

The ShowCustomizationForm event's data class is EventArgs.

Remarks

Handle the ShowCustomizationForm event to provide an appropriate response to the Customization Form’s activation. This event can also be used to initialize the Customization Form. This may be required when you need to assign a context menu to the form or change other settings. The form can be accessed via the VGridControlBase.CustomizationForm property.

For more information, see Customization Form.

Examples

The following sample code creates and assigns a context menu to the Customization Form each time it is shown. The assigned menu contains a single item used to clear the Customization Form’s content. The context menu is disposed of to release all the resources used.

The image below shows the result.

CustomizationForm - property

using DevExpress.XtraVerticalGrid.Rows;
//...

private void vGridControl1_MouseUp(object sender, System.Windows.Forms.MouseEventArgs e) {
   if (e.Button == MouseButtons.Right) vGridControl1.CreateCustomization();
}

ContextMenu menu = null;
private void vGridControl1_ShowCustomizationForm(object sender, System.EventArgs e) {
   menu = new ContextMenu(new MenuItem[] {new MenuItem("Clear")});
   menu.MenuItems[0].Click += new EventHandler(menuItem1_Click);
   vGridControl1.CustomizationForm.ContextMenu = menu;
}

private void vGridControl1_HideCustomizationForm(object sender, System.EventArgs e) {
   if (menu == null) return;
   menu.MenuItems[0].Click -= new EventHandler(menuItem1_Click);
   menu.Dispose();
   menu = null;
}

private void menuItem1_Click(object sender, System.EventArgs e) {
   RowOperationVisible RowOperatVisible = new RowOperationVisible();
   vGridControl1.RowsIterator.DoOperation(RowOperatVisible);
}


public class RowOperationVisible : RowOperation {
   public RowOperationVisible() {}
   public override void Execute(BaseRow row) {
      if (row.Visible == false && row.OptionsRow.AllowMoveToCustomizationForm) 
          row.Visible = true;
   }
}
See Also