ToolBarButton クラス

リファレンス

定義

名前空間:: System.Windows.Forms

アセンブリ:: System.Windows.Forms.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

このクラスは .NET Core 3.1 以降のバージョンでは利用できません。代わりに ToolStripButton を使用してください。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 プロパティが評価され、適切なダイアログボックスが開きます。このコードでは、 Form OpenFileDialog SaveFileDialog PrintDialog がすべて作成されている必要があります。

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コレクションを作成するには、プロパティのメソッドを使用してボタンをAdd Buttons個別に追加します。または、メソッドを使用して複数のツールバーボタンを AddRange 追加することもできます。

コンストラクター

ToolBarButton()	ToolBarButton クラスの新しいインスタンスを初期化します。
ToolBarButton(String)	ToolBarButton クラスの新しいインスタンスを初期化し、割り当てられたテキストをボタン上に表示します。

プロパティ

CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 (継承元 Component)
Container	IContainer を含む Component を取得します。 (継承元 Component)
DesignMode	Component が現在デザインモードかどうかを示す値を取得します。 (継承元 Component)
DropDownMenu	ドロップダウンツールバーボタンに表示されるメニューを取得または設定します。
Enabled	ボタンを有効にするかどうかを示す値を取得または設定します。
Events	Component に結び付けられているイベントハンドラーのリストを取得します。 (継承元 Component)
ImageIndex	ボタンに割り当てられたイメージのインデックス値を取得または設定します。
ImageKey	ボタンに割り当てられたイメージの名前を取得または設定します。
Name	ボタンの名前。
Parent	ツールバーボタンを割り当てるツールバーコントロールを取得します。
PartialPush	トグルスタイルのツールバーボタンが部分的に押されているかどうかを示す値を取得または設定します。
Pushed	トグルスタイルのツールバーボタンが現在押されている状態かどうかを示す値を取得または設定します。
Rectangle	ツールバーボタンの外接する四角形を取得します。
Site	Component の ISite を取得または設定します。 (継承元 Component)
Style	ツールバーボタンのスタイルを取得または設定します。
Tag	ツールバーボタンに関するデータを格納しているオブジェクトを取得または設定します。
Text	ツールバーボタンに表示されているテキストを取得または設定します。
ToolTipText	ボタンのツールヒントとして表示されるテキストを取得または設定します。
Visible	ツールバーボタンが可視かどうかを示す値を取得または設定します。

メソッド

CreateObjRef(Type)	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
Dispose()	Component によって使用されているすべてのリソースを解放します。 (継承元 Component)
Dispose(Boolean)	ToolBarButton によって使用されているアンマネージドリソースを解放し、オプションでマネージドリソースも解放します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	古い. 対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
GetService(Type)	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (継承元 Component)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
ToString()	ToolBarButton コントロールを表す文字列を返します。

イベント

Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。

(継承元 Component)

適用対象

次の方法で共有