The Display Name control shows the display name for a contact. It is represented in markup by the display-name tag.
The following example shows the markup to insert the Display Name control into a Web page.
<msgr:display-name
cid="-0123456789"
default-name="An alternate display name"
editable="true"
linked="true">
</msgr:display-name>
The following table lists the attributes for the Display Name control.
|
Name
|
Type
|
Required
|
Default Value
|
Description
|
|---|
|
cid
|
String
|
Yes
|
None
|
Sets the CID of the contact. To display data for the signed-in user, use a value of $user.
|
|
default-name
|
String
|
No
|
None
|
Sets a default value that is shown when the display name is unavailable.
|
|
editable
|
Boolean
|
No
|
True
|
Sets whether the display name is editable. This is applicable only if the CID is set to $user. Otherwise, it is ignored. If this attribute is set to True, the linked attribute is ignored.
|
|
linked
|
Boolean
|
No
|
True
|
Sets whether the display name is a hyperlink to the user's profile page.
|
The following screen shot shows the Display Name control.
Concepts
UI Controls
Application Contact Control
Other Resources
DisplayNameControl Class