Função SetMetaRgn (wingdi.h)

  • Artigo

A função SetMetaRgn cruza a região de recorte atual para o contexto do dispositivo especificado com a metaregião atual e salva a região combinada como a nova metarregião para o contexto do dispositivo especificado. A região de recorte é redefinida para uma região nula.

Sintaxe

int SetMetaRgn(
  [in] HDC hdc
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

Retornar valor

O valor retornado especifica a complexidade da nova região de recorte e pode ser um dos valores a seguir.

Código de retorno Descrição
NULLREGION
 A região está vazia.
SIMPLEREGION
 A região é um único retângulo.
COMPLEXREGION
 A região é mais de um retângulo.
ERROR
 Ocorreu um erro. (A região de recorte anterior não é afetada.)

Comentários

A região de recorte atual de um contexto de dispositivo é definida pela interseção de sua região de recorte e sua metaregião.

A função SetMetaRgn só deve ser chamada depois que o contexto de dispositivo original de um aplicativo foi salvo chamando a função SaveDC .

Requisitos

Requisito Valor
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 wingdi.h (inclua Windows.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

Funções de recorte

Visão geral do recorte

GetMetaRgn

Savedc