ToolStripItem.Text Property

public:
 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };

public virtual string Text { get; set; }

public virtual string? Text { get; set; }

member this.Text : string with get, set

Public Overridable Property Text As String

Property Value

A string representing the item's text. The default value is the empty string ("").

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

You can create an access key to the item by adding an ampersand ("&") before a letter in the text value. For more information, see How to: Create Access Keys for Windows Forms Controls.

ToolStripItem uses the Text property as the default source for the ToolTip content. Set AutoToolTip to false to use ToolTipText as the source for ToolTip content.