ToolStripItem.Overflow Property

public:
 property System::Windows::Forms::ToolStripItemOverflow Overflow { System::Windows::Forms::ToolStripItemOverflow get(); void set(System::Windows::Forms::ToolStripItemOverflow value); };

public System.Windows.Forms.ToolStripItemOverflow Overflow { get; set; }

member this.Overflow : System.Windows.Forms.ToolStripItemOverflow with get, set

Public Property Overflow As ToolStripItemOverflow

Property Value

One of the ToolStripItemOverflow values. The default is AsNeeded.

Exceptions

Examples

The following code example demonstrates how to set the Text, Overflow, and TextDirection properties, and handle the Click event. To run this example, paste the following code into a form that contains a ToolStrip named movingToolStrip and call InitializeMovingToolStrip in the form's constructor or Load event handler.

ToolStripButton^ changeDirectionButton;

void InitializeMovingToolStrip()
{
 changeDirectionButton = gcnew ToolStripButton;
 movingToolStrip->AutoSize = true;
 movingToolStrip->RenderMode = ToolStripRenderMode::System;
 changeDirectionButton->TextDirection = 
 ToolStripTextDirection::Vertical270;
 changeDirectionButton->Overflow = 
 ToolStripItemOverflow::Never;
 changeDirectionButton->Text = "Change Alignment";
 movingToolStrip->Items->Add(changeDirectionButton);
 changeDirectionButton->Click += gcnew EventHandler(this, 
 &Form1::changeDirectionButtonClick);
}

void changeDirectionButtonClick(Object^ sender, EventArgs^ e)
{
 ToolStripItem^ item = (ToolStripItem^) sender;
 if ((item->TextDirection == ToolStripTextDirection::Vertical270) 
 || (item->TextDirection == ToolStripTextDirection::Vertical90))
 {
 item->TextDirection = ToolStripTextDirection::Horizontal;
 movingToolStrip->Raft = RaftingSides::Top;
 }
 else
 {
 item->TextDirection = 
 ToolStripTextDirection::Vertical270;
 movingToolStrip->Raft = RaftingSides::Left;
 }
}

internal ToolStripButton changeDirectionButton;

private void InitializeMovingToolStrip()
{
 movingToolStrip = new ToolStrip();

 changeDirectionButton = new ToolStripButton();

 movingToolStrip.AutoSize = true;
 movingToolStrip.RenderMode = ToolStripRenderMode.System;

 changeDirectionButton.TextDirection = ToolStripTextDirection.Vertical270;
 changeDirectionButton.Overflow = ToolStripItemOverflow.Never;
 changeDirectionButton.Text = "Change Alignment";
 movingToolStrip.Items.Add(changeDirectionButton);
}

private void changeDirectionButton_Click(object sender, EventArgs e)
{

 ToolStripItem item = (ToolStripItem)sender;

 if (item.TextDirection == ToolStripTextDirection.Vertical270 || item.TextDirection == ToolStripTextDirection.Vertical90)
 {
 item.TextDirection = ToolStripTextDirection.Horizontal;
 movingToolStrip.Dock = System.Windows.Forms.DockStyle.Top;
 }
 else
 {
 item.TextDirection = ToolStripTextDirection.Vertical270;
 movingToolStrip.Dock = System.Windows.Forms.DockStyle.Left;
 }
}

Friend WithEvents changeDirectionButton As ToolStripButton

Private Sub InitializeMovingToolStrip()
 changeDirectionButton = New ToolStripButton()

 movingToolStrip.AutoSize = True
 movingToolStrip.RenderMode = ToolStripRenderMode.System

 changeDirectionButton.TextDirection = ToolStripTextDirection.Vertical270
 changeDirectionButton.Overflow = ToolStripItemOverflow.Never
 changeDirectionButton.Text = "Change Alignment"
 movingToolStrip.Items.Add(changeDirectionButton)
End Sub


Public Sub changeDirectionButton_Click(ByVal sender As Object, _
 ByVal e As EventArgs) Handles changeDirectionButton.Click

 Dim item As ToolStripItem = CType(sender, ToolStripItem)

 If item.TextDirection = ToolStripTextDirection.Vertical270 _
 OrElse item.TextDirection = ToolStripTextDirection.Vertical90 Then

 item.TextDirection = ToolStripTextDirection.Horizontal
 movingToolStrip.Dock = System.Windows.Forms.DockStyle.Top
 Else
 item.TextDirection = ToolStripTextDirection.Vertical270
 movingToolStrip.Dock = System.Windows.Forms.DockStyle.Left
 End If

End Sub

Remarks

Use the Overflow property in stack layouts. In flow and table layouts, the ToolStrip overflow button is not rendered, and therefore the Overflow property is ignored.