Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

ToolBarTextAlign Enum

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Source:
ToolBarTextAlign.cs
Source:
ToolBarTextAlign.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Caution

ToolBar is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use ToolStrip instead.

Specifies the alignment of text on the toolbar button control.

public enum class ToolBarTextAlign
public enum ToolBarTextAlign
[System.ComponentModel.Browsable(false)]
[System.Obsolete("`ToolBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public enum ToolBarTextAlign
type ToolBarTextAlign = 
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`ToolBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type ToolBarTextAlign = 
Public Enum ToolBarTextAlign
Inheritance
ToolBarTextAlign
Attributes

Fields

Name Value Description
Underneath 0

The text is aligned underneath the toolbar button image.

Right 1

The text is aligned to the right of the toolbar button image.

Examples

The following example creates a ToolBar control, sets some of its common properties, and adds it to a Form. Delegates are also added to the ButtonClick and ButtonDropDown events. This example assumes a ToolBar named toolBar1 and an ImageList named imageList1 have been declared.

void AddToolBar()
{
 
 // Add a toolbar and set some of its properties.
 toolBar1 = gcnew ToolBar;
 toolBar1->Appearance = System::Windows::Forms::ToolBarAppearance::Flat;
 toolBar1->BorderStyle = System::Windows::Forms::BorderStyle::None;
 toolBar1->Buttons->Add( this->toolBarButton1 );
 toolBar1->ButtonSize = System::Drawing::Size( 24, 24 );
 toolBar1->Divider = true;
 toolBar1->DropDownArrows = true;
 toolBar1->ImageList = this->imageList1;
 toolBar1->ShowToolTips = true;
 toolBar1->Size = System::Drawing::Size( 292, 25 );
 toolBar1->TabIndex = 0;
 toolBar1->TextAlign = System::Windows::Forms::ToolBarTextAlign::Right;
 toolBar1->Wrappable = false;
 
 // Add handlers for the ButtonClick and ButtonDropDown events.
 toolBar1->ButtonDropDown += gcnew ToolBarButtonClickEventHandler( this, &MyToolBar::toolBar1_ButtonDropDown );
 toolBar1->ButtonClick += gcnew ToolBarButtonClickEventHandler( this, &MyToolBar::toolBar1_ButtonClicked );
 
 // Add the toolbar to the form.
 this->Controls->Add( toolBar1 );
}
private void AddToolBar()
{
 // Add a toolbar and set some of its properties.
 toolBar1 = new ToolBar();
 toolBar1.Appearance = System.Windows.Forms.ToolBarAppearance.Flat;
 toolBar1.BorderStyle = System.Windows.Forms.BorderStyle.None;
 toolBar1.Buttons.Add(this.toolBarButton1);
 toolBar1.ButtonSize = new System.Drawing.Size(24, 24);
 toolBar1.Divider = true;
 toolBar1.DropDownArrows = true;
 toolBar1.ImageList = this.imageList1;
 toolBar1.ShowToolTips = true;
 toolBar1.Size = new System.Drawing.Size(292, 25);
 toolBar1.TabIndex = 0;
 toolBar1.TextAlign = System.Windows.Forms.ToolBarTextAlign.Right;
 toolBar1.Wrappable = false;
 
 // Add handlers for the ButtonClick and ButtonDropDown events.
 toolBar1.ButtonDropDown += 
 new ToolBarButtonClickEventHandler(toolBar1_ButtonDropDown);
 toolBar1.ButtonClick += 
 new ToolBarButtonClickEventHandler(toolBar1_ButtonClicked);

 // Add the toolbar to the form.
 this.Controls.Add(toolBar1);
}
Private Sub AddToolBar()
 ' Add a toolbar and set some of its properties.
 toolBar1 = New ToolBar()
 toolBar1.Appearance = System.Windows.Forms.ToolBarAppearance.Flat
 toolBar1.BorderStyle = System.Windows.Forms.BorderStyle.None
 toolBar1.Buttons.Add(Me.toolBarButton1)
 toolBar1.ButtonSize = New System.Drawing.Size(24, 24)
 toolBar1.Divider = True
 toolBar1.DropDownArrows = True
 toolBar1.ImageList = Me.imageList1
 toolBar1.ShowToolTips = True
 toolBar1.Size = New System.Drawing.Size(292, 25)
 toolBar1.TabIndex = 0
 toolBar1.TextAlign = System.Windows.Forms.ToolBarTextAlign.Right
 toolBar1.Wrappable = False

 ' Add handlers for the ButtonClick and ButtonDropDown events.
 AddHandler toolBar1.ButtonDropDown, AddressOf toolBar1_ButtonDropDown
 AddHandler toolBar1.ButtonClick, AddressOf toolBar1_ButtonClicked

 ' Add the toolbar to the form.
 Me.Controls.Add(toolBar1)
End Sub

Remarks

This enumeration is used by members such as ToolBar.TextAlign.

Room is reserved for an image to be displayed on toolbar buttons. The alignment of text is in relation to the image displayed on the toolbar button. If no image is assigned to the button, the reserved space will appear to the left, or above the text displayed.

Applies to

See also


Feedback

Was this page helpful?