Função SetInputScopes2 (inputscope.h)

O aplicativo deve chamar SetInputScope com IS_DEFAULT antes que uma janela seja destruída para limpar a referência da interface.

Sintaxe

HRESULT SetInputScopes2(
  [in] HWND             hwnd,
  [in] const InputScope *pInputScopes,
  [in] UINT             cInputScopes,
  [in] IEnumString      *pEnumString,
  [in] PWSTR            pszRegExp,
  [in] PWSTR            pszSRGS
);

Parâmetros

[in] hwnd

A janela na qual definir o escopo. Essa chamada substituirá qualquer escopo que possa ter sido no hwnd antes.

[in] pInputScopes

Ponteiro para uma matriz de escopos de entrada. Pode ser NULL. Se não for NULL, todos os escopos contidos em serão definidos como o escopo de entrada do hwnd com ponderação igual. Use IS_DEFAULT para aceitar todas as outras entradas também (essa é a opção "não coagir").

[in] cInputScopes

Uma contagem do número de escopos de entrada em pInputScopes. Deve ser zero se rgScopes for NULL, deverá ser diferente de zero se pInputScopes não for NULL.

[in] pEnumString

Ponteiro da interface IenumString da lista de frases.

[in] pszRegExp

Ponteiro para uma cadeia de caracteres terminada em NULL que descreve a expressão regular a ser reconhecida. Pode ser NULL.

[in] pszSRGS

Ponteiro para uma cadeia de caracteres XML terminada em NULL que fornece dicas e regras específicas de fala para auxiliar no reconhecimento de fala. O formato XML está em conformidade com o padrão SRGS (Especificação gramatical de reconhecimento de fala), descrito em http://www.w3.org/TR/speech-grammar. Pode ser NULL. $

Valor retornado

Valor	Significado
S_OK	O conjunto de escopo de entrada ou limpo com êxito.

Comentários

O aplicativo deve chamar SetInputScope com IS_DEFAULT antes que uma janela seja destruída para limpar a referência da interface.

Se você chamar esse método em uma janela (parâmetro hwnd ) que não foi associada a um Gerenciador de Documentos, nenhuma notificações de serviço de texto será enviada aos clientes interessados (como o teclado virtual) que talvez queiram responder à alteração de escopo.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	inputscope.h
DLL	Msctf.dll