Compartilhar via


Função SetInputScope (inputscope.h)

Define um escopo de entrada para a janela especificada.

Sintaxe

HRESULT SetInputScope(
  [in] HWND       hwnd,
  [in] InputScope inputscope
);

Parâmetros

[in] hwnd

A janela na qual definir o escopo.

[in] inputscope

O escopo de entrada a ser associado à janela. Para remover a associação de escopo de entrada, passe IS_DEFAULT para esse parâmetro.

Valor retornado

Valor Significado
S_OK O método foi bem-sucedido.

Comentários

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

Um aplicativo deve chamar esse método, passando IS_DEFAULT para o parâmetro hwnd , para remover a associação de escopo de entrada antes que a janela seja destruída.

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.

Exemplos

[C++]

O código a seguir ilustra como definir um escopo de entrada para uma janela.


SetInputScope(hwnd, IS_EMAIL_USERNAME);

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