Método IInkCollector::SetWindowInputRectangle (msinkaut.h)

  • Artigo

Define o retângulo da janela, em pixels, no qual a tinta é desenhada.

Sintaxe

HRESULT SetWindowInputRectangle(
  [in] IInkRectangle *WindowInputRectangle
);

Parâmetros

[in] WindowInputRectangle

O retângulo, nas coordenadas da janela, no qual a tinta é desenhada.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
E_POINTER
 Um parâmetro continha um ponteiro inválido.
E_INVALIDARG
 As coordenadas do retângulo são inválidas (por exemplo, largura/altura de 0).
E_INK_COLLECTOR_BUSY
 Não é possível atualizar mapeamentos enquanto estiver no meio de um traço.
E_INK_EXCEPTION
 Ocorreu uma exceção dentro do método .
E_INK_OVERLAPPING_INPUT_RECT
 O retângulo de entrada da janela se sobrepõe ao retângulo de entrada de janela de um InkCollector habilitado.

Comentários

O erro E_INK_OVERLAPPING_INPUT_RECT será retornado se o retângulo de entrada de janela de um coletor de tinta habilitado (definido com a propriedade Enabled ) sobrepor o retângulo de entrada da janela de outro coletor de tinta habilitado.

Nota A sobreposição pode ocorrer sem um erro, desde que apenas um dos retângulos de entrada esteja habilitado em qualquer momento conhecido.
 
Por padrão, o retângulo de entrada da janela é definido como {0,0,0,0}. Esse retângulo padrão é mapeado para o tamanho de toda a janela.

Para redefinir o retângulo de entrada da janela para seu comportamento padrão (um retângulo vazio com coordenadas {0,0,0,0}), passe {0,0,0,0} a chamada para SetWindowInputRectangle e não NULL.

Não é possível passar um retângulo em que o valor da propriedade Right é menor que o valor da propriedade Left ; ou em que o valor da propriedade Bottom é menor que o valor da propriedade Top . Por exemplo, um retângulo com parâmetros de {500, 500, 400, 400} não é válido.

Cuidado Se você definir o retângulo de entrada da janela para sobrepor um controle divisor ou as bordas da janela, resultados imprevisíveis poderão ocorrer quando a janela for redimensionada.
 
Nota Chamar esse método em determinados manipuladores de mensagens pode fazer com que a função subjacente seja inserida novamente, causando resultados inesperados. Tome cuidado para evitar uma chamada reentrada ao lidar com qualquer uma das seguintes mensagens: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND se wParam estiver definido como SC_HOTKEY ou SC_TASKLIST; e WM_SYSKEYDOWN (ao processar combinações de teclas Alt+TAB ou Alt+ESC). Esse é um problema com aplicativos de modelo de apartment de thread único.
 

Requisitos

   
Cliente mínimo com suporte Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho msinkaut.h
Biblioteca InkObj.dll

Confira também

Propriedade Enabled

Método GetWindowInputRectangle

IInkCollector

Classe InkCollector