Função SetPolyFillMode (wingdi.h)

  • Artigo

A função SetPolyFillMode define o modo de preenchimento de polígono para funções que preenchem polígonos.

Sintaxe

int SetPolyFillMode(
  [in] HDC hdc,
  [in] int mode
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] mode

O novo modo de preenchimento. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
ALTERNATIVO
 Seleciona o modo alternativo (preenche a área entre lados de polígono com numeração ímpar e par em cada linha de verificação).
ENROLAMENTO
 Seleciona o modo de enrolamento (preenche qualquer região com um valor de enrolamento diferente de zero).

Retornar valor

O valor retornado especifica o modo de preenchimento anterior. Se ocorrer um erro, o valor retornado será zero.

Comentários

Em geral, os modos diferem apenas nos casos em que um polígono complexo e sobreposto deve ser preenchido (por exemplo, um polígono de cinco lados que forma uma star de cinco pontas com um pentágono no centro). Nesses casos, o modo ALTERNATE preenche todas as outras regiões colocadas dentro do polígono (ou seja, os pontos da star), mas o modo WINDING preenche todas as regiões (ou seja, os pontos e o pentágono).

Quando o modo de preenchimento é ALTERNATE, o GDI preenche a área entre lados de polígono numerados pares e ímpares em cada linha de verificação. Ou seja, a GDI preenche a área entre o primeiro e o segundo lado, entre o terceiro e o quarto lado e assim por diante.

Quando o modo de preenchimento é WINDING, o GDI preenche qualquer região que tenha um valor de enrolamento diferente de zero. Esse valor é definido como o número de vezes que uma caneta usada para desenhar o polígono percorreria a região. A direção de cada borda do polígono é importante.

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

GetPolyFillMode

Funções de região

Visão geral das regiões