Função UnionRect (winuser.h)

Artigo
08/28/2023

A função UnionRect cria a união de dois retângulos. A união é o menor retângulo que contém os dois retângulos de origem.

Sintaxe

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

Parâmetros

[out] lprcDst

Um ponteiro para a estrutura RECT que receberá um retângulo que contém os retângulos apontados pelos parâmetros lprcSrc1 e lprcSrc2 .

[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 a estrutura especificada contiver um retângulo não vazio, o valor retornado não será zero.

Se a estrutura especificada não contiver um retângulo não vazio, o valor retornado será zero.

Comentários

O sistema ignora as dimensões de um retângulo vazio, ou seja, um retângulo no qual todas as coordenadas são definidas como zero, de modo que não tenha altura ou largura.

Como os aplicativos podem usar retângulos para fins diferentes, 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