Enumeração InputScope (inputscope.h)

Artigo
08/24/2023

A enumeração InputScope contém valores que especificam quais escopos de entrada são aplicados a um determinado campo.

Syntax

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
Valor: 0
Indica o viés de reconhecimento padrão. Tratado como padrão e usa o léxico padrão. Se combinado com outro escopo de entrada, ele não força a coerção no outro escopo de entrada. | | IS_URL
Valor: 1
Indica um formato DE URL, Arquivo ou FTP. Os exemplos incluem o seguinte.

http://www.humongousinsurance.com/

ftp://ftp.microsoft.com

www.microsoft.com

file:///C:\templ.txt

| | IS_FILE_FULLFILEPATH
Valor: 2
Indica um caminho de arquivo. As condições a seguir são impostas.

Para nome do servidor e nome do compartilhamento, permite todos os IS_ONECHAR caracteres, exceto: * ? : <> |

Para o nome do arquivo, permite todos os IS_ONECHAR caracteres, exceto: \ / : <> |

A entrada deve começar com \ ou nome da unidade ou \ ou .. \ ou .\ ou /

Espaços são permitidos.

Os exemplos incluem o seguinte.

\servername\sharename\filename.txt

C:\temp\current work.doc

.. /images/hank.jpg

| | IS_FILE_FILENAME
Valor: 3
Indica um nome de arquivo. As condições a seguir são impostas.

Aceita a extensão ou nenhuma extensão.

Permite todos os IS_ONECHAR caracteres, exceto: \ / : <> |

Espaços são permitidos.

Os exemplos incluem o seguinte:

filename.txt

filename

name.txt de arquivo

| | IS_EMAIL_USERNAME
Valor: 4
Indica nomes de usuário de email. Os exemplos incluem o seguinte.

jeffsm

JeffSm

Jsmith

Jsmith

jeffsmith

| | IS_EMAIL_SMTPEMAILADDRESS
Valor: 5
Indica um endereço de email SMTP completo, por exemplo, someone@example.com. | | IS_LOGINNAME
Valor: 6
Indica um nome e domínio de logon. As condições a seguir são impostas.

Permite todos os caracteres IS_ONECHAR.

Não permite que o domínio ou nome de usuário inicie ou termine em um caractere não alfanumérico.

Espaços não são permitidos.

Os exemplos incluem o seguinte.

CHICAGO\JSMITH

JSMITH

| | IS_PERSONALNAME_FULLNAME
Valor: 7
Indica uma combinação de nome, meio e sobrenome. Os exemplos incluem o seguinte, formatado para inglês (Estados Unidos).

Sr. Jeff A. Smith Jr.

Jeff Smith

Smith

Smith, Jeff A

| | IS_PERSONALNAME_PREFIX
Valor: 8
Indica um honorífico ou título que precede um nome. Os exemplos incluem o seguinte, formatado para inglês (Estados Unidos).

Perder

Senhor

| | IS_PERSONALNAME_GIVENNAME
Valor: 9
Indica um nome ou inicial. Os exemplos incluem o seguinte, formatado para inglês (Estados Unidos).

Jeff

| | IS_PERSONALNAME_MIDDLENAME
Valor: 10
Indica um nome do meio ou inicial. Os exemplos incluem o seguinte.

Albert

| | IS_PERSONALNAME_SURNAME
Valor: 11
Indica um sobrenome. Os exemplos incluem o seguinte, formatado para inglês (Estados Unidos).

Smith

Smith Jones

Smith-Jones

| | IS_PERSONALNAME_SUFFIX
Valor: 12
Indica uma abreviação de sufixo de nome ou numerais romanos. Os exemplos incluem o seguinte.

| | IS_ADDRESS_FULLPOSTALADDRESS
Valor: 13
Indica um endereço completo, incluindo números. Os exemplos incluem o seguinte, formatado para inglês (Estados Unidos).

Rua Principal 123, Anytown, WA 98989

Po Box 123 Anytown, WA 98989

| | IS_ADDRESS_POSTALCODE
Valor: 14
Indica um código postal alfanumérico. O valor é alfanumérico para dar suporte a cep internacionais. Os exemplos incluem o seguinte, formatado para inglês (Estados Unidos).

98989

98989-1234

| | IS_ADDRESS_STREET
Valor: 15
Indica um número de casa, número da rua, nome e número do apartamento e/ou caixa postal. Os exemplos incluem o seguinte.

123 Main Street

P.O. Box 1234

| | IS_ADDRESS_STATEORPROVINCE
Valor: 16
Indica um nome completo ou abreviação de estado ou província. Os exemplos incluem o seguinte, formatado para inglês (Estados Unidos).

Washington

| | IS_ADDRESS_CITY
Valor: 17
Indica o nome ou a abreviação de uma cidade. Os exemplos incluem o seguinte, formatado para inglês (Estados Unidos).

Nova Iorque

| | IS_ADDRESS_COUNTRYNAME
Valor: 18
Indica o nome de um país/região. Os exemplos incluem o seguinte, formatado para inglês (Estados Unidos).

Itália

Japão

Estados Unidos da América

| | IS_ADDRESS_COUNTRYSHORTNAME
Valor: 19
Indica a abreviação do nome de um país/região. Os exemplos incluem o seguinte, formatado para inglês (Estados Unidos).

U.S.A.

| | IS_CURRENCY_AMOUNTANDSYMBOL
Valor: 20
Indica símbolos de moeda e números. Os exemplos incluem o seguinte, formatado para inglês (Estados Unidos).

US$ 2.100,25

$.35

US$ 1.234,50

| | IS_CURRENCY_AMOUNT
Valor: 21
Indica um valor numérico para moeda, excluindo símbolos de moeda. Por exemplo, 2.100,25. | | IS_DATE_FULLDATE
Valor: 22
Indica uma data completa, em uma variedade de formatos. Os exemplos incluem o seguinte, formatado para inglês (Estados Unidos).

07-17-2001

7/17/01

7/17

12 de dezembro

17 de julho

17 de julho de 2001

| | IS_DATE_MONTH
Valor: 23
Indica uma representação numérica de meses, restrita a 1 a 12. Os exemplos incluem o seguinte.

| | IS_DATE_DAY
Valor: 24
Indica uma representação numérica de dias, restrita a 1 a 31. Os exemplos incluem o seguinte.

| | IS_DATE_YEAR
Valor: 25
Indica uma representação numérica de anos. Os exemplos incluem o seguinte.

1988

2004

| | IS_DATE_MONTHNAME
Valor: 26
Indica uma representação de caracteres de meses. Os exemplos incluem o seguinte, formatado para inglês (Estados Unidos).

Dezembro

Dezembro.

| | IS_DATE_DAYNAME
Valor: 27
Indica uma representação de caracteres de dias. Os exemplos incluem o seguinte, formatado para inglês (Estados Unidos).

Quarta-feira

Weds

Weds.

| | IS_DIGITS
Valor: 28
Indica números inteiros positivos, restritos a 0-9. | | IS_NUMBER
Valor: 29
Indica números, incluindo vírgulas, sinal negativo e decimal. Para Estados Unidos locais, as seguintes condições são impostas.

O separador de milhar é uma vírgula.

O separador decimal é um ponto final.

Números negativos são representados com um hífen sem espaço, não com parênteses.

| | IS_ONECHAR
Valor: 30
Indica um único caractere ANSI, página de código 1252. Para Estados Unidos locais, isso inclui os seguintes caracteres.

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

<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> | |

IS_TIME_FULLTIME

<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 Value: *37* Indicates a numeric representation of hours, constrained to 0-24. | | IS_TIME_MINORSEC 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 IS_CURRENCY_CHINESE

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

 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

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

IS_CHINESE_FULLWIDTH

<br>Value: *54*<br><b>Starting with Windows 10:</b> Indicates input scope is intended for Chinese full-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. | | IS_TEXT Value: *57* Starting with Windows 10: Indicates input scope is intended for working with text. | | IS_CHAT Value: *58* Starting with Windows 10: Indicates input scope is intended for chat strings. | | IS_NAME_OR_PHONENUMBER

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

IS_EMAILNAME_OR_ADDRESS

<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_PRIVATE

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

IS_MAPS IS_NUMERIC_PASSWORD Value: *63* Starting with Windows 10: Indicates expected input is a numeric password, or PIN. | |

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

IS_NUMERIC_PIN Value: *64* Starting with Windows 10: Indicates expected input is a numeric PIN. | | IS_ALPHANUMERIC_PIN Value: *65* Starting with Windows 10: Indicates expected input is an 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. | |

IS_FORMULA_NUMBER Value: *67* Starting with Windows 10: Indicates expected input is a mathematical formula. | | IS_CHAT_WITHOUT_EMOJI Value: *68* Starting with Windows 10: Indicates expected input does not include emoji. | | IS_PHRASELIST IS_REGULAREXPRESSION Value: *-1* Indicates a phrase list. | |  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'
Valor: -5
O escopo contém o ponteiro da interface IEnumString. O TIP (Processador de Entrada de Texto) pode chamar ITfInputScope2::EnumWordList para recuperá-lo. |

Comentários

Se um determinado valor de escopo de entrada tem suporte pode variar entre tecnologias.

Requisitos


Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Cabeçalho	inputscope.h

Confira também

Compartilhar via

Enumeração InputScope (inputscope.h)

Syntax

Constantes

Comentários

Requisitos

Confira também

Comentários

Recursos adicionais