ToolBar 클래스
Windows 도구 모음을 나타냅니다. ToolStrip에 의해 이전 버전 ToolBar 컨트롤의 여러 기능이 교체 및 추가되었지만 ToolBar는 이전 버전과의 호환성을 위해 유지되었으며, 필요한 경우 선택해서 사용할 수 있습니다.
네임스페이스: System.Windows.Forms
어셈블리: System.Windows.Forms(system.windows.forms.dll)
구문
‘선언
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class ToolBar
Inherits Control
‘사용 방법
Dim instance As ToolBar
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
public class ToolBar : Control
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)]
public ref class ToolBar : public Control
/** @attribute ComVisibleAttribute(true) */
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
public class ToolBar extends Control
ComVisibleAttribute(true)
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)
public class ToolBar extends Control
설명
ToolBar 컨트롤은 표준 단추, 토글 스타일 단추 또는 드롭다운 스타일 단추로 나타날 수 있는 ToolBarButton 컨트롤을 표시하는 데 사용됩니다. ImageList를 만들고 이 개체를 도구 모음의 ImageList 속성에 할당한 다음 해당 이미지 인덱스 값을 각 ToolBarButton의 ImageIndex 속성에 할당하는 방법으로 단추에 이미지를 할당할 수 있습니다. 그런 다음 ToolBarButton의 Text 속성을 설정하면 표시할 텍스트를 이미지의 아래쪽 또는 오른쪽에 할당할 수 있습니다.
도구 모음 및 해당 단추를 평면 모양으로 만들려면 도구 모음의 Appearance 속성을 Flat으로 설정합니다. 마우스 포인터를 단추 위로 가져가면 단추의 모양이 3차원으로 바뀝니다. 도구 모음 단추는 구분선을 사용하여 논리 그룹으로 나눌 수 있습니다. 구분선은 Style 속성이 ToolBarButtonStyle.Separator로 설정된 도구 모음 단추입니다. 단추 구분선은 도구 모음이 평면 모양일 때 단추 사이에 공간이 아닌 선으로 나타납니다. Appearance 속성이 Normal로 설정되어 있으면 도구 모음 단추가 3차원으로 볼록하게 나타납니다.
ButtonSize 속성에 대한 값을 지정하면 도구 모음에 있는 모든 단추가 지정된 크기로 제한됩니다. 그렇지 않으면 단추가 단추 내용에 따라 스스로 크기를 조정하고 ButtonSize 속성은 가장 큰 단추의 초기 크기를 반환합니다.
ToolBar에 표시할 ToolBarButton 컨트롤의 컬렉션을 만들려면 Buttons 속성의 Add 또는 Insert 메서드를 사용하여 각 단추를 개별적으로 추가합니다.
Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows CE 플랫폼 참고: 폼에서 ToolBar를 하나만 지원하므로 ToolBar를 추가하려고 하면 NotSupportedException이 throw됩니다. Panel과 같은 폼 이외의 컨트롤에는 ToolBar를 추가할 수 없습니다.
예제
다음 코드 예제에서는 ToolBar와 세 가지 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.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ToolBar
스레드로부터의 안전성
이 형식의 모든 public static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.
플랫폼
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에서 지원