This topic describes all of the parameters that you can use with the Windows Live Messenger IM Control.
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
|
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.
|
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>
.gif) Important: |
|---|
|
JavaScript must be enabled in order for the IM Control to work.
|
The Appendix A: Supported Languages topic shows the supported languages for the Windows Live Messenger IM Control.