Função SetMetaRgn (wingdi.h)
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 |
|---|---|
|
A região está vazia. |
|
A região é um único retângulo. |
|
A região é mais de um retângulo. |
|
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 |