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 2010 SDK objects which 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 topics in the Lync 2010 API Class Library documentation.

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 Contact and DistributionGroup objects, and String.

  • If the value is a string which does not contain the sip: or tel: prefix, the control will perform a search, using the string specified as a search criteria, and will load 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 will be 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 will be 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.

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

See Also

Other Resources

Lync Controls