ApplicationBarIconButton.Text Property
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Gets or sets the label for the icon button.
Namespace: Microsoft.Phone.Shell
Assembly: Microsoft.Phone (in Microsoft.Phone.dll)
XMLNS for XAML: Not mapped to an xmlns.
Syntax
Public Property Text As String
public string Text { get; set; }
<object Text="string" .../>
Property Value
Type: System..::.String
The label for the icon button.
Implements
IApplicationBarMenuItem..::.Text
Exceptions
| Exception | Condition |
|---|---|
| InvalidOperationException | The property is null or empty when attempting to add a button to an Application Bar or the property is set to null or empty after the button has been added to an Application Bar. |
| ArgumentOutOfRangeException | The string value exceeds the maximum number of characters allowed. |
Remarks
The label appears when the user clicks the ellipsis to open or expand the Application Bar. The text is clipped when it exceeds the available space.
The maximum number of characters for the Text property is 255.
Version Information
Windows Phone OS
Supported in: 8.1, 8.0, 7.1, 7.0
Platforms
Windows Phone
See Also
Reference
ApplicationBarIconButton Class
Microsoft.Phone.Shell Namespace
Other Resources
App bar icon buttons for Windows Phone
How to change app bar icon buttons and menu items dynamically for Windows Phone