InputScope 列舉(inputscope.h)

InputScope 列舉包含指定對特定欄位套用哪些輸入範圍的值。

語法

typedef enum __MIDL___MIDL_itf_inputscope_0000_0000_0001 {
  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 = 21,
  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_HANGUL_HALFWIDTH = 48,
  IS_HANGUL_FULLWIDTH = 49,
  IS_SEARCH = 50,
  IS_FORMULA = 51,
  IS_SEARCH_INCREMENTAL = 52,
  IS_CHINESE_HALFWIDTH = 53,
  IS_CHINESE_FULLWIDTH = 54,
  IS_NATIVE_SCRIPT = 55,
  IS_YOMI = 56,
  IS_TEXT = 57,
  IS_CHAT = 58,
  IS_NAME_OR_PHONENUMBER = 59,
  IS_EMAILNAME_OR_ADDRESS = 60,
  IS_PRIVATE = 61,
  IS_MAPS = 62,
  IS_NUMERIC_PASSWORD = 63,
  IS_NUMERIC_PIN = 64,
  IS_ALPHANUMERIC_PIN = 65,
  IS_ALPHANUMERIC_PIN_SET = 66,
  IS_FORMULA_NUMBER = 67,
  IS_CHAT_WITHOUT_EMOJI = 68,
  IS_PHRASELIST = -1,
  IS_REGULAREXPRESSION = -2,
  IS_SRGS = -3,
  IS_XML = -4,
  IS_ENUMSTRING = -5
} InputScope;

Constants

 
IS_DEFAULT
值:0
顯示標準識別偏差。 視為預設,使用預設詞彙。 若與另一個輸入範圍結合,則不會強制另一個輸入範圍強制使用。
IS_URL
值: 1
表示 URL、檔案或 FTP 格式。 以下例子包括:


  • http://www.humongousinsurance.com/

  • ftp://ftp.microsoft.com

  • www.microsoft.com

  • file:///C:\templ.txt

  • $

IS_FILE_FULLFILEPATH
值: 2
表示檔案路徑。 以下條件會被執行。


  • 伺服器名稱和共享名稱允許IS_ONECHAR所有字元,除了:* ? : <> |

  • 對於檔名,允許除:\ / : <> | 以外的所有IS_ONECHAR字元。

  • 輸入必須以 \ 或 磁碟機名稱開頭,或是 \ 或 ..\ 或 .\ 或 /

  • 允許有空位。


以下例子包括:


  • \servername\sharename\filename.txt

  • C:\temp\current work.doc

  • ../圖片/hank.jpg

IS_FILE_FILENAME
值: 3
表示一個檔案名稱。 以下條件會被執行。


  • 接受延長或不延長。

  • 允許除:\ / : <> | 以外的所有IS_ONECHAR字元

  • 允許有空位。


範例包括下列:


  • filename.txt

  • filename

  • 檔案 name.txt

IS_EMAIL_USERNAME
值: 4
表示電子郵件使用者名稱。 以下例子包括:


  • 傑夫斯

  • JeffSm

  • 史密斯

  • JSmith

  • 傑夫史密斯

IS_EMAIL_SMTPEMAILADDRESS
值: 5
表示完整的 SMTP 電子郵件地址,例如。 someone@example.com
IS_LOGINNAME
值: 6
表示登入名稱和網域。 以下條件會被執行。


  • 允許所有IS_ONECHAR角色。

  • 不允許網域或使用者名稱以非字母數字字元開頭或結尾。

  • 不允許有空位。


以下例子包括:


  • 芝加哥\JSMITH

  • JSMITH

IS_PERSONALNAME_FULLNAME
值: 7
表示名字、中間名和姓氏的組合。 以下範例為英語格式(美國)。


  • 傑夫·A·史密斯先生 Jr.

  • 傑夫·史密斯

  • 史密斯,傑夫

  • 史密斯,傑夫·A

IS_PERSONALNAME_PREFIX
值: 8
表示名字前有尊稱或頭銜。 以下範例為英語格式(美國)。


  • 先生。

  • 博士。

  • 小姐

  • 長官

IS_PERSONALNAME_GIVENNAME
值: 9
表示名字或姓名縮寫。 以下範例為英語格式(美國)。


  • 傑夫

  • J.

  • J.A.

IS_PERSONALNAME_MIDDLENAME
值: 10
表示中間名或姓名縮寫。 以下例子包括:


  • 阿爾伯特

  • A。

IS_PERSONALNAME_SURNAME
值: 11
表示姓氏。 以下範例為英語格式(美國)。


  • 史密斯

  • 史密斯·瓊斯

  • Smith-Jones

IS_PERSONALNAME_SUFFIX
值: 12
表示姓名後綴縮寫或羅馬數字。 以下例子包括:


  • Jr.


IS_ADDRESS_FULLPOSTALADDRESS
價值: 13
表示完整地址,包括電話號碼。 以下範例為英語格式(美國)。


  • 123 Main Street, Anytown, WA 98989

  • 郵政信箱123號 Anytown, WA 98989

IS_ADDRESS_POSTALCODE
價值: 14
表示字母數字郵遞區號。 數值為字母數字,以支援國際郵遞區號。 以下範例為英語格式(美國)。


  • 98989

  • 98989-1234

IS_ADDRESS_STREET
價值: 15
表示門牌號碼、門牌號碼、公寓名稱及門牌號碼,以及/或郵箱。 以下例子包括:


  • 主街123號

  • 郵政信箱1234

IS_ADDRESS_STATEORPROVINCE
價值: 16
表示州或省的全名或縮寫。 以下範例為英語格式(美國)。


  • WA

  • 華盛頓州


IS_ADDRESS_CITY
價值: 17
表示城市名稱或縮寫。 以下範例為英語格式(美國)。


  • 紐約

  • 紐約市

IS_ADDRESS_COUNTRYNAME
值: 18
表示國家/地區名稱。 以下範例為英語格式(美國)。


  • 義大利

  • 日本

  • 美國

IS_ADDRESS_COUNTRYSHORTNAME
價值: 19
表示國家/地區名稱的縮寫。 以下範例為英語格式(美國)。


  • 美國

  • 美國

IS_CURRENCY_AMOUNTANDSYMBOL
價值: 20
表示貨幣符號與數字。 以下範例為英語格式(美國)。


  • $2,100.25

  • 0.35美元

  • 1,234.50美元

IS_CURRENCY_AMOUNT
值: 21
表示貨幣的數值,不包含貨幣符號。 例如,2,100.25。
IS_DATE_FULLDATE
值: 22
表示完整日期,格式多樣。 以下範例為英語格式(美國)。


  • 07-17-2001

  • 7/17/01

  • 7/17

  • 12月12日

  • 7 月 17 日

  • 2001年7月17日

IS_DATE_MONTH
價值: 23
表示月份的數字表示,限制在1到12之間。 以下例子包括:


  • 7

  • 07

  • 11

IS_DATE_DAY
價值: 24
表示天數的數字表示,限制在1到31之間。 以下例子包括:


  • 1

  • 04

  • 17

IS_DATE_YEAR
價值: 25
表示年份的數字表示。 以下例子包括:


  • 1988

  • 2004

  • 88

  • 04

  • '88

IS_DATE_MONTHNAME
價值: 26
表示月份的字元表示。 以下範例為英語格式(美國)。


  • 十二月

  • 12 月

  • 十二月。

IS_DATE_DAYNAME
價值: 27
表示天的字元表示。 以下範例為英語格式(美國)。


  • 星期三

  • 週三

  • 星期三。

IS_DIGITS
價值: 28
表示正整數,限制在0到9之間。
IS_NUMBER
價值: 29
表示數字,包括逗號、負號和小數點。 在美國地區,執行以下條件。


  • 千分隔符是逗號。

  • 十進位分隔符是句點。

  • 負數則用無空格的連字號表示,而非括號。

IS_ONECHAR
價值: 30
表示單一 ANSI 字元,代碼頁 1252。 針對美國地區,這包括以下字元。

ABCDEFGHIJKLMNOPQRSTUVWXYZabcdEfghijklmnopqrstuvwxyz0123456789!”#$%&'()*+,-./:;<=>?@[\]^_'{|}~
IS_PASSWORD
價值: 31
表示密碼。 IS_PASSWORD 不支援,未來可能會被更改或無法使用。


請注意IS_PASSWORD 僅表示密碼;它對密碼沒有任何安全性保障。 所有密碼欄位都應關閉文字服務以維持密碼保密,因此密碼欄位不適合有 IS_PASSWORD 輸入範圍。

 
IS_TELEPHONE_FULLTELEPHONENUMBER
價值: 32
表示電話號碼。 不允許按字母順序輸入。 以下範例為英語格式(美國)。


  • (206) 555-0123

  • 555-0123

  • 555.0123

  • 206-555-0123

  • 1-206-555-0123x1234

  • +1 (206) 555-1234

IS_TELEPHONE_COUNTRYCODE
價值: 33
表示電話國家代碼。 以下範例為英語格式(美國)。


  • 1+

  • +44

  • 001

  • 00 44

IS_TELEPHONE_AREACODE
價值: 34
表示電話區碼。 以下範例為英語格式(美國)。


  • (206)

  • 206

IS_TELEPHONE_LOCALNUMBER
價值: 35
表示電話號碼,不含國家或區碼。 以下範例為英語格式(美國)。


  • 555-0123

  • 555 0123

  • 555.0123

IS_TIME_FULLTIME
價值: 36
表示時、分、秒及字母時間縮寫。 美式英語使用12小時制。 前導零可選於小時內,但在分鐘和秒內必須。 工時限制為0-24;分鐘和秒數限制在0-59之間。 以下範例為英語格式(美國)。


  • 3:20

  • 04:30

  • 11:20:55

  • 上午11:15

  • 凌晨4:30

IS_TIME_HOUR
價值: 37
表示小時數值的數字表示,限制在0-24之間。
IS_TIME_MINORSEC
價值: 38
表示分鐘或秒的數字表示,限制在0-59。
IS_NUMBER_FULLWIDTH
價值: 39
表示全寬號碼,僅用於日語。 限制於全寬數字與漢字數字。
IS_ALPHANUMERIC_HALFWIDTH
價值: 40
表示 East-Asian 語言的半寬字母數字字元,限制於半寬字母字母和數字。
IS_ALPHANUMERIC_FULLWIDTH
價值: 41
表示 East-Asian 語言的全寬字母數字字元,限制於全寬字母表字元與數字。
IS_CURRENCY_CHINESE
價值: 42
表示中國貨幣。
IS_BOPOMOFO
價值: 43
表示 Bopomofo 字元。
IS_HIRAGANA
價值: 44
表示平假名角色。
IS_KATAKANA_HALFWIDTH
價值: 45
表示半寬片假名字。
IS_KATAKANA_FULLWIDTH
價值: 46
表示寬度片假名字元。
IS_HANJA
價值: 47
表示漢字字。
IS_HANGUL_HALFWIDTH
值: 48
表示半寬的韓文字符。
IS_HANGUL_FULLWIDTH
值: 49
表示全寬漢字。
IS_SEARCH
價值: 50
從 Windows 8 開始: 表示搜尋字串。
IS_FORMULA
值: 51
從 Windows 8 開始: 表示公式控制項,例如試算表欄位。
IS_SEARCH_INCREMENTAL
價值: 52
從 Windows 10 開始: 表示輸入範圍是用於搜尋框,使用者輸入時會顯示增量結果。
IS_CHINESE_HALFWIDTH
價值: 53
從 Windows 10 開始: 表示輸入範圍是針對中文半寬字元設計的。
IS_CHINESE_FULLWIDTH
價值: 54
從 Windows 10 開始: 表示輸入範圍是針對中文全寬字元設計的。
IS_NATIVE_SCRIPT
價值: 55
從 Windows 10 開始: 表示輸入範圍是為原生腳本設計的。
IS_YOMI
價值: 56
從 Windows 10 開始: 表示輸入範圍是針對日文名稱設計的。
IS_TEXT
值: 57
從 Windows 10 開始: 表示輸入範圍是用於處理文字的。
IS_CHAT
價值: 58
從 Windows 10 開始: 表示輸入範圍是針對聊天串設計的。
IS_NAME_OR_PHONENUMBER
價值: 59
從 Windows 10 開始: 表示輸入範圍是用來處理姓名或電話號碼的。
IS_EMAILNAME_OR_ADDRESS
價值: 60
從 Windows 10 開始: 表示輸入範圍適用於使用電子郵件名稱或完整電子郵件地址。
IS_PRIVATE
價值: 61
從 Windows 10 開始: 表示輸入範圍是用於處理私人資料的。
IS_MAPS
價值: 62
從 Windows 10 開始: 表示輸入範圍是用於處理地圖位置的。
IS_NUMERIC_PASSWORD
價值: 63
從 Windows 10 開始: 表示預期輸入是數字密碼(PIN)。
IS_NUMERIC_PIN
值: 64
從 Windows 10 開始: 表示預期輸入為數字 PIN。
IS_ALPHANUMERIC_PIN
價值: 65
從 Windows 10 開始: 表示預期輸入為字母數字 PIN。
IS_ALPHANUMERIC_PIN_SET
價值: 66
從 Windows 10 開始: 表示預期輸入是鎖定畫面的字母數字 PIN。
IS_FORMULA_NUMBER
價值: 67
從 Windows 10 開始: 表示期望輸入是一個數學公式。
IS_CHAT_WITHOUT_EMOJI
價值: 68
從 Windows 10 開始: 表示預期輸入不包含表情符號。
IS_PHRASELIST
數值: -1
表示片語清單。
IS_REGULAREXPRESSION
數值: -2
表示一個正則表達式。
IS_SRGS
數值: -3
表示符合語音辨識文法規範(SRGS)標準的 XML 字串。 有關SRGS的資訊可於 http://www.w3.org/TR/speech-grammar
IS_XML
數值: -4
表示自訂的 XML 字串。
IS_ENUMSTRING
數值: -5
作用域包含 IEnumString 介面指標。 文字輸入處理器(TIP)可以呼叫 ITfInputScope2::EnumWordList 來擷取該資料。

備註

是否支援某一輸入範圍值,可能因技術而異。

需求

Requirement 價值觀
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
支援的最低伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
Header inputscope.h

另請參閱

ITfInputScope

SetInputScope

SetInputScopeXML

SetInputScopes