ToolBarButton クラス

[アーティクル]
03/28/2008

Windows ツールバーボタンを表します。

この型のすべてのメンバの一覧については、ToolBarButton メンバを参照してください。

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Windows.Forms.ToolBarButton

Public Class ToolBarButton
   Inherits Component
[C#]
public class ToolBarButton : Component
[C++]
public __gc class ToolBarButton : public Component
[JScript]
public class ToolBarButton extends Component

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

ToolBarButton コントロールの親は、 ToolBar コントロールです。ツールバーボタンを作成した後に設定する共通プロパティは、 Text プロパティおよび ImageIndex プロパティです。イメージの下または右にテキストを表示するには、ボタンの Text プロパティを設定します。ボタンにイメージを割り当てるには、 ImageList を作成し、そのオブジェクトをツールバーの ImageList プロパティに割り当て、イメージのインデックス値をボタンの ImageIndex プロパティに代入します。

ツールバーに割り当てたツールバーボタンの外観を変更するには、親ツールバーコントロールの Appearance プロパティを設定します。 ToolBarAppearance.Flat に設定すると、ボタンはフラットな外観で表示されます。マウスポインタをボタンの上に移動すると、ボタンの外観が 3D に変化します。ボタンがフラットな外観である場合、ボタンの区切り記号は、各ボタンの間に空白ではなく線として表示されます。 Appearance プロパティが ToolBarAppearance.Normal に設定されている場合、ボタンは 3D の浮き出した状態の外観になり、割れ目のような区切り記号が各ボタンの間に表示されます。

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

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

使用例

[Visual Basic, C#, C++] ToolBar と 3 つの ToolBarButton コントロールを作成する例を次に示します。ツールバーボタンはボタンコレクションに割り当てられ、コレクションはツールバーに割り当てられ、ツールバーはフォームに追加されます。ツールバーの ButtonClick イベントが発生すると、 ToolBarButtonClickEventArgs の Button プロパティが評価され、適切なダイアログボックスが開きます。このコードは、 Form 、 OpenFileDialog 、 SaveFileDialog 、および PrintDialog がすべて作成されていることを前提にしています。

 
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    

Protected Sub toolBar1_ButtonClick(sender As Object, _
    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


[C#] 
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);
 }
 
 protected 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; 
    }
 }


[C++] 
public:
    void InitializeMyToolBar() {
        // Create and initialize the ToolBar and ToolBarButton controls.
        toolBar1 = new ToolBar();
        ToolBarButton __gc *toolBarButton1 = new ToolBarButton();
        ToolBarButton __gc *toolBarButton2 = new ToolBarButton();
        ToolBarButton __gc *toolBarButton3 = new ToolBarButton();

        // Set the Text properties of the ToolBarButton controls.
        toolBarButton1->Text = S"Open";
        toolBarButton2->Text = S"Save";
        toolBarButton3->Text = S"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, &Form1::toolBar1_ButtonClick);

        // Add the ToolBar to the Form.
        Controls->Add(toolBar1);
    };

protected:
    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; 
        };
    };

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

名前空間: System.Windows.Forms

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)

参照

次の方法で共有

ToolBarButton クラス

スレッドセーフ

解説

使用例

必要条件

参照

その他のリソース