Função IntersectRect (winuser.h)

Artigo
08/27/2023

A função IntersectRect calcula a interseção de dois retângulos de origem e coloca as coordenadas do retângulo de interseção no retângulo de destino. Se os retângulos de origem não se cruzarem, um retângulo vazio (no qual todas as coordenadas são definidas como zero) será colocado no retângulo de destino.

Sintaxe

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

Parâmetros

[out] lprcDst

Um ponteiro para a estrutura RECT que deve receber a interseção dos retângulos apontados pelos parâmetros lprcSrc1 e lprcSrc2 . Esse parâmetro não pode ser NULL.

[in] lprcSrc1

Um ponteiro para a estrutura RECT que contém o primeiro retângulo de origem.

[in] lprcSrc2

Um ponteiro para a estrutura RECT que contém o segundo retângulo de origem.

Valor retornado

Se os retângulos se cruzarem, o valor retornado será diferente de zero.

Se os retângulos não se cruzarem, o valor retornado será zero.

Comentários

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.

Exemplos

Para obter um exemplo, consulte Usando retângulos.

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