5 out of 5 rated this helpful - Rate this topic

IM Control Parameter Reference

Bb936685.note(en-us,MSDN.10).gif Note:
This topic describes functionality that will be obsolete. The information in this topic is provided for legacy purposes only.

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

The following table shows the required parameters.

Parameter Description

invitee

The user receiving the message. The following markup shows an example of this parameter.

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

mkt

Specifies a culture ID that indicates the language to localize the UI text for the control. See Appendix A: Supported Languages.)

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

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

Text color for error messages in the text area.

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>
Bb936685.note(en-us,MSDN.10).gifImportant:
JavaScript must be enabled for the IM Control to work.

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

Did you find this helpful?
(1500 characters remaining)