Função SetInputScopes (inputscope.h)

Define uma combinação de um escopo de entrada, vários escopos de entrada, uma lista de frases, uma expressão regular e/ou regras de SRGS (Especificação gramatical de reconhecimento de fala) para a janela especificada.

Sintaxe

HRESULT SetInputScopes(
  [in] HWND             hwnd,
  [in] const InputScope *pInputScopes,
  [in] UINT             cInputScopes,
  [in] PWSTR            *ppszPhraseList,
  [in] UINT             cPhrases,
  [in] PWSTR            pszRegExp,
  [in] PWSTR            pszSRGS
);

Parâmetros

[in] hwnd

A janela na qual definir o escopo.

[in] pInputScopes

Ponteiro para uma matriz de escopos de entrada. Pode ser NULL. Se não for NULL, todos os escopos de entrada na matriz serão definidos como o escopo de entrada da janela com ponderação igual. Use IS_DEFAULT para aceitar todos os outros escopos de entrada também.

[in] cInputScopes

O número de escopos de entrada na matriz apontada por *pInputScopes. Esse valor deverá ser zero se a matriz for NULL.

[in] ppszPhraseList

Ponteiro para uma matriz de ponteiros para frases terminadas em NULL. Pode ser NULL.

[in] cPhrases

Número de ponteiros apontados por **ppszPhraseList, que representa o número de frases.

[in] pszRegExp

Ponteiro para uma cadeia de caracteres terminada em NULL que contém 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 método foi bem-sucedido.

Comentários

Chamar esse método substitui qualquer escopo associado à janela.

Essa API funciona somente quando a janela (parâmetro hwnd) e o thread de chamada estão no mesmo thread. Se você chamar essa API para uma janela de thread diferente, ela falhará com E_INVALIDARG.

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