ToolBarButton クラス

定義

public ref class ToolBarButton : System::ComponentModel::Component

public class ToolBarButton : System.ComponentModel.Component

type ToolBarButton = class
    inherit Component

Public Class ToolBarButton
Inherits Component

継承

Object

MarshalByRefObject

Component

ToolBarButton

例

次のコード例では、 ToolBar コントロールと 3 つの ToolBarButton コントロールを作成します。 ツール バー ボタンはボタン コレクションに割り当てられ、コレクションはツール バーに割り当てられ、ツール バーはフォームに追加されます。 ツール バーの ButtonClick イベントで、 Button の ToolBarButtonClickEventArgs プロパティが評価され、適切なダイアログ ボックスが開きます。 このコードでは、 FormOpenFileDialogSaveFileDialogPrintDialog がすべて作成されている必要があります。

public:
   void InitializeMyToolBar()
   {
      // Create and initialize the ToolBar and ToolBarButton controls.
      toolBar1 = gcnew ToolBar;
      ToolBarButton^ toolBarButton1 = gcnew ToolBarButton;
      ToolBarButton^ toolBarButton2 = gcnew ToolBarButton;
      ToolBarButton^ toolBarButton3 = gcnew ToolBarButton;
      
      // Set the Text properties of the ToolBarButton controls.
      toolBarButton1->Text = "Open";
      toolBarButton2->Text = "Save";
      toolBarButton3->Text = "Print";
      
      // Add the ToolBarButton controls to the ToolBar.
      toolBar1->Buttons->Add( toolBarButton1 );
      toolBar1->Buttons->Add( toolBarButton2 );
      toolBar1->Buttons->Add( toolBarButton3 );
      
      // Add the event-handler delegate.
      toolBar1->ButtonClick += gcnew ToolBarButtonClickEventHandler(
         this, &Form1::toolBar1_ButtonClick );
      
      // Add the ToolBar to the Form.
      Controls->Add( toolBar1 );
   }

private:
   void toolBar1_ButtonClick(
      Object^ sender,
      ToolBarButtonClickEventArgs^ e )
   {
      // Evaluate the Button property to determine which button was clicked.
      switch ( toolBar1->Buttons->IndexOf( e->Button ) )
      {
         case 0:
            openFileDialog1->ShowDialog();
            // Insert code to open the file.
            break;
         case 1:
            saveFileDialog1->ShowDialog();
            // Insert code to save the file.
            break;
         case 2:
            printDialog1->ShowDialog();
            // Insert code to print the file.    
            break;
      }
   }

public void InitializeMyToolBar()
 {
    // Create and initialize the ToolBar and ToolBarButton controls.
    toolBar1 = new ToolBar();
    ToolBarButton toolBarButton1 = new ToolBarButton();
    ToolBarButton toolBarButton2 = new ToolBarButton();
    ToolBarButton toolBarButton3 = new ToolBarButton();
 
    // Set the Text properties of the ToolBarButton controls.
    toolBarButton1.Text = "Open";
    toolBarButton2.Text = "Save";
    toolBarButton3.Text = "Print";
 
    // Add the ToolBarButton controls to the ToolBar.
    toolBar1.Buttons.Add(toolBarButton1);
    toolBar1.Buttons.Add(toolBarButton2);
    toolBar1.Buttons.Add(toolBarButton3);
    
    // Add the event-handler delegate.
    toolBar1.ButtonClick += new ToolBarButtonClickEventHandler (
       this.toolBar1_ButtonClick);
    
    // Add the ToolBar to the Form.
    Controls.Add(toolBar1);
 }
 
 private void toolBar1_ButtonClick (
                         Object sender, 
                         ToolBarButtonClickEventArgs e)
 {
   // Evaluate the Button property to determine which button was clicked.
   switch(toolBar1.Buttons.IndexOf(e.Button))
   {
      case 0:
         openFileDialog1.ShowDialog();
         // Insert code to open the file.
         break; 
      case 1:
         saveFileDialog1.ShowDialog();
         // Insert code to save the file.
         break; 
      case 2:
         printDialog1.ShowDialog();
         // Insert code to print the file.    
         break; 
    }
 }

Public Sub InitializeMyToolBar()
    ' Create and initialize the ToolBar and ToolBarButton controls.
    Dim toolBar1 As New ToolBar()
    Dim toolBarButton1 As New ToolBarButton()
    Dim toolBarButton2 As New ToolBarButton()
    Dim toolBarButton3 As New ToolBarButton()
    
    ' Set the Text properties of the ToolBarButton controls.
    toolBarButton1.Text = "Open"
    toolBarButton2.Text = "Save"
    toolBarButton3.Text = "Print"
    
    ' Add the ToolBarButton controls to the ToolBar.
    toolBar1.Buttons.Add(toolBarButton1)
    toolBar1.Buttons.Add(toolBarButton2)
    toolBar1.Buttons.Add(toolBarButton3)
    
    ' Add the event-handler delegate.
    AddHandler toolBar1.ButtonClick, AddressOf Me.toolBar1_ButtonClick
    
    ' Add the ToolBar to the Form.
    Controls.Add(toolBar1)
End Sub    

Private Sub toolBar1_ButtonClick(ByVal sender As Object, _
ByVal e As ToolBarButtonClickEventArgs)

    ' Evaluate the Button property to determine which button was clicked.
    Select Case toolBar1.Buttons.IndexOf(e.Button)
        Case 0
            openFileDialog1.ShowDialog()
            ' Insert code to open the file.
        Case 1
            saveFileDialog1.ShowDialog()
            ' Insert code to save the file.
        Case 2
            printDialog1.ShowDialog()
            ' Insert code to print the file.
    End Select
End Sub

注釈

このクラスは .NET Core 3.1 以降のバージョンでは利用できません。 代わりに、ToolStripButton を使用してください。

ToolBarButton コントロールはコントロールによって ToolBar 親されます。 ツール バー ボタンの作成後に設定する一般的なプロパティは、 と ImageIndexですText。 ボタンの プロパティを Text 設定して、画像の下または右側にテキストを表示します。 を作成してボタンにイメージを ImageList割り当てるには、ツール バーの プロパティに ImageList 画像を割り当てます。次に、ボタンの プロパティに ImageIndex イメージ インデックス値を割り当てます。

ツール バーに割り当てられているツール バー ボタンの外観を変更するには、親ツール バー コントロールの プロパティを設定 Appearance します。 外観により ToolBarAppearance.Flat 、ボタンはフラットな外観になります。 マウス ポインターがボタンの上に移動すると、その外観は 3 次元に変わります。 ボタンの外観がフラットな場合、ボタンの区切り記号はボタン間のスペースではなく線として表示されます。 プロパティが Appearance に ToolBarAppearance.Normal設定されている場合、ボタンは上向きおよび 3 次元で表示され、区切り記号はボタン間のギャップとして表示されます。

プロパティが ContextMenu に設定されている場合は、 ボタンに Style を ToolBarButtonStyle.DropDown割り当てることができます。 ボタンがクリックされると、割り当てられたメニューが表示されます。

にToolBar表示するコントロールのToolBarButtonコレクションを作成するには、 プロパティの メソッドを使用してボタンをAddButtons個別に追加します。 または、 メソッドを使用して複数のツール バー ボタンを AddRange 追加することもできます。

コンストラクター

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• ToolBar
• MenuItem
• ImageList
• ToolTip