Énumération InputScope (inputscope.h)

Article
08/24/2023

L’énumération InputScope contient des valeurs qui spécifient les étendues d’entrée qui sont appliquées à un champ donné.

Syntaxe

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;

Constantes

| | | ---- | | IS_DEFAULT
Valeur : 0
Indique le biais de reconnaissance standard. Traité comme valeur par défaut et utilise le lexique par défaut. Si elle est combinée à une autre étendue d’entrée, elle ne force pas la contrainte sur l’autre étendue d’entrée. | | IS_URL
Valeur : 1
Indique une URL, un fichier ou un format FTP. Les exemples suivants sont les suivants.

http://www.humongousinsurance.com/

ftp://ftp.microsoft.com

www.microsoft.com

file:///C:\templ.txt

| | IS_FILE_FULLFILEPATH
Valeur : 2
Indique un chemin d’accès au fichier. Les conditions suivantes sont appliquées.

Pour le nom du serveur et le nom du partage, autorise tous les caractères IS_ONECHAR sauf : * ? : <> |

Pour nom de fichier, autorise tous les caractères IS_ONECHAR sauf : \ / : <> |

L’entrée doit commencer par \ ou le nom du lecteur ou \ ou .. \ ou .\ ou /

Les espaces sont autorisés.

Les exemples suivants sont les suivants.

\servername\sharename\filename.txt

C :\temp\current work.doc

.. /images/hank.jpg

| | IS_FILE_FILENAME
Valeur : 3
Indique un nom de fichier. Les conditions suivantes sont appliquées.

Accepte l’extension ou l’absence d’extension.

Autorise tous les caractères IS_ONECHAR sauf : \ / : <> |

Les espaces sont autorisés.

En voici quelques exemples :

filename.txt

filename

fichier name.txt

| | IS_EMAIL_USERNAME
Valeur : 4
Indique les noms d’utilisateur de messagerie. Les exemples suivants sont les suivants.

jeffsm

JeffSm

Jsmith

JSmith

jeffsmith

| | IS_EMAIL_SMTPEMAILADDRESS
Valeur : 5
Indique une adresse de messagerie SMTP complète, par exemple. someone@example.com | | IS_LOGINNAME
Valeur : 6
Indique un nom de connexion et un domaine. Les conditions suivantes sont appliquées.

Autorise tous les caractères IS_ONECHAR.

Ne permet pas au domaine ou au nom d’utilisateur de commencer ou de se terminer par un caractère non alphanumérique.

Les espaces ne sont pas autorisés.

Les exemples suivants sont les suivants.

CHICAGO\JSMITH

JSMITH

| | IS_PERSONALNAME_FULLNAME
Valeur : 7
Indique une combinaison de prénoms, de prénoms et de noms. Voici quelques exemples, mis en forme pour l’anglais (États-Unis).

M. Jeff A. Smith, Jr.

Jeff Smith

Smith, Jeff

Smith, Jeff A

| | IS_PERSONALNAME_PREFIX
Valeur : 8
Indique un titre honorifique ou précédant un nom. Voici quelques exemples, mis en forme pour l’anglais (États-Unis).

Manquer

Monsieur

| | IS_PERSONALNAME_GIVENNAME
Valeur : 9
Indique un prénom ou une initiale. Voici quelques exemples, mis en forme pour l’anglais (États-Unis).

Jeff

JUGE.

| | IS_PERSONALNAME_MIDDLENAME
Valeur : 10
Indique un deuxième prénom ou une initiale. Les exemples suivants sont les suivants.

Albert

| | IS_PERSONALNAME_SURNAME
Valeur : 11
Indique un nom. Voici quelques exemples, mis en forme pour l’anglais (États-Unis).

Smith

Smith Jones

Smith-Jones

| | IS_PERSONALNAME_SUFFIX
Valeur : 12
Indique une abréviation de suffixe de nom ou des chiffres romains. Les exemples suivants sont les suivants.

| | IS_ADDRESS_FULLPOSTALADDRESS
Valeur : 13
Indique une adresse complète, y compris les nombres. Voici quelques exemples, mis en forme pour l’anglais (États-Unis).

123 Main Street, Anytown, WA 98989

Po Box 123 Anytown, WA 98989

| | IS_ADDRESS_POSTALCODE
Valeur : 14
Indique un code postal alphanumérique. La valeur est alphanumérique pour prendre en charge les codes postaux internationaux. Voici quelques exemples, mis en forme pour l’anglais (États-Unis).

98989

98989-1234

| | IS_ADDRESS_STREET
Valeur : 15
Indique un numéro de maison, un numéro de rue, un nom et un numéro d’appartement et/ou une boîte postale. Les exemples suivants sont les suivants.

123 Main Street

Case P.O. 1234

| | IS_ADDRESS_STATEORPROVINCE
Valeur : 16
Indique un nom complet ou une abréviation d’état ou de province. Voici quelques exemples, mis en forme pour l’anglais (États-Unis).

Washington

Attendez

| | IS_ADDRESS_CITY
Valeur : 17
Indique le nom ou l’abréviation d’une ville. Voici quelques exemples, mis en forme pour l’anglais (États-Unis).

New York

| | IS_ADDRESS_COUNTRYNAME
Valeur : 18
Indique le nom d’un pays/région. Voici quelques exemples, mis en forme pour l’anglais (États-Unis).

Italie

Japon

États-Unis d’Amérique

| | IS_ADDRESS_COUNTRYSHORTNAME
Valeur : 19
Indique l’abréviation du nom d’un pays/région. Voici quelques exemples, mis en forme pour l’anglais (États-Unis).

États-Unis

U.S.A.

| | IS_CURRENCY_AMOUNTANDSYMBOL
Valeur : 20
Indique les symboles et les nombres monétaires. Voici quelques exemples, mis en forme pour l’anglais (États-Unis).

2 100,25 $

0,35 $

1 234,50 $ USD

| | IS_CURRENCY_AMOUNT
Valeur : 21
Indique une valeur numérique pour la devise, à l’exclusion des symboles monétaires. Par exemple, 2 100.25. | | IS_DATE_FULLDATE
Valeur : 22
Indique une date complète, dans différents formats. Voici quelques exemples, mis en forme pour l’anglais (États-Unis).

07-17-2001

7/17/01

7/17

12 décembre

17 juillet

17 juillet 2001

| | IS_DATE_MONTH
Valeur : 23
Indique une représentation numérique de mois, limitée à 1-12. Les exemples suivants sont les suivants.

| | IS_DATE_DAY
Valeur : 24
Indique une représentation numérique de jours, limitée à 1-31. Les exemples suivants sont les suivants.

| | IS_DATE_YEAR
Valeur : 25
Indique une représentation numérique des années. Les exemples suivants sont les suivants.

1988

2004

| | IS_DATE_MONTHNAME
Valeur : 26
Indique une représentation de caractères de mois. Voici quelques exemples, mis en forme pour l’anglais (États-Unis).

Décembre

Déc

Dec.

| | IS_DATE_DAYNAME
Valeur : 27
Indique une représentation de caractères de jours. Voici quelques exemples, mis en forme pour l’anglais (États-Unis).

Mercredi

Mariés

Mariés.

| | IS_DIGITS
Valeur : 28
Indique des nombres entiers positifs, limités à 0-9. | | IS_NUMBER
Valeur : 29
Indique les nombres, y compris les virgules, le signe négatif et le décimal. Pour États-Unis emplacements, les conditions suivantes sont appliquées.

Le séparateur de milliers est une virgule.

Le séparateur décimal est un point.

Les nombres négatifs sont représentés avec un trait d’union sans espace, et non avec des parenthèses.

| | IS_ONECHAR
Valeur : 30
Indique un caractère ANSI unique, page de code 1252. Pour États-Unis emplacements, cela inclut les caractères suivants.

ABCDEFGHIJKLMNOPQRSTUVWXYZabcdEfghijklmnopqrstuvwxyz0123456789 ! » #$%&'()*+,-./ :;<=> ?@[]^_{|}~ | | IS_PASSWORD

<br>Value: *31*<br>Indicates a password. <b>IS_PASSWORD</b> is not supported and may be altered or unavailable in the future.<br><br><br><div class="alert"><b>Note</b>  <b>IS_PASSWORD</b> only indicates the password; it doesn't provide any security around the password. All passwords fields should have text services disabled to maintain password secrecy, and therefore it is not valid to have a password field with an <b>IS_PASSWORD</b> input scope.</div><br><div> </div> | |

IS_TELEPHONE_FULLTELEPHONENUMBER

<br>Value: *32*<br>Indicates a telephone number. Alphabetical input is not allowed. Examples include the following, formatted for English (United States).<br><br><ul><br><li>(206) 555-0123</li><br><li>555-0123</li><br><li>555.0123</li><br><li>206-555-0123</li><br><li>1-206-555-0123x1234</li><br><li>+1 (206) 555-1234</li><br></ul> | |

IS_TELEPHONE_COUNTRYCODE

<br>Value: *33*<br>Indicates telephone country codes. Examples include the following, formatted for English (United States).<br><br><ul><br><li>+1</li><br><li>+44</li><br><li>001</li><br><li>00 44</li><br></ul> | |

IS_TELEPHONE_AREACODE

<br>Value: *34*<br>Indicates telephone area codes. Examples include the following, formatted for English (United States).<br><br><ul><br><li>(206)</li><br><li>206</li><br></ul> | |

IS_TELEPHONE_LOCALNUMBER IS_TIME_FULLTIME

<br>Value: *35*<br>Indicates a telephone number, excluding country or area code. Examples include the following, formatted for English (United States).<br><br><ul><br><li>555-0123</li><br><li>555 0123</li><br><li>555.0123</li><br></ul> | |

<br>Value: *36*<br>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).<br><br><ul><br><li>3:20</li><br><li>04:30</li><br><li>11:20:55</li><br><li>11:15 am</li><br><li>4:30 AM</li><br></ul> | |

IS_TIME_HOUR IS_TIME_FULLTIME IS_TIME_MINORSEC Value: *37* Indicates a numeric representation of hours, constrained to 0-24. | |  Value: *38* Indicates a numeric representation of minutes or seconds, constrained to 0-59. | | IS_NUMBER_FULLWIDTH

<br>Value: *39*<br>Indicates full-width number, used for Japanese only. Constrained to full-width numbers and Kanji numbers. | |

IS_ALPHANUMERIC_HALFWIDTH

<br>Value: *40*<br>Indicates half-width alphanumeric characters for East-Asian languages, constrained to half-width alphabetical characters and numbers. | |

IS_ALPHANUMERIC_FULLWIDTH

<br>Value: *41*<br>Indicates full-width alphanumeric characters for East-Asian languages, constrained to full-width alphabet characters and numbers. | |

IS_CURRENCY_CHINESE Value: *42* Indicates Chinese currency. | | IS_BOPOMOFO Value: *43* Indicates Bopomofo characters. | | IS_HIRAGANA Value: *44* Indicates Hiragana characters. | | IS_KATAKANA_HALFWIDTH Value: *45* Indicates half-width Katakana characters. | | IS_KATAKANA_FULLWIDTH Value: *46* Indicates full-width Katakana characters. | | IS_HANJA Value: *47* Indicates Hanja characters. | | IS_HANGUL_HALFWIDTH Value: *48* Indicates half-width Hangul characters. | |  Value: *49* Indicates full-width Hangul characters. | | IS_HANGUL_FULLWIDTH Value: *50* Starting with Windows 8: Indicates a search string. | | IS_SEARCH IS_FORMULA Value: *51* Starting with Windows 8: Indicates a formula control, for example, a spreadsheet field. | | IS_SEARCH_INCREMENTAL

<br>Value: *52*<br><b>Starting with Windows 10:</b> Indicates input scope is intended for search boxes where incremental results are displayed as the user types. | |

IS_CHINESE_HALFWIDTH IS_CHINESE_FULLWIDTH

<br>Value: *54*<br><b>Starting with Windows 10:</b> Indicates input scope is intended for Chinese full-width characters. | |

<br>Value: *53*<br><b>Starting with Windows 10:</b> Indicates input scope is intended for Chinese half-width characters. | |

IS_NATIVE_SCRIPT Value: *55* Starting with Windows 10: Indicates input scope is intended for native script. | | IS_YOMI IS_TEXT Value: *56* Starting with Windows 10: Indicates input scope is intended for Japanese names. | |  Value: *57* Starting with Windows 10: Indicates input scope is intended for working with text. | |  Value: *58* Starting with Windows 10: Indicates input scope is intended for chat strings. | | IS_CHAT IS_NAME_OR_PHONENUMBER IS_EMAILNAME_OR_ADDRESS

<br>Value: *59*<br><b>Starting with Windows 10:</b> Indicates input scope is intended for working with a name or telephone number. | |

<br>Value: *60*<br><b>Starting with Windows 10:</b> Indicates input scope is intended for working with an email name or full email address. | |

IS_EMAILNAME_OR_ADDRESS IS_PRIVATE IS_EMAILNAME_OR_ADDRESS

<br>Value: *61*<br><b>Starting with Windows 10:</b> Indicates input scope is intended for working with private data. | |

IS_MAPS

<br>Value: *62*<br><b>Starting with Windows 10:</b> Indicates input scope is intended for working with a map location. | |

IS_NUMERIC_PIN IS_NUMERIC_PASSWORD Value: *64* Starting with Windows 10: Indicates expected input is a numeric PIN. | |  Value: *65* Starting with Windows 10: Indicates expected input is an alphanumeric PIN. | |  Value: *63* Starting with Windows 10: Indicates expected input is a numeric password, or PIN. | | IS_ALPHANUMERIC_PIN IS_ALPHANUMERIC_PIN_SET

<br>Value: *66*<br><b>Starting with Windows 10:</b> Indicates expected input is an alphanumeric PIN for lock screen. | |

 Value: *67* Starting with Windows 10: Indicates expected input is a mathematical formula. | |  Value: *68* Starting with Windows 10: Indicates expected input does not include emoji. | |  Value: *-1* Indicates a phrase list. | | IS_FORMULA_NUMBER IS_CHAT_WITHOUT_EMOJI IS_PHRASELIST IS_REGULAREXPRESSION Value: *-2* Indicates a regular expression. | |

<br>Value: *-3*<br>Indicates an XML string that conforms to the Speech Recognition Grammar Specification (SRGS) standard. Information on SRGS can be found at <a href="https://www.w3.org/tr/speech-grammar">http://www.w3.org/TR/speech-grammar</a>. | |

IS_SRGS Value: *-4* Indicates a custom xml string. | | IS_XML IS_ENUMSTRING'
Valeur : -5
L’étendue contient le pointeur d’interface IEnumString. Le processeur d’entrée de texte (TIP) peut appeler ITfInputScope2 ::EnumWordList pour le récupérer. |

Remarques

La prise en charge d’une valeur d’étendue d’entrée donnée peut varier d’une technologie à l’autre.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
En-tête	inputscope.h

Voir aussi

Partager via