Função SubtractRect (winuser.h)

Artigo
08/28/2023

A função SubtractRect determina as coordenadas de um retângulo formado pela subtração de um retângulo de outro.

Sintaxe

BOOL SubtractRect(
  [out] LPRECT     lprcDst,
  [in]  const RECT *lprcSrc1,
  [in]  const RECT *lprcSrc2
);

Parâmetros

[out] lprcDst

Um ponteiro para uma estrutura RECT que recebe as coordenadas do retângulo determinadas pela subtração do retângulo apontado por lprcSrc2 do retângulo apontado por lprcSrc1.

[in] lprcSrc1

Um ponteiro para uma estrutura RECT da qual a função subtrai o retângulo apontado por lprcSrc2.

[in] lprcSrc2

Um ponteiro para uma estrutura RECT que a função subtrai do retângulo apontado por lprcSrc1.

Valor retornado

Se o retângulo resultante estiver vazio, o valor retornado será zero.

Se o retângulo resultante não estiver vazio, o valor retornado será diferente de zero.

Comentários

A função só subtrai o retângulo especificado por lprcSrc2 do retângulo especificado por lprcSrc1 quando os retângulos se cruzam completamente na direção x ou y. Por exemplo, se *lprcSrc1 tiver as coordenadas (10,10,100,100) e *lprcSrc2 tiver as coordenadas (50,50,150,150), a função definirá as coordenadas do retângulo apontado por lprcDst como (10,10.100.100). Se *lprcSrc1 tiver as coordenadas (10,10.100.100) e *lprcSrc2 tiver as coordenadas (50,10.150.150), no entanto, a função definirá as coordenadas do retângulo apontado por lprcDst como (10,10,50,100). Em outras palavras, o retângulo resultante é a caixa delimitadora da diferença geométrica.

Como os aplicativos podem usar retângulos para diferentes finalidades, as funções de retângulo não usam uma unidade de medida explícita. Em vez disso, todas as coordenadas e dimensões do retângulo são fornecidas em valores lógicos com sinal. O modo de mapeamento e a função na qual o retângulo é usado determinam as unidades de medida.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll