OnBeforeDisplayContextMenu Method

Obsolete. Raises the BeforeDisplayContextMenu event before the System.Windows.Forms.ContextMenu has been displayed.

Syntax

Visual Basic

'Declaration
 
Protected Overridable Sub OnBeforeDisplayContextMenu( _
   ByVal e As CancelableUIElementEventArgs _
) 

C#

protected virtual void OnBeforeDisplayContextMenu( 
   CancelableUIElementEventArgs e
)

Parameters

e

A CancelableUIElementEventArgs that provides data for the event.

Remarks

The context menu related events relied upon overriding the WndProc of the control. However, overriding this method adds a restriction that the control can only be used when unmanaged code permissions have been provided. Since this must be overriden at the time of compiling, the ContextMenu related events have been marked as obsolete and will be removed in a future version of the product. The events will no longer be invoked in the current version.

Raising an event invokes the event handler through a delegate.

The OnBeforeDisplayContextMenu method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors: When overriding OnBeforeDisplayContextMenu in a derived class, be sure to call the base class's OnBeforeDisplayContextMenu method so that registered delegates receive the event.

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