Função ExtSelectClipRgn (wingdi.h)
A função ExtSelectClipRgn combina a região especificada com a região de recorte atual usando o modo especificado.
Sintaxe
int ExtSelectClipRgn(
[in] HDC hdc,
[in] HRGN hrgn,
[in] int mode
);
Parâmetros
[in] hdc
Um identificador para o contexto do dispositivo.
[in] hrgn
Um identificador para a região a ser selecionada. Esse identificador não deve ser NULL , a menos que o modo de RGN_COPY seja especificado.
[in] mode
A operação a ser executada. Deve ser um dos valores a seguir.
| Valor | Significado |
|---|---|
|
A nova região de recorte combina as áreas sobrepostas da região de recorte atual e a região identificada pelo hrgn. |
|
A nova região de recorte é uma cópia da região identificada pelo hrgn. Isso é idêntico a SelectClipRgn. Se a região identificada pelo hrgn for NULL, a nova região de recorte será a região de recorte padrão (a região de recorte padrão é uma região nula). |
|
A nova região de recorte combina as áreas da região de recorte atual com as áreas excluídas da região identificada pelo hrgn. |
|
A nova região de recorte combina a região de recorte atual e a região identificada pelo hrgn. |
|
A nova região de recorte combina a região de recorte atual e a região identificada pelo hrgn , mas exclui as áreas sobrepostas. |
Retornar valor
O valor retornado especifica a complexidade da nova região de recorte; 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. |
Comentários
Se ocorrer um erro quando essa função for chamada, a região de recorte anterior para o contexto do dispositivo especificado não será afetada.
A função ExtSelectClipRgn pressupõe que as coordenadas da região especificada sejam especificadas em unidades de dispositivo.
Apenas uma cópia da região identificada pelo parâmetro hrgn é usada. A própria região pode ser reutilizado após essa chamada ou pode ser excluída.
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 |