Edit

CustomContactListItem control

  • Article

Core concepts

Learn about the properties of the Microsoft Lync 2013 CustomContactListItem control.

Applies to: Lync 2013

In this article
Control overview
Members
Code example
Additional resources

Control overview

Use the CustomContactListItem control with the CustomContactList control to show basic or detailed contact and organization information for contacts.

CustomContactListItem is an item control, created for use with the CustomContactList control. CustomContactListItem supports a Source property, similar to that used by other Microsoft Lync 2013 SDK objects that operate on a single contact.

CustomContactListItem Control

Members

Notable CustomContactListItem control public properties relating to unified communications appear in the following table. For a full list, see Lync 2013 class libraries reference.

Property

Description

PersonTwoLineContentTemplate property

Gets or sets the DataTemplate used to render a contact when the ContactLayoutView property is set to TwoLines mode.

TelephoneTwoLineContentTemplate property

Gets or sets the DataTemplate used to render a telephone-only contact when the ContactLayoutView property is set to TwoLines mode.

GroupTwoLineContentTemplate property

Gets or sets the DataTemplate used to render a DistributionGroup-type contact when the ContactLayoutView property is set to TwoLines mode.

BotTwoLineContentTemplate property

Gets or sets the DataTemplate used to render a bot-type contact when the ContactLayoutView property is set to TwoLines mode.

PersonContentTemplate property

Gets or sets the DataTemplate used to render a contact when the ContactLayoutView property is set to OneLine mode.

TelephoneContentTemplate property

Gets or sets the DataTemplate used to render a telephone-only contact when the ContactLayoutView property is set to OneLine mode.

GroupContentTemplate property

Gets or sets the DataTemplate used to render a DistributionGroup-type contact when the ContactLayoutView property is set to OneLine mode.

BotContentTemplate property

Gets or sets the DataTemplate used to render bot-type contact when the ContactLayoutView property is set to OneLine mode.

ContactLayoutView property

Gets or sets an enumerated value that toggles the display between Show Photos and Show Status Only. The default is Show Photos.

ShowFriendlyName property

Gets or sets whether contacts in the list are shown using their display names or their SIP URIs.

Source property

Gets or sets the contact to display. Valid types include the Contact object, DistributionGroup object, and String.

  • If the value is a string that does not contain the sip: or tel: prefix, the control performs a search, using the string specified as a search criteria, and loads the first contact in the result set matching the specified string. This behavior is not deterministic and yields the slowest performance.

  • If the value is a SIP URI string qualified by the sip: or tel: prefix, the contact is loaded using an exact match of the specified URI. This behavior is deterministic and yields better performance.

  • If the value is a Contact or DistributionGroup object, it's used without changes. This behavior is deterministic and yields the best performance.

Code example

The following example can be used for Microsoft Silverlight and Microsoft Windows Presentation Foundation (WPF) application development.

<controls:CustomContactList>
  <controls:CustomContactListItem Source="sip:mary@contoso.com"/>
</controls:CustomContactList>

See also