ToolBar クラス
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文<ComVisibleAttribute(True)> _ <ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _ Public Class ToolBar Inherits Control
[ComVisibleAttribute(true)] [ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] public class ToolBar : Control
[ComVisibleAttribute(true)] [ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] public ref class ToolBar : public Control
解説ToolBar コントロールは、標準のボタン、トグル スタイルのボタン、またはドロップダウン スタイルのボタンとして表示される ToolBarButton コントロールを表示するために使用されます。ボタンにイメージを割り当てるには、ImageList を作成し、それをツール バーの ImageList プロパティに割り当て、イメージのインデックス値を各 ToolBarButton の ImageIndex プロパティに代入します。次に、ToolBarButton の Text プロパティを設定して、イメージの下または右側に表示されるテキストを割り当てます。
ツール バーの Appearance プロパティを Flat に設定して、ツール バーとそのボタンがフラットな外観になるようにします。マウス ポインタをボタンの上に移動すると、ボタンの外観が 3 次元に変化します。ツール バー ボタンは、区切り記号を使用して論理グループに分けることができます。区切り記号は、Style プロパティが ToolBarButtonStyle.Separator に設定されている一種のツール バー ボタンです。ツール バーがフラットな外観である場合、ボタンの区切り記号は、各ボタンとの間に空白ではなく線として表示されます。Appearance プロパティが Normal に設定されている場合、このツール バー ボタンは浮き出した状態の 3D で表示されます。
ButtonSize プロパティの値を指定した場合、ツール バーのすべてのボタンが、指定したサイズに制限されます。指定しない場合、ボタンのサイズは内容によって調整され、ButtonSize プロパティは最大のボタンの初期サイズを返します。
ToolBar 上に表示する ToolBarButton コントロールのコレクションを作成するには、Buttons プロパティの Add メソッド、または Insert メソッドを使用して、ボタンを個別に追加します。
Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows CE プラットフォームメモ : 1 つのフォームでサポートされる ToolBar は 1 つだけです。複数の ToolBar を追加しようとすると、NotSupportedException がスローされます。フォーム以外のコントロール、たとえば Panel に ToolBar を追加することはできません。
使用例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 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
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: 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.set_Text("Open"); toolBarButton2.set_Text("Save"); toolBarButton3.set_Text("Print"); // Add the ToolBarButton controls to the ToolBar. toolBar1.get_Buttons().Add(toolBarButton1); toolBar1.get_Buttons().Add(toolBarButton2); toolBar1.get_Buttons().Add(toolBarButton3); // Add the event-handler delegate. toolBar1.add_ButtonClick(new ToolBarButtonClickEventHandler( this.toolBar1_ButtonClick)); // Add the ToolBar to the Form. get_Controls().Add(toolBar1); } //InitializeMyToolBar protected void toolBar1_ButtonClick(Object sender, ToolBarButtonClickEventArgs e) { // Evaluate the Button property to determine which button was clicked. switch (toolBar1.get_Buttons().IndexOf(e.get_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; } } //toolBar1_ButtonClick
継承階層System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ToolBar
スレッド セーフプラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- ToolBar クラスのページへのリンク
