ContextMenu Property

Returns/sets the context menu to be displayed.

Syntax

Visual Basic

'Declaration
 
Public Property ContextMenu As ContextMenu

C#

public ContextMenu ContextMenu {get; set;}

Remarks

A built-in default context menu is automatically supplied based on ClickArea.

The built-in default menu can be modified. If modified, the modifications will be preserved so that subsequent firings of the UltraExplorerBar.ContextMenuInitializing event will pass in the modified context menu.

This property can be set to a developer supplied menu or null. In either case, the (modified) default context menu is not affected and will be supplied the next time the event fires.

If the event is not canceled (i.e., the Cancel parameter is not set to True), the ContextMenu specified is used to set the control’s ContextMenu property.

Example

The following code shows how to process the ContextMenuInitiailizing 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.IGControls
Imports Infragistics.Win.UltraWinExplorerBar


	Private Sub ultraExplorerBar1_ContextMenuInitializing(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinExplorerBar.CancelableContextMenuInitializingEventArgs) Handles ultraExplorerBar1.ContextMenuInitializing

		' Add a menuitem of our own to the context menu if the group header was clicked.
		If (e.ClickArea = ClickArea.GroupHeader) Then
			' Reset the group header context menu to remove any menuitems we may have added previously.
			Me.ultraExplorerBar1.ResetGroupHeaderContextMenu()

			Dim myMenuitem As IGMenuItem = New IGMenuItem("Manage Group", New EventHandler(AddressOf Me.OnMenuItemClicked))

			e.ContextMenu.MenuItems.Add(myMenuitem)
		End If

	End Sub

	Private Sub OnMenuItemClicked(ByVal sender As Object, ByVal e As EventArgs)

		' Do something to respond to the click of the menuitem we added.

	End Sub

C#

using System.Diagnostics;
using Infragistics.Win;
using Infragistics.Win.IGControls;
using Infragistics.Win.UltraWinExplorerBar;


		private void ultraExplorerBar1_ContextMenuInitializing(object sender, Infragistics.Win.UltraWinExplorerBar.CancelableContextMenuInitializingEventArgs e)
		{
			// Add a menuitem of our own to the context menu if the group header was clicked.
			if (e.ClickArea == ClickArea.GroupHeader)
			{
				// Reset the group header context menu to remove any menuitems we may have added previously.
				this.ultraExplorerBar1.ResetGroupHeaderContextMenu();

				IGMenuItem myMenuitem = new IGMenuItem("Manage Group", new EventHandler(this.OnMenuItemClicked));

				e.ContextMenu.MenuItems.Add(myMenuitem);
			}
		}

		internal void OnMenuItemClicked(object sender, EventArgs e)
		{
			// Do something to respond to the click of the menuitem we added.
		}

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