Export (0) Print
Expand All

Messenger Web Bar Control

Ff749844.note(en-us,MSDN.10).gifNote:
Current information about Live Connect is now available in the Windows Live Developer Center. The information in the following sections is provided for legacy purposes only.

The Messenger Web Bar is a single UI Control that contains a full Windows Live Messenger experience. The Messenger Web Bar has the following functionality:

  • Contact list—Enables the user to manage contacts and interact with them.
  • Conversation list—Contains all active conversations.
  • User area—Displays the user's presence and allows the user to update that presence.
  • Cross-page navigation—Enables the user to stay signed in to Windows Live Messenger while they navigate from page to page within your website. Because Messenger Web Bar works across pages, conversations that start on one page can continue on another.

All of this functionality is encapsulated in a small bar at the bottom of the page.

Using the Messenger Web Bar, it is easy to add a full Messenger experience to your application website.

The following example shows how to insert a default Messenger Web Bar control into a webpage.

<wl:bar>
</wl:bar>

The following table lists the attributes for the Messenger Web Bar control.

Name Type Required Default Value Description

on-consent-completed

Function Callback

No

none

Sets the event handler that fires the on-consent-completed event. When the user grants consent to the application, the application receives a consent token that it can store and use to sign in Windows Live Messenger Service users. The token value is stored in the event arguments for ConsentCompleted.

sign-in-enabled

Boolean

No

true

Sets whether a sign-in control should be part of the Messenger Web Bar.

hide-first-run-experience

Boolean

No

false

Sets whether to display the first-run experience.

The first-run experience walks the user through using Windows Live Messenger on the web.

The following screen shot shows the Messenger Web Bar control.

Messenger Web Bar control
Show:
© 2014 Microsoft