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 |