wingdi.h


ArcTo

La función ArcTo traza un arco elíptico.

Sintaxis

BOOL ArcTo(
    HDC  hdc,         // manipulador de contexto de dispositivo 
    int  nLeftRect,   // coordenada x de la esquina superior izquierda del rectángulo límite
    int  nTopRect,    // coordenada y de la esquina superior izquierda del rectángulo límite
    int  nRightRect,  // coordenada x de la esquina inferior derecha del rectángulo límite
    int  nBottomRect, // coordenada y de la esquina inferior derecha del rectángulo límite
    int  nXRadial1,   // coordenada x del primer punto radial
    int  nYRadial1,   // coordenada y del primer punto radial
    int  nXRadial2,   // coordenada x del segundo punto radial
    int  nYRadial2    // coordenada y del segundo punto radial
   );

Parámetros:

hdc: identifica el contexto de dispositivo.

nLeftRect: especifica la coordenada x lógica de la esquina superior izquierda del rectángulo que limita a la elipse.

nTopRect: especifica la coordenada y lógica de la esquina superior izquierda del rectángulo que limita a la elipse.

nRightRect: especifica la coordenada x lógica de la esquina inferior derecha del rectángulo que limita a la elipse.

nBottomRect: especifica la coordenada y lógica de la esquina inferior derecha del rectángulo que limita a la elipse.

nXRadial1: especifica la coordenada x lógica del extremo del radio que define el punto de comienzo del arco.

nYRadial1: especifica la coordenada y lógica del extremo del radio que define el punto de comienzo del arco.

nXRadial2: especifica la coordenada x lógica del extremo del radio que define el punto de final del arco.

nYRadial2: especifica la coordenada y lógica del extremo del radio que define el punto de final del arco.

Valor de retorno

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

Si la función falla, el valor de retorno es FALSE.

Observaciones

La función ArcTo es parecida a Arc, salvo que la posición del cursor gráfico se actualiza.

Los puntos (nLeftRect, nTopRect) y (nRightRect, nBottomRect) definen un rectángulo en el que se inscribe la elipse. La elipse definida por el rectángulo define a su vez la curva del arco. El arco se extiende en el sentido contrario al de avance de las agujas del reloj desde el punto de intersección con la línea radial que va desde el centro del rectángulo hasta el punto (nXRadial1, nYRadial1). El arco termina en el punto de intersección con la línea radial que va desde el centro del rectángulo, hasta el punto (nXRadial2, nYRadial2). Si el punto de comienzo y final son el mismo, la elipse se traza completa.

Se traza una línea desde la posición actual del cursor gráfico hasta el punto de comienzo del arco. Si no se producen errores, el punto final del arco pasa a ser la posición actual del cursor gráfico.

El arco se traza usando la pluma actual, y no se rellena.