How the TextBox InputScope Affects the Windows Phone SIP (On-Screen Keyboard)


When writing a Windows Phone 7 application in Silverlight, you will find a property on every TextBox control called “InputScope.” The primary use of this property is to alter the way the Software Input Panel (SIP or on-screen keyboard) works. Depending on what you set its value to, the SIP will include certain character sets, auto-complete features, and can auto-capitalize phrases and words for you. There’s no question you should be using this built-in feature. However, sometimes it’s hard to remember what each value of the InputScopeNameValue Enumeration actually does.

As it turns out, Microsoft lists only 10 modes the SIP can be put into. Below, you will find a screenshot of each and a list of the InputScope values associated with each.

[more]

Default

If the InputScope is not specified, this is the SIP that is used. You get a standard layout with no auto-complete help at the top.

InputScope values: Default, PhraseList, RegularExpression, Srgs, Xml, EnumString, FullFilePath, FileName, LogOnName, PersonalFullName, PersonalNamePrefix, PersonalGivenName, PersonalMiddleName, PersonalSurname, PersonalNameSuffix, AddressStateOrProvince, AddressCity, AddressCountryName, AddressCountryShortName, OneChar, Password, NumberFullWidth, AlphanumericHalfWidth, AlphaNumericFullWidth, CurrencyChinese, Bopomofo, Hiragana, KatakanaHalfWidth, KatakanaFullWidth, Hanja, Yomi, Private (causes a non-functioning auto-complete bar to show at the top of the SIP)

InputScope values starting in numeric / symbol mode: PostalAddress, PostalCode, AddressStreet, CurrencyAmountAndSymbol, CurrencyAmount, DateMonth, DateDay, DateYear, Digits, Number, Time, TimeHour, TimeMinorSec

InputScope values starting in text mode with first letter capitalization: DateMonthName, Date

Default_4-3-2011_22.25.47.11 Default_4-3-2011_22.25.55.529

Text

This SIP layout is nearly the same as the Default layout. However, it comes with an emoticon button, auto-correct bar (on top) and auto-capitalization for the first word of a sentence.

InputScope values: Text

Text_4-3-2011_22.32.48.456 Text_4-3-2011_22.32.57.391

Web

Also similar to the Default layout, a “.com” button is added along with a highlighted Enter button.

InputScope values: Url

Web_4-3-2011_22.34.30.82 Web_4-3-2011_22.35.8.75

E-mail address

Adding the “.com” and “@” buttons to the default layout, this layout is used for email address entry.

InputScope values: EmailSmtpAddress, EmailUserName

EmailAddress_4-3-2011_22.38.31.220 EmailAddress_4-3-2011_22.38.39.50

E-mail name or address

This layout is listed separately from the “E-mail address” layout, but seems to be identical in every way.

InputScope values: EmailNameOrAddress

EmailNameOrAddress_4-3-2011_22.40.25.711 EmailNameOrAddress_4-3-2011_22.40.37.126

Maps

The Maps layout is suppose to be used for entering location information (coordinates or city, state combinations). It includes a prominent comma button, auto-complete features, and a highlighted Enter key.

InputScope values: Maps, ApplicationEnd

Maps_4-3-2011_22.41.52.589 Maps_4-3-2011_22.41.58.187

Phone number

This layout is a standard 12-key telephone pad (0 – 9, *, and #) with the addition of Backspace, Space, Comma, and Period.

InputScope values: TelephoneNumber, TelephoneCountryCode, TelephoneAreaCode, TelephoneLocalNumber

PhoneNumber_4-3-2011_22.44.23.581

Search

This is nearly the same as the Default layout, but also includes a highlighted Enter key.

InputScope values: Search

Search_4-3-2011_22.45.23.466 Search_4-3-2011_22.45.30.873

SMS contact

Take the Default layout, add access to the 12-key telephone pad (123 button), the “@” key, and a semicolon.

InputScope values: NameOrPhoneNumber

SMSContact_4-3-2011_22.47.18.853 SMSContact_4-3-2011_22.47.24.355

Chat

This layout is listed separately from the “Text” layout, but seems identical to the Text layout.

InputScope values: Chat

Chat_4-3-2011_22.49.54.620 Chat_4-3-2011_22.49.59.387

One thing I should bring up is that I did not try the keyboard in all language modes. (If you hit the “En” button you can switch languages) However, it does appear the above lists are consistent across languages, as well. I tested this in English (United States). If you spot an error, please let me know and I’ll update the post.