wingdi.h


CloseFigure

La función CloseFigure cierra una figura abierta en un camino.

Sintaxis

BOOL CloseFigure(
    HDC hdc  // manipulador de contexto de dispositivo
   );

Parámetros

hdc: identifica el contexto de dispositivo con la figura a cerrar.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si la función falla, el valor de retorno es cero. Para obtener más información, llamar a GetLastError.

Observaciones

La función CloseFigure cierra la figura trazando una línea desde la posición actual al primer punto de la figura (normalmente, el punto especificado por la llamada más reciente a la función MoveToEx) y conecta las líneas usnado el estilo de línea de unión. Si una figura se cierra usando la función LineTo en lugar de CloseFigure, se usan los tapones terminadores para crear la esquina, en lugar de usar una unión.

La función CloseFigure sólo debe ser llamada si existe un camino abierto en el contexto de dispositivo especificado.

Una figura en un camino estará abierta salvo que sea cerrada explícitamente usando esta función. (Una figura puede estar abierta aunque el punto actual y el punto de inicio sean el mismo.)

Después de llamar a CloseFigure, añadir una línea o una curva al camino empieza otra figura nueva.