IM Control Parameter Reference

IM Control Parameter Reference

Switch on low bandwidth view

Collapse All

Language Filter

This topic describes all of the parameters that you can use with the Windows Live Messenger IM Control.

Required Parameters

The following table shows the required parameters.

Parameter	Value	Example
invitee	The user being messaged.	invitee=12BACD345678@apps.messenger.live.com
mkt	Specifies a culture ID indicating the language in which to localize the UI text for the control. (For details, see Appendix A: Supported Languages.) If this parameter is omitted, a default value of en-US will be used.	mkt=ja-jp

Parameter

Value

Example

invitee

The user being messaged.

invitee=12BACD345678@apps.messenger.live.com

mkt

Specifies a culture ID indicating the language in which to localize the UI text for the control. (For details, see Appendix A: Supported Languages.)

If this parameter is omitted, a default value of en-US will be used.

mkt=ja-jp

Optional Parameters

The following table shows the optional parameters.

Parameter	Description
useTheme	Boolean indicating whether custom themes should be applied.
foreColor	Text color. Note "8 characters" text string is always gray colored.
backColor	Background color.
linkColor	Text color for hyperlinks.
borderColor	Border color.
buttonForeColor	Text color for active buttons.
buttonBackColor	Background color for active buttons.
buttonBorderColor	Border color for buttons.
buttonDisabledColor	Background color for a disabled button.
headerForeColor	Text color for the header area.
headerBackColor	Background color for the header area.
menuForeColor	Text color for menus.
menuBackColor	Background color for menus.
chatForeColor	Text color for the text and typing area.
chatBackColor	Background for the text and typing area.
chatDisabledColor	Background color for the text and typing area when the user's status is Offline.
chatErrorColor	Text color for error messages in the text area.
chatLabelColor	Text color for the text IM Label (for example, "<Display Name>:")
dt	delegation token.
wl_sig_source	Inviter e-mail address. Used only for Delegated Authentication.
wl_sig_source_display_name	Inviter display name. Used only for Delegated Authentication.
wl_sig_target_display_name	Invitee display name. Used only for Delegated Authentication.

Example

The following code example shows how the markup appears for IM Control parameters:

<iframe
   src="http://settings.messenger.live.com/Conversation/IMMe.aspx?invitee=12BACD345678%40apps.messenger.live.com&mkt=en-US&useTheme=true&foreColor=040404"
   width="300"
   height="300"
   style="border: solid 1px black; width: 300px; height: 300px;" frameborder="0"
>
</iframe>

Important:
JavaScript must be enabled in order for the IM Control to work.

Supported Languages

The Appendix A: Supported Languages topic shows the supported languages for the Windows Live Messenger IM Control.