ToolBarButton.DropDownMenu プロパティ

.NET Framework クラス ライブラリ リファレンス

ToolBarButton.DropDownMenu プロパティ

ドロップダウン ツール バー ボタンに表示されるメニューを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property DropDownMenu As
 Menu

Visual Basic (使用法)

Dim instance As ToolBarButton
Dim value As Menu

value = instance.DropDownMenu

instance.DropDownMenu = value

C#

public Menu DropDownMenu { get; set;
 }

C++

public:
property Menu^ DropDownMenu {
    Menu^ get ();
    void set (Menu^ value);
}

J#

/** @property */
public Menu get_DropDownMenu ()

/** @property */
public void set_DropDownMenu (Menu value)

JScript

public function get DropDownMenu
 () : Menu

public function set DropDownMenu
 (value : Menu)

プロパティ値
ドロップダウン ツール バー ボタンに表示される ContextMenu。既定値は null 参照 (Visual Basic では Nothing) です。

例外

例外の種類	条件
ArgumentException	割り当てられたオブジェクトが ContextMenu ではありません。

解説

ドロップダウン ボタンをクリックすると表示される ContextMenu を指定できます。このプロパティは、Style プロパティ値が ToolBarButtonStyle.DropDownButton に設定されていない限り、使用されません。

メモ
DropDownMenu プロパティが Menu 型として定義されていても、ContextMenu が割り当てられなければ正しく表示されません。独自に MenuItem 派生クラスを作成している場合は、そのオブジェクトを ContextMenu に割り当て、ContextMenu を DropDownMenu プロパティに割り当てる必要があります。

使用例

ToolBar と 3 つの ToolBarButton コントロールを作成し、ボタンをツール バーに割り当ててから、ボタンの共通プロパティの一部を設定するコード例を次に示します。このコードは、ImageList、ToolTip、および Form が作成されていることと、ImageList に少なくとも 1 つの Image が割り当てられていることを前提にしています。

Visual Basic

Public Sub InitializeMyToolBar()
    ' Create the ToolBar, ToolBarButton controls, and menus.
    Dim toolBarButton1 As New
 ToolBarButton("Open")
    Dim toolBarButton2 As New
 ToolBarButton()
    Dim toolBarButton3 As New
 ToolBarButton()
    Dim toolBar1 As New
 ToolBar()
Dim menuItem1 As New MenuItem("Print")
Dim contextMenu1 As New
 ContextMenu(New MenuItem(){menuItem1})
    
    ' Add the ToolBarButton controls to the ToolBar.
    toolBar1.Buttons.Add(toolBarButton1)
    toolBar1.Buttons.Add(toolBarButton2)
    toolBar1.Buttons.Add(toolBarButton3)
    
    ' Assign an ImageList to the ToolBar and show ToolTips.
    toolBar1.ImageList = imageList1
    toolBar1.ShowToolTips = True
    
    ' Assign ImageIndex, ContextMenu, Text, ToolTip, and
    ' Style properties of the ToolBarButton controls. 
    toolBarButton2.Style = ToolBarButtonStyle.Separator
    toolBarButton3.Text = "Print"
    toolBarButton3.Style = ToolBarButtonStyle.DropDownButton
    toolBarButton3.ToolTipText = "Print"
    toolBarButton3.ImageIndex = 0
    toolBarButton3.DropDownMenu = contextMenu1
    
    ' Add the ToolBar to a form.
    Controls.Add(toolBar1)
End Sub

C#

public void InitializeMyToolBar()
 {
    // Create the ToolBar, ToolBarButton controls, and menus.
    ToolBarButton toolBarButton1 = new ToolBarButton("Open");
    ToolBarButton toolBarButton2 = new ToolBarButton();
    ToolBarButton toolBarButton3 = new ToolBarButton();
    ToolBar toolBar1 = new ToolBar();
    MenuItem menuItem1 = new MenuItem("Print");
    ContextMenu contextMenu1 = new ContextMenu(new
 MenuItem[]{menuItem1});

     
    // Add the ToolBarButton controls to the ToolBar.
    toolBar1.Buttons.Add(toolBarButton1);
    toolBar1.Buttons.Add(toolBarButton2);
    toolBar1.Buttons.Add(toolBarButton3);
 
    // Assign an ImageList to the ToolBar and show ToolTips.
    toolBar1.ImageList = imageList1;
    toolBar1.ShowToolTips = true;
 
    /* Assign ImageIndex, ContextMenu, Text, ToolTip, and 
       Style properties of the ToolBarButton controls. */
    toolBarButton2.Style = ToolBarButtonStyle.Separator;
    toolBarButton3.Text = "Print";
    toolBarButton3.Style = ToolBarButtonStyle.DropDownButton;
    toolBarButton3.ToolTipText = "Print";
    toolBarButton3.ImageIndex = 0;
    toolBarButton3.DropDownMenu = contextMenu1;
 
    // Add the ToolBar to a form.
    Controls.Add(toolBar1);
 }
 

C++

public:
   void InitializeMyToolBar()
   {
      // Create the ToolBar, ToolBarButton controls, and menus.
      ToolBarButton^ toolBarButton1 = gcnew ToolBarButton( "Open" );
      ToolBarButton^ toolBarButton2 = gcnew ToolBarButton;
      ToolBarButton^ toolBarButton3 = gcnew ToolBarButton;
      ToolBar^ toolBar1 = gcnew ToolBar;
      MenuItem^ menuItem1 = gcnew MenuItem( "Print" );
      array<MenuItem^>^ temp1 = {menuItem1};
      System::Windows::Forms::ContextMenu^ contextMenu1 =
         gcnew System::Windows::Forms::ContextMenu( temp1 );
      
      // Add the ToolBarButton controls to the ToolBar.
      toolBar1->Buttons->Add( toolBarButton1 );
      toolBar1->Buttons->Add( toolBarButton2 );
      toolBar1->Buttons->Add( toolBarButton3 );
      
      // Assign an ImageList to the ToolBar and show ToolTips.
      toolBar1->ImageList = imageList1;
      toolBar1->ShowToolTips = true;
      
      /* Assign ImageIndex, ContextMenu, Text, ToolTip, and 
         Style properties of the ToolBarButton controls. */
      toolBarButton2->Style = ToolBarButtonStyle::Separator;
      toolBarButton3->Text = "Print";
      toolBarButton3->Style = ToolBarButtonStyle::DropDownButton;
      toolBarButton3->ToolTipText = "Print";
      toolBarButton3->ImageIndex = 0;
      toolBarButton3->DropDownMenu = contextMenu1;
      
      // Add the ToolBar to a form.
      Controls->Add( toolBar1 );
   }

J#

public void InitializeMyToolBar()
{
    // Create the ToolBar, ToolBarButton controls, and menus.
    ToolBarButton toolBarButton1 = new ToolBarButton("Open");
    ToolBarButton toolBarButton2 = new ToolBarButton();
    ToolBarButton toolBarButton3 = new ToolBarButton();
    ToolBar toolBar1 = new ToolBar();
    MenuItem menuItem1 = new MenuItem("Print");
    ContextMenu contextMenu1 = new ContextMenu(new
 MenuItem[] {menuItem1});

    // Add the ToolBarButton controls to the ToolBar.
    toolBar1.get_Buttons().Add(toolBarButton1);
    toolBar1.get_Buttons().Add(toolBarButton2);
    toolBar1.get_Buttons().Add(toolBarButton3);

    // Assign an ImageList to the ToolBar and show ToolTips.
    toolBar1.set_ImageList(imageList1);
    toolBar1.set_ShowToolTips(true);

    /* Assign ImageIndex, ContextMenu, Text, ToolTip, and 
     * Style properties of the ToolBarButton controls. 
     */
    toolBarButton2.set_Style(ToolBarButtonStyle.Separator);
    toolBarButton3.set_Text("Print");
    toolBarButton3.set_Style(ToolBarButtonStyle.DropDownButton);
    toolBarButton3.set_ToolTipText("Print");
    toolBarButton3.set_ImageIndex(0);
    toolBarButton3.set_DropDownMenu(contextMenu1);

    // Add the ToolBar to a form.
    get_Controls().Add(toolBar1);
} //InitializeMyToolBar

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
ToolBarButton クラス
ToolBarButton メンバ
System.Windows.Forms 名前空間
MenuItem クラス