Edit

StartAudioCallButton control

  • Article

Core concepts

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

Applies to: Lync 2013 | Lync Server 2013

In this article
Control overview
Members
Code example
Additional resources

Control overview

Use the StartAudioCallButton control in Microsoft Lync Control applications to enable the user to open a Microsoft Lync 2013 conversation window and start a voice conversation between the user who activated the control and another user. StartAudioCallButton is a split-button control. When clicked, the left side of the split button places a call to the default number that is associated with the contact. The right side of the control exposes a menu of calling options, such as Lync Call, Work, and Voice Mail.

StartAudioCallButton ControlStartAudio expanded

Members

Notable StartAudioCallButton control public properties and events that are related to unified communications appear in the following table. For information about other properties and events, see Lync 2013 class libraries reference.

Property

Description

DisplayName property

Gets the display name of the currently signed-in user.

Source property

Gets or sets the contact to use. 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.

ContextualInformation property

Gets or sets a data structure that contains information used to customize the information that accompanies messages. For more information about using contextual information, see Contextual Lync conversations.

Model property

Reserved for internal use. This property may appear in XAML text when editing templates. To preserve control functionality, it should remain static.

Code example

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

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

See also