BeforeDisplayCustomizeDialog Event

Occurs before the run-time customizer dialog is displayed to the user.

Syntax

Visual Basic

'Declaration
 
Public Event BeforeDisplayCustomizeDialog As BeforeDisplayCustomizeDialogEventHandler

C#

public event BeforeDisplayCustomizeDialogEventHandler BeforeDisplayCustomizeDialog

Event Data

The event handler receives an argument of type BeforeDisplayCustomizeDialogEventArgs containing data related to this event. The following BeforeDisplayCustomizeDialogEventArgs properties provide information specific to this event.

Property	Description
Cancel (Inherited from System.ComponentModel.CancelEventArgs)
CustomizerForm	The default runtime customizer form.
ExcludedShortcuts	The list of shortcuts to excluded from the Customize Keyboard dialog.

Remarks

This event is generated before the user is shown the run-time customizer.

The AfterCustomizeDialogClosed event is generated after the user closes the run-time customizer.

Example

The following code demonstrates how to cancel the BeforeDisplayCustomizeDialog event.

For an overview of how to handle events in Visual Basic or Visual C#, see Event Handlers in Visual Basic and Visual C#. For specific information and code examples illustrating how to consume events in your application, see Consuming Events in the .NET Framework Developer's Guide.

Visual Basic

Imports System.Diagnostics
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinToolbars

	Private Sub UltraToolbarsManager1_BeforeDisplayCustomizeDialog(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinToolbars.BeforeDisplayCustomizeDialogEventArgs) Handles UltraToolbarsManager1.BeforeDisplayCustomizeDialog

		Dim dr As DialogResult = MessageBox.Show(Me, "The Customize Dialog is about to be displayed. Do you want to cancel the display?", "Cancelable Toolbar Event", MessageBoxButtons.YesNo)

		If dr = DialogResult.Yes Then
			e.Cancel = True
		End If

	End Sub

C#

using System.Diagnostics;
using Infragistics.Win;
using Infragistics.Win.UltraWinToolbars;

		private void ultraToolbarsManager1_BeforeDisplayCustomizeDialog(object sender, Infragistics.Win.UltraWinToolbars.BeforeDisplayCustomizeDialogEventArgs e)
		{

			DialogResult dr =  MessageBox.Show(this, "The Customize Dialog is about to be displayed. Do you want to cancel the display?", "Cancelable Toolbar Event", MessageBoxButtons.YesNo);

			if (dr == DialogResult.Yes)
				e.Cancel = true;

		}

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2