Partilhar via

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.

Valor de retorno

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.

Observações

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 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.

Você não pode passar um retângulo em que o valor da propriedade Right é menor que o valor da propriedade Left ; ou onde 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 de 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 resultar na nova inserção da função subjacente, 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 apartamento com thread único.
 

Requisitos

Requisito Valor
Cliente mínimo suportado Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo compatível Nenhum compatível
da Plataforma de Destino Windows
Header msinkaut.h

Consulte também

Propriedade Enabled

Método GetWindowInputRectangle

Iinkoverlay

Classe InkOverlay

  • Last updated on