ContextMenuInitializing イベント

コンテキストメニューが表示される前に発生します。

シンタックス

Visual Basic

'宣言
 
Public Event ContextMenuInitializing As ContextMenuInitializingEventHandler

C#

public event ContextMenuInitializingEventHandler ContextMenuInitializing

イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、CancelableContextMenuInitializingEventArgs 型の引数を受け取りました。次の CancelableContextMenuInitializingEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ	解説
Cancel System.ComponentModel.CancelEventArgsから継承されます。
ClickArea	右クリックされたコントロールの領域を表す列挙体を返します。
ContextMenu	表示されるコンテキスト メニューを返すか、設定します。
Group	表示されるコンテキスト メニューに関連した UltraExplorerBarGroup を返します。コンテキスト メニューがグループに関連していない場合は null を返します。
Item	表示されるコンテキストメニューに関連した UltraExplorerBarItem を返します。コンテキストメニューが項目に関連していない場合はnullを返します。

解説

このイベントは、UltraExplorerBar によって表示されるコンテキスト メニューを抑制または修正するために使用できます。

注: コントロールの Style プロパティが 'OutlookNavigationPane' に設定される時、ContextMenuInitializing イベントは、右クリックされたすべての要素に対して発生するわけではありません。このような環境では、代わりに NavigationContextMenuInitializing イベントが発生します。

使用例

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.
		}