UserDisplayInfo.ApplicationDisplayName Property
Gets the user’s display name for use by apps that are not games.
Syntax
public:
property String^ ApplicationDisplayName {
String^ get ();
}
Property value
Type: String
Returns user’s display name for use by apps.
Remarks
The “Display Name and Gamerpic” XR lists specific requirements for how user names and avatar images are displayed. Consult the XR documentation for details.
Use ApplicationDisplayName when displaying the user’s name in contexts other than games or game-related apps. This value is the user’s chosen way to display their name in such contexts.
Use GameDisplayName when displaying a user’s name in a game or a game-related app, as it represents the user’s chosen display name while gaming. Think of this value as representing the player’s chosen gamer tag, but keep in mind that it’s the player’s choice, and doesn’t necessarily match the name on their passport.
Note that the XR specifically requires the use of either GameDisplayName or ApplicationDisplayName, and does not mention Gamertag. This requirement is in support of users’ ability to customize the name they use in different contexts. If the user wants their GameDisplayName to be their gamertag, then they can choose to do so in their Xbox One settings. Your title must honor those settings. Gamertag> is made available for back-compatibility, but its use in new title code should be rare.
Note
This is a cross-OS call. For more information, see Cross-OS Calls.
Requirements
Namespace: Windows.Xbox.System
Metadata: windows.winmd