Export (0) Print
Expand All

ContactCard Control

[This is preliminary documentation and is subject to change.]

Use the ContactCard control to show basic or detailed contact and organization information for contacts. This control displays presence and availability of colleagues, and gives users the ability to start instant message sessions, voice calls, file transfers, application sharing sessions, or conference calls.

Notable ContactCard control public properties and events relating to unified communications appear in the following table. For a full list, see topics in the Communicator 2010 API Class Library documentation.

Property or Event

Description

DisplayName property

Gets the display name of the currently logged in user.

SelectedTabIndex property

Gets or sets the index of the tab item to display when the Contact Card is expanded.

ExpanderVisibility property

Gets Expander Button visibility state.

ContextualInformation property

Gets or sets a data structure which contains information used to customize the information that accompanies messages. For more information on the use of contextual information, see the topics listed at Contextual Conversations.

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 as-is. This behavior is deterministic, and yields the best performance.

IsExpanded property

Gets or sets a bool value which indicates whether or not the details section of the ContactCard control is expanded.

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

<StackPanel>
  <controls:ContactCard Source="sip:elise@contoso.com" />
</StackPanel>

Community Additions

Show:
© 2015 Microsoft