CDC::PolyDraw

Artigo
08/25/2010

Desenha um conjunto de segmentos de linha e Bzier splines.

BOOL PolyDraw(
   const POINT* lpPoints,
   const BYTE* lpTypes,
   int nCount 
);

Parâmetros

lpPoints
Aponta para uma matriz de PONTO estruturas de dados que contém os pontos de extremidade para cada segmento e os pontos de extremidade de linha e pontos para cada spline Bzier de controle.
lpTypes
Aponta para uma matriz que especifica como cada ponto no lpPoints matriz é usada. Valores podem ser uma das seguintes opções:
- PT_MOVETO Especifica que este ponto começa uma figura de disjunção.Este ponto torna-se a nova posição corrente.
- PT_LINETO Especifica que uma linha seja desenhada na posição corrente para este ponto, que então se torna a nova posição corrente.
- PT_BEZIERTO Especifica que esse ponto é um ponto de controle ou o ponto final de uma spline Bzier.
  
  PT_BEZIERTO tipos sempre ocorrem em conjuntos de três.A posição corrente define o ponto de partida para o spline Bzier.As duas primeiras PT_BEZIERTO pontos são pontos de controle e o terceiro PT_BEZIERTO ponto é o ponto final.O ponto final se torna a nova posição corrente.Se não houver não três consecutivos PT_BEZIERTO pontos, ocorrerá um erro.
  
  A PT_LINETO or PT_BEZIERTO tipo pode ser combinado com a constante a seguir usando o operador bit a bit ou indicar que o ponto correspondente é o último ponto em uma figura e a figura é fechado:
- PT_CLOSEFIGURE Especifica que a figura será fechada automaticamente após o PT_LINETO or PT_BEZIERTO tipo para este ponto é concluído.Uma linha é desenhada a partir deste ponto para o mais recente PT_MOVETO or MoveTo ponto.
  
  Este sinalizar é combinado com o PT_LINETO tipo para uma linha ou com o PT_BEZIERTO tipo de final de uma spline Bzier, usando o operador bit a bit OR operador. A posição corrente está definida como o ponto final da linha de fechamento.
nCount
Especifica o número total de pontos no lpPoints array, mesmo que o número de bytes na lpTypes matriz.

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário, 0.

Comentários

Esta função pode ser usada para desenhar figuras disjunção no lugar da chamadas consecutivas para CDC::MoveTo, CDC::LineTo, e CDC::PolyBezierTo funções de membro. As linhas e splines são desenhadas usando a caneta corrente e figuras não são preenchidas.Se há um caminho ativo iniciado chamando o CDC::BeginPath função de membro PolyDraw Adiciona o caminho. Os pontos contidos o lpPoints array e, em lpTypes Indica se a cada ponto é parte de um CDC::MoveTo, um CDC::LineTo, ou um CDC::BezierTo operação.Também é possível fechar figuras.Essa função atualiza a posição corrente.