IM Control Parameter Reference

IM Control Parameter Reference

Collapse All

Language Filter

Windows Live

IM Control Parameter Reference

This topic describes all of the parameters that can be used with the IM Control.

Required Parameters

The following table shows the parameters that are required.

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 user interface text for the control (see the supported languages table below). 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 user interface text for the control (see the supported languages table below).

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 (i.e. “<Display Name>:”)

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 following table shows the supported languages for the Windows Live Messenger IM Control.

Country/Region	Language	Culture code
Arabia	English	en-XA
Argentina	Spanish	es-AR
Australia	English	en-AU
Austria	German	de-AT
Belgium	Dutch	nl-BE
Belgium	French	fr-BE
Brazil	Portuguese (Brazilian)	pt-BR
Bulgaria	Bulgarian	bg-BG
Canada	English	en-CA
Canada	French	fr-CA
Chile	Spanish	es-CL
China	Chinese (Simplified)	zh-CN
Croatia	Croatian	hr-HR
Czech Republic	Czech	cs-CZ
Denmark	Danish	da-DK
Estonia	Estonian	et-EE
Finland	Finnish	fi-fi
France	French	fr-FR
Germany	German	de-DE
Greece	Greek	el-GR
Hong Kong \SAR	Chinese (Traditional)	zh-HK
Hungary	Hungarian	hu-HU
India	English	en-IN
Indonesia	English	en-ID
Ireland	English	en-IE
Italy	Italian	it-IT
Japan	Japanese	ja-JP
Korea	Korean	ko-KR
Latam ROR	Spanish	es-LA
Latvia	Latvian	lv-LV
Lithuania	Lithuanian	lt-LT
Malaysia	English	en-MY
Mexico	Spanish	es-MX
Netherlands	Dutch	nl-NL
New Zealand	English	en-NZ
Norway	Norwegian (Bokmal)	nb-NO
Philippines	English	en-PH
Poland	Polish	pl-PL
Portugal	Portuguese	pt-PT
Romania	Romanian	ro-RO
Russia	Russian	ru-RU
Serbia	Serbian-Latin	sr-latn-CS
Singapore	English	en-SG
Slovakia	Slovak	sk-SK
Slovenia	Slovenian	sl-SI
South Africa	English	en-ZA
Spain	Spanish	es-ES
Sweden	Swedish	sv-SE
Switzerland	French	fr-CH
Switzerland	German	de-CH
Taiwan	Chinese (Traditional)	zh-TW
Thailand	Thai	th-TH
Turkey	Turkish	tr-TR
UK	English	en-GB
Ukraine	Ukrainian	uk-UA
US	English	en-US
US	Spanish	es-US

Concepts

Hosting the Windows Live Messenger IM Control

Manage Your Profile | Legal | Contact Us | MSDN Flash Newsletter

Product Families

Resources

About Microsoft

Popular Places

Popular Searches

Popular Downloads

Concepts