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

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.

Retornar valor

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 da janela de um InkCollector habilitado.

Comentários

O erro E_INK_OVERLAPPING_INPUT_RECT será retornado se o retângulo de entrada da 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 {0,0,0,0}como . 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 reinserida, causando resultados inesperados. Tome cuidado para evitar uma chamada reentrante ao lidar com qualquer uma das seguintes mensagens: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATEWM_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

Requisito	Valor
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

Iinkoverlay

Classe InkOverlay