CustomContactListItem Control

  • Article

Use the CustomContactListItem control with the CustomContactList control in Microsoft Lync 2010 Control applications to show basic or detailed contact and organization information for contacts.

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

CustomContactListItem Control

Members

Notable CustomContactListItem control public properties that relate to unified communications appear in the following table. For more information, see Lync 2010 Class Libraries References.

Property

Description

PersonTwoLineContentTemplate

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

TelephoneTwoLineContentTemplate

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

GroupTwoLineContentTemplate

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

BotTwoLineContentTemplate

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

PersonContentTemplate

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

TelephoneContentTemplate

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

GroupContentTemplate

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

BotContentTemplate

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

ContactLayoutView

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

ShowFriendlyName

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

Source

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.

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

See Also

Other Resources

Lync 2010 Controls Reference

Lync 2010 Controls