バージョン

MenuDisplayStyle プロパティ

ツールが PopupMenuTool または ApplicationMenuArea 上にある場合、その画像を StateButtonTool にどのように描画されるかを決定するスタイルを取得するまたは設定します。
シンタックス
'宣言
 
Public Property MenuDisplayStyle As StateButtonMenuDisplayStyle
public StateButtonMenuDisplayStyle MenuDisplayStyle {get; set;}

プロパティ値

ツールが PopupMenuTool または ApplicationMenuArea 上にある場合、その画像を StateButtonTool にどのように描画されるかを決定するスタイル。
例外
例外解説
System.NotSupportedExceptionプロパティは、基本の Form または UserControl で定義された UltraToolbarsManager 内のツールに対して、デザインタイムに修正されます。継承されたツールは、作成された Form または UserControl のデザイナーを通して、ランタイムまたはデザインタイムに修正される必要があります。
System.ComponentModel.InvalidEnumArgumentException指定した値が StateButtonMenuDisplayStyle 列挙体に定義されていません。
解説

StateButtonTool は、ツールがチェックされている (押されている) かどうかによって異なる外観を持ちます。ツールがツールバーに配置される場合、その画像はツールの状態を反映するために変更されます。ただし、メニューに配置されると、ツールの画像は表示される場合とされない場合があります。

このプロパティを使用して、メニューにある時にコントロールのチェックされた状態がどのように示されるかを指定します。DisplayToolImage の選択は、ツールの画像をメニューに表示させます。画像はツールバーと同様、チェックされた状態を示すために変更されます。DisplayCheckmark 値は、チェックされた状態を示すためにその横のチェックマークでツールを表示します。 (未チェック状態は、チェックマークが表示される空白領域を示します) このオプションが選択されている場合、ツールの画像がある場合には表示されません。

使用例
Imports System.Diagnostics
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinToolbars

	Private Sub Button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button2.Click

		' ----------------------------------------------------------------------------
		' 新しい StateButton ツールを作成します
		Dim stateButtonAlignLeft As New StateButtonTool("AlignLeft")
		Dim stateButtonAlignCenter As New StateButtonTool("AlignCenter")
		Dim stateButtonAlignRight As New StateButtonTool("AlignRight")


		' メニューまたはツールバーに追加する前に、常に新しいツールを
		' UltraToolbarManager のルート ツール コレクションに追加します
		Me.UltraToolbarsManager1.Tools.AddRange(New ToolBase() {stateButtonAlignLeft, stateButtonAlignCenter, stateButtonAlignRight})


		' ボタンの画像を指定します
		stateButtonAlignLeft.SharedProps.AppearancesSmall.Appearance.Image = Bitmap.FromHicon(SystemIcons.Information.Handle)
		stateButtonAlignCenter.SharedProps.AppearancesSmall.Appearance.Image = Bitmap.FromHicon(SystemIcons.Exclamation.Handle)
		stateButtonAlignRight.SharedProps.AppearancesSmall.Appearance.Image = Bitmap.FromHicon(SystemIcons.WinLogo.Handle)


		' ボタンで画像を表示するために、メニューの表示スタイルを設定します
		stateButtonAlignLeft.MenuDisplayStyle = StateButtonMenuDisplayStyle.DisplayToolImage
		stateButtonAlignCenter.MenuDisplayStyle = StateButtonMenuDisplayStyle.DisplayToolImage
		stateButtonAlignRight.MenuDisplayStyle = StateButtonMenuDisplayStyle.DisplayToolImage


		' ----------------------------------------------------------------------------
		' 3 つの状態ボタンの状態 (チェックまたはチェック解除) を
		' 構成する OptionSet オブジェクトを作成します  
		Dim index As Integer = Me.UltraToolbarsManager1.OptionSets.Add(False, "MyAlignOptionSet")


		' オプション セットに 3 つの状態ボタンを追加します
		Me.UltraToolbarsManager1.OptionSets(index).Tools.AddToolRange(New String() {"AlignLeft", "AlignCenter", "AlignRight"})


		' ----------------------------------------------------------------------------
		' 'AlignLeft' ボタンをチェックします
		stateButtonAlignLeft.Checked = True


		' ----------------------------------------------------------------------------
		' ツールバーを作成し、状態ボタンをツールバーに追加します
		Me.UltraToolbarsManager1.Toolbars.AddToolbar("MyAlignmentToolbar")

		' ツールバーをフォームの下にドッキングします
		Me.UltraToolbarsManager1.Toolbars("MyAlignmentToolbar").DockedPosition = DockedPosition.Bottom

		' ツールバーに状態ボタンを追加します
		Me.UltraToolbarsManager1.Toolbars("MyAlignmentToolbar").Tools.AddToolRange(New String() {"AlignLeft", "AlignCenter", "AlignRight"})


		' 最初のボタンの前にセパレーターを配置するには、最初のボタンの IsFirstInGroup プロパティを設定します
		Me.UltraToolbarsManager1.Toolbars("MyAlignmentToolbar").Tools("AlignLeft").InstanceProps.IsFirstInGroup = True

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

		private void button2_Click(object sender, System.EventArgs e)
		{

			// ----------------------------------------------------------------------------
			// 新しい StateButton ツールを作成します
			StateButtonTool stateButtonAlignLeft	= new StateButtonTool("AlignLeft");
			StateButtonTool stateButtonAlignCenter	= new StateButtonTool("AlignCenter");
			StateButtonTool stateButtonAlignRight	= new StateButtonTool("AlignRight");


			// メニューまたはツールバーに追加する前に、常に新しいツールを
			// UltraToolbarManager のルート ツール コレクションに追加します
			this.ultraToolbarsManager1.Tools.AddRange(new ToolBase [] {stateButtonAlignLeft, stateButtonAlignCenter, stateButtonAlignRight} );


			// ボタンの画像を指定します
			stateButtonAlignLeft.SharedProps.AppearancesSmall.Appearance.Image	 = Bitmap.FromHicon(SystemIcons.Information.Handle);
			stateButtonAlignCenter.SharedProps.AppearancesSmall.Appearance.Image = Bitmap.FromHicon(SystemIcons.Exclamation.Handle);
			stateButtonAlignRight.SharedProps.AppearancesSmall.Appearance.Image  = Bitmap.FromHicon(SystemIcons.WinLogo.Handle);


			// ボタンで画像を表示するために、メニューの表示スタイルを設定します
			stateButtonAlignLeft.MenuDisplayStyle	= StateButtonMenuDisplayStyle.DisplayToolImage;
			stateButtonAlignCenter.MenuDisplayStyle = StateButtonMenuDisplayStyle.DisplayToolImage;
			stateButtonAlignRight.MenuDisplayStyle	= StateButtonMenuDisplayStyle.DisplayToolImage;


			// ----------------------------------------------------------------------------
			// 3 つの状態ボタンの状態 (チェックまたはチェック解除) を
			// 構成する OptionSet オブジェクトを作成します  
			int index = this.ultraToolbarsManager1.OptionSets.Add(false, "MyAlignOptionSet");


			// オプション セットに 3 つの状態ボタンを追加します
			this.ultraToolbarsManager1.OptionSets[index].Tools.AddToolRange( new string [] {"AlignLeft", "AlignCenter", "AlignRight"} );


			// ----------------------------------------------------------------------------
			// 'AlignLeft' ボタンをチェックします
			stateButtonAlignLeft.Checked = true;


			// ----------------------------------------------------------------------------
			// ツールバーを作成し、状態ボタンをツールバーに追加します
			this.ultraToolbarsManager1.Toolbars.AddToolbar("MyAlignmentToolbar");

				// ツールバーをフォームの下にドッキングします
				this.ultraToolbarsManager1.Toolbars["MyAlignmentToolbar"].DockedPosition = DockedPosition.Bottom;

				// ツールバーに状態ボタンを追加します
				this.ultraToolbarsManager1.Toolbars["MyAlignmentToolbar"].Tools.AddToolRange(new string [] {"AlignLeft", "AlignCenter", "AlignRight"});


			// 最初のボタンの前にセパレーターを配置するには、最初のボタンの IsFirstInGroup プロパティを設定します
			this.ultraToolbarsManager1.Toolbars["MyAlignmentToolbar"].Tools["AlignLeft"].InstanceProps.IsFirstInGroup = true;

		}
参照