NavigationContextMenuInitializing イベント

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

シンタックス

Visual Basic

'宣言
 
Public Event NavigationContextMenuInitializing As NavigationContextMenuInitializingEventHandler

C#

public event NavigationContextMenuInitializingEventHandler NavigationContextMenuInitializing

イベント データ

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

プロパティ	解説
Cancel System.ComponentModel.CancelEventArgsから継承されます。
ClickArea	エンドユーザーによって右クリックされたナビゲーション ペインの領域を記述する NavigationPaneClickArea 定数を返します。
Group	コンテキストメニューが表示される UltraExplorerBarGroup を返します。
NavigationContextMenu	表示されるコンテキスト メニューを返すか、設定します。

解説

注: 'OutlookNavigationPane' の設定 (コントロールの Style プロパティの設定) に固有の要素がエンドユーザーによって右クリックされると、NavigationContextMenuInitializing イベントが発生します。CancelableContextMenuInitializingEventArgs クラスの ClickArea プロパティと同じように、ClickArea プロパティは右クリックされたナビゲーション ペインの領域を記述します。

UltraExplorerBarItem が右クリックされた時などクリックしたイベントがナビゲーション ペイン機能固有ではないときに'OutlookNavigationPane' スタイル設定の下で ContextMenuInitializing イベントが発生します。この場合、NavigationContextMenuInitializing イベントは発生しません。

使用例

Visual Basic

Imports System.Diagnostics
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinExplorerBar


	Dim WithEvents myMenuItem As Infragistics.Win.IGControls.IGMenuItem

	Private Sub UltraExplorerBar1_NavigationContextMenuInitializing(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinExplorerBar.CancelableNavigationContextMenuInitializingEventArgs) Handles UltraExplorerBar1.NavigationContextMenuInitializing

		' Reset the NavigationContextMenu so that any changes we made to it during prior firings of the
		' NavigationContextMenuInitializing event will be undone and the 'stock' version of it will be displayed.
		Dim resetContextMenu As ContextMenu = e.ResetMenu()


		' Add a custom menuitem to the NavigationContextMenu.  Create an Infragistics.Win.IGControls.IGMenuItem instead
		' of a Standard Windows Forms MenuItem so that the menuitem is drawn in the correct visual style (Office2003, 
		' Office2000 etc.)
		Me.myMenuItem = New Infragistics.Win.IGControls.IGMenuItem("My MenuItem")
		resetContextMenu.MenuItems.Add(myMenuItem)


		' Disable the 'Open In New Window' stock menu item.  The ContextMenuItemType enumeration will allow us to
		' identify this by comparing the menuitem type of each menuitem against the OpenInNewWindow value if the
		' ContextMenuItemType enumeration.
		Dim menuItem As MenuItem

		For Each menuItem In resetContextMenu.MenuItems
			If e.GetMenuItemType(menuItem) = Infragistics.Win.UltraWinExplorerBar.ContextMenuItemType.OpenInNewWindow Then
				menuItem.Enabled = False
				Exit For
			End If
		Next


		' To ensure that context menu we just reset and modified is the one that gets displayed, assign it to the
		' NavigationContextMenu property of the event args.
		e.NavigationContextMenu = resetContextMenu

	End Sub

	Private Sub MyCustomMenuItemClick(ByVal sender As Object, ByVal e As EventArgs) Handles myMenuItem.Click

		' Perform custom menuitem click processing here.

	End Sub

C#

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


		private void ultraExplorerBar1_NavigationContextMenuInitializing(object sender, Infragistics.Win.UltraWinExplorerBar.CancelableNavigationContextMenuInitializingEventArgs e)
		{
			// Reset the NavigationContextMenu so that any changes we made to it during prior firings of the
			// NavigationContextMenuInitializing event will be undone and the 'stock' version of it will be displayed.
			ContextMenu resetContextMenu = e.ResetMenu();


			// Add a custom menuitem to the NavigationContextMenu.  Create an Infragistics.Win.IGControls.IGMenuItem instead
			// of a Standard Windows Forms MenuItem so that the menuitem is drawn in the correct visual style (Office2003, 
			// Office2000 etc.)
			Infragistics.Win.IGControls.IGMenuItem myMenuItem = new Infragistics.Win.IGControls.IGMenuItem("My MenuItem");

			myMenuItem.Click += new EventHandler(this.MyCustomMenuItemClick);
			resetContextMenu.MenuItems.Add(myMenuItem);


			// Disable the 'Open In New Window' stock menu item.  The ContextMenuItemType enumeration will allow us to
			// identify this by comparing the menuitem type of each menuitem against the OpenInNewWindow value if the
			// ContextMenuItemType enumeration.
			foreach(MenuItem menuitem in resetContextMenu.MenuItems)
			{
				if (e.GetMenuItemType(menuitem) == Infragistics.Win.UltraWinExplorerBar.ContextMenuItemType.OpenInNewWindow)
				{
					menuitem.Enabled = false;
					break;
				}
			}


			// To ensure that context menu we just reset and modified is the one that gets displayed, assign it to the
			// NavigationContextMenu property of the event args.
			e.NavigationContextMenu = resetContextMenu;
		}

		private void MyCustomMenuItemClick(object sender, EventArgs e)
		{
			// Perform custom menuitem click processing here.
		}