MenuItem::Text Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets a value indicating the caption of the menu item.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

property String^ Text {
	String^ get();
	void set(String^ value);

Property Value

Type: System::String^

The text caption of the menu item.

When you specify a caption for your menu item, you can also specify an access key by placing an '&' before the character to be used as the access key. For example, to specify the "F" in "File" as an access key, you would specify the caption for the menu item as "&File". You can use this feature to provide keyboard navigation for your menus.

Setting this property to "-" causes your menu item to be displayed as a separator (a horizontal line) rather than a standard menu item.

The following code example creates a menu item, sets the caption, assigns a shortcut key, makes the menu item visible, and shows the shortcut key display for the menu item. The example requires that a MenuItem has been created that is named menuItem1.

   void SetupMyMenuItem()
      // Set the caption for the menu item.
      menuItem1->Text = "&New";
      // Assign a shortcut key.
      menuItem1->Shortcut = Shortcut::CtrlN;
      // Make the menu item visible.
      menuItem1->Visible = true;
      // Display the shortcut key combination.
      menuItem1->ShowShortcut = true;

.NET Framework
Available since 1.1
Return to top