InputScope Enumeration (Windows)

InputScope Enumeration

The InputScope enumeration contains values that specify which input scope(s) are applied to a given field.

Syntax

typedef enum tagInputScope {
  IS_DEFAULT                         = 0,
  IS_URL                             = 1,
  IS_FILE_FULLFILEPATH               = 2,
  IS_FILE_FILENAME                   = 3,
  IS_EMAIL_USERNAME                  = 4,
  IS_EMAIL_SMTPEMAILADDRESS          = 5,
  IS_LOGINNAME                       = 6,
  IS_PERSONALNAME_FULLNAME           = 7,
  IS_PERSONALNAME_PREFIX             = 8,
  IS_PERSONALNAME_GIVENNAME          = 9,
  IS_PERSONALNAME_MIDDLENAME         = 10,
  IS_PERSONALNAME_SURNAME            = 11,
  IS_PERSONALNAME_SUFFIX             = 12,
  IS_ADDRESS_FULLPOSTALADDRESS       = 13,
  IS_ADDRESS_POSTALCODE              = 14,
  IS_ADDRESS_STREET                  = 15,
  IS_ADDRESS_STATEORPROVINCE         = 16,
  IS_ADDRESS_CITY                    = 17,
  IS_ADDRESS_COUNTRYNAME             = 18,
  IS_ADDRESS_COUNTRYSHORTNAME        = 19,
  IS_CURRENCY_AMOUNTANDSYMBOL        = 20,
  IS_CURRENCY_AMOUNT                 = ANDSYMBOL 20,
  IS_DATE_FULLDATE                   = 22,
  IS_DATE_MONTH                      = 23,
  IS_DATE_DAY                        = 24,
  IS_DATE_YEAR                       = 25,
  IS_DATE_MONTHNAME                  = 26,
  IS_DATE_DAYNAME                    = 27,
  IS_DIGITS                          = 28,
  IS_NUMBER                          = 29,
  IS_ONECHAR                         = 30,
  IS_PASSWORD                        = 31,
  IS_TELEPHONE_FULLTELEPHONENUMBER   = 32,
  IS_TELEPHONE_COUNTRYCODE           = 33,
  IS_TELEPHONE_AREACODE              = 34,
  IS_TELEPHONE_LOCALNUMBER           = 35,
  IS_TIME_FULLTIME                   = 36,
  IS_TIME_HOUR                       = 37,
  IS_TIME_MINORSEC                   = 38,
  IS_NUMBER_FULLWIDTH                = 39,
  IS_ALPHANUMERIC_HALFWIDTH          = 40,
  IS_ALPHANUMERIC_FULLWIDTH          = 41,
  IS_CURRENCY_CHINESE                = 42,
  IS_BOPOMOFO                        = 43,
  IS_HIRAGANA                        = 44,
  IS_KATAKANA_HALFWIDTH              = 45,
  IS_KATAKANA_FULLWIDTH              = 46,
  IS_HANJA                           = 47,
  IS_PHRASELIST                      = -1,
  IS_REGULAREXPRESSION               = -2,
  IS_SRGS                            = -3,
  $,
  IS_XML                             = -4,
  IS_ENUMSTRING                      = -5 
} InputScope;

Constants

IS_DEFAULT

Indicates the standard recognition bias. Treated as default and utilizes the default lexicon. If combined with another input scope, it does not force coercion on the other input scope.

IS_URL

Indicates a URL, File, or FTP format. Examples include the following.

http://www.humongousinsurance.com/
ftp://ftp.microsoft.com
www.microsoft.com
file:///C:\templ.txt
$

IS_FILE_FULLFILEPATH

Indicates a file path. The following conditions are enforced.

For server name and share name, allows all IS_ONECHAR characters except: * ? : < > |
For file name, allows all IS_ONECHAR characters except: \ / : < > |
Input must start with \\ or drive name or \ or ..\ or .\ or /
Spaces are allowed.

Examples include the following.

\\servername\sharename\filename.txt
C:\temp\current work.doc
../images/hank.jpg

IS_FILE_FILENAME

Indicates a file name. The following conditions are enforced.

Accepts either extension or no extension.
Allows all IS_ONECHAR characters except: \ / : < > |
Spaces are allowed.

Examples include the following.

filename.txt
filename
file name.txt

IS_EMAIL_USERNAME

Indicates E-mail user names. Examples include the following.

jeffsm
JeffSm
Jsmith
JSmith
jeffsmith

IS_EMAIL_SMTPEMAILADDRESS

Indicates a complete SMTP e-mail address. For example, someone@example.com.

IS_LOGINNAME

Indicates a log-in name and domain. The following conditions are enforced.

Allows all IS_ONECHAR characters.
Does not allow domain or username to start or end in a non-alphanumeric character.
Spaces are not allowed.

Examples include the following.

CHICAGO\JSMITH
JSMITH

IS_PERSONALNAME_FULLNAME

Indicates a combination of first, middle, and last names. Examples include the following, formatted for English (United States).

Mr. Jeff A. Smith, Jr.
Jeff Smith
Smith, Jeff
Smith, Jeff A

IS_PERSONALNAME_PREFIX

Indicates a honorific or title preceding a name. Examples include the following, formatted for English (United States).

Mr.
Dr.
Miss
Sir

IS_PERSONALNAME_GIVENNAME

Indicates a first name or initial. Examples include the following, formatted for English (United States).

Jeff
J.
J.A.

IS_PERSONALNAME_MIDDLENAME

Indicates a middle name or initial. Examples include the following.

Albert
A.

IS_PERSONALNAME_SURNAME

Indicates a last name. Examples include the following, formatted for English (United States).

Smith
Smith Jones
Smith-Jones

IS_PERSONALNAME_SUFFIX

Indicates a name suffix abbreviation or Roman numerals. Examples include the following.

IS_ADDRESS_FULLPOSTALADDRESS

Indicates a full address, including numbers. Examples include the following, formatted for English (United States).

123 Main Street, Anytown, WA 98989
PO Box 123 Anytown, WA 98989

IS_ADDRESS_POSTALCODE

Indicates an alphanumeric postal code. The value is alphanumeric to support international zip codes. Examples include the following, formatted for English (United States).

98989
98989-1234

IS_ADDRESS_STREET

Indicates a house number, street number, apartment name and number, and/or postal box. Examples include the following.

123 Main Street
P.O. Box 1234

IS_ADDRESS_STATEORPROVINCE

Indicates a full name or abbreviation of state or province. Examples include the following, formatted for English (United States).

WA
Washington
Wa

IS_ADDRESS_CITY

Indicates the name or abbreviation of a city. Examples include the following, formatted for English (United States).

New York
NYC

IS_ADDRESS_COUNTRYNAME

Indicates the name of a country. Examples include the following, formatted for English (United States).

Italy
Japan
United States of America

IS_ADDRESS_COUNTRYSHORTNAME

Indicates the abbreviation a the name of a country. Examples include the following, formatted for English (United States).

USA
U.S.A.

IS_CURRENCY_AMOUNTANDSYMBOL

Indicates currency symbols and numbers. Examples include the following, formatted for English (United States).

$ 2,100.25
$.35
$1,234.50 USD

IS_CURRENCY_AMOUNT

Indicates a numeric value for currency, excluding currency symbols. For example, 2,100.25.

IS_DATE_FULLDATE

Indicates a full date, in a variety of formats. Examples include the following, formatted for English (United States).

07-17-2001
7/17/01
7/17
Dec. 12
July 17
July 17, 2001

IS_DATE_MONTH

Indicates a numeric representation of months, constrained to 1-12. Examples include the following.

IS_DATE_DAY

Indicates a numeric representation of days, constrained to 1-31. Examples include the following.

IS_DATE_YEAR

Indicates a numeric representation of years. Examples include the following.

1988
2004
88
04
'88

IS_DATE_MONTHNAME

Indicates a character representation of months. Examples include the following, formatted for English (United States).

December
Dec
Dec.

IS_DATE_DAYNAME

Indicates a character representation of days. Examples include the following, formatted for English (United States).

Wednesday
Weds
Weds.

IS_DIGITS

Indicates positive whole numbers, constrained to 0-9.

IS_NUMBER

Indicates numbers, including commas, negative sign, and decimal. For United States locations, the following conditions are enforced.

The thousand separator is a comma.
The decimal separator is a period.
Negative numbers are represented with a hyphen without a space, not with parentheses.

IS_ONECHAR

Indicates a single ANSI character, codepage 1252. For United States locations, this includes the following characters.ABCDEFGHIJKLMNOPQRSTUVWXYZabcdEfghijklmnopqrstuvwxyz0123456789!\"#$%&'()*+,-./:;<=>?@[\]^_`{|}~

IS_PASSWORD

Indicates a password.

IS_TELEPHONE_FULLTELEPHONENUMBER

Indicates a telephone number. Alphabetical input is not allowed. Examples include the following, formatted for English (United States).

(206) 555-0123
555-0123
555.0123
206-555-0123
1-206-555-0123x1234
+1 (206) 555-1234

IS_TELEPHONE_COUNTRYCODE

Indicates telephone country codes. Examples include the following, formatted for English (United States).

+1
+44
001
00 44

IS_TELEPHONE_AREACODE

Indicates telephone area codes. Examples include the following, formatted for English (United States).

(206)
206

IS_TELEPHONE_LOCALNUMBER

Indicates a telephone number, excluding country or area code. Examples include the following, formatted for English (United States).

555-0123
555 0123
555.0123

IS_TIME_FULLTIME

Indicates hours, minutes, seconds, and alphabetical time abbreviations. US English uses the 12 hour clock. Leading zeros are optional for hours but required for minutes and seconds. Hours are constrained to 0-24; minutes and seconds are constrained to 0-59. Examples include the following, formatted for English (United States).

3:20
04:30
11:20:55
11:15 am
4:30 AM

IS_TIME_HOUR

Indicates a numeric representation of hours, constrained to 0-24.

IS_TIME_MINORSEC

Indicates a numeric representation of minutes or seconds, constrained to 0-59.

IS_NUMBER_FULLWIDTH

Indicates full-width number, used for Japanese only. Constrained to full-width numbers and Kanji numbers.

IS_ALPHANUMERIC_HALFWIDTH

Indicates half-width alphanumeric characters for East-Asian languages, constrained to half-width alphabetical characters and numbers.

IS_ALPHANUMERIC_FULLWIDTH

Indicates full-width alphanumeric characters for East-Asian languages, constrained to full-width alphabet characters and numbers.

IS_CURRENCY_CHINESE

Indicates Chinese currency.

IS_BOPOMOFO

Indicates Bopomofo characters.

IS_HIRAGANA

Indicates Hiragana characters.

IS_KATAKANA_HALFWIDTH

Indicates half-width Katakana characters.

IS_KATAKANA_FULLWIDTH

Indicates full-width Katakana characters.

IS_HANJA

Indicates Hanja characters.

IS_PHRASELIST

Indicates a phrase list.

IS_REGULAREXPRESSION

Indicates a regular expression.

IS_SRGS

Indicates an XML string that conforms to the Speech Recognition Grammar Specification (SRGS) standard. Information on SRGS can be found at http://www.w3.org/TR/speech-grammar.

$

Indicates a custom xml string.

IS_XML

Indicates a custom xml string.

IS_ENUMSTRING

The scope contains the IEnumString interface pointer. TIP can call ITfInputScope2::EnumWordList to retrieve it.

Remarks

Whether a given input scope value is supported can vary across technologies.

Requirements

Minimum supported client	Windows XP
Minimum supported server	Windows Server 2003
Header	InputScope.idl and InputScope.h

Syntax

Constants

Remarks

Requirements

See Also