Função BeginPath (wingdi.h)

A função BeginPath abre um colchete de caminho no contexto do dispositivo especificado.

Sintaxe

BOOL BeginPath(
  [in] HDC hdc
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

Depois que um colchete de caminho é aberto, um aplicativo pode começar a chamar funções de desenho GDI para definir os pontos que estão no caminho. Um aplicativo pode fechar um colchete de caminho aberto chamando a função EndPath .

Quando um aplicativo chama BeginPath para um contexto de dispositivo, todos os caminhos anteriores são descartados desse contexto de dispositivo. A lista a seguir mostra quais funções de desenho podem ser usadas.

• AngleArc
• Arc
• ArcTo
• Chord
• Closefigure
• Elipse
• Exttextout
• Lineto
• MoveToEx
• Pizza
• PolyBezier
• Polybezierto
• PolyDraw
• Polygon
• Polilinha
• PolylineTo
• Polypolygon
• PolyPolyline
• Retângulo
• Roundrect
• Textout

Exemplos

Para obter um exemplo, consulte Usando caminhos.

Requisitos

Confira também

EndPath

Fillpath

Funções de caminho

PathToRegion

Visão geral de caminhos

SelectClipPath

StrokeAndFillPath

StrokePath

WidenPath