wingdi.h


Arc

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

Sintaxis

BOOL Arc(
    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  nXStartArc,  // coordenada x para el radio del primer extremo del arco
    int  nYStartArc,  // coordenada y para el radio del primer extremo del arco
    int  nXEndArc,    // coordenada x para el radio del segundo extremo del arco
    int  nYEndArc     // coordenada y para el radio del segundo extremo del arco
   );	

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.

Windows 95: la suma de nLeftRect y nRightRect debe ser menor que 32768.

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

Windows 95: la suma de nTopRect y nBottomRect debe ser menor que 32768.

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

Windows 95: la suma de nLeftRect y nRightRect debe ser menor que 32768.

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

Windows 95: la suma de nTopRect y nBottomRect debe ser menor que 32768.

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

nYStartArc: especifica la coordenada lógica ydel extremo del radio que define el punto de arranque del arco.

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

nYEndArc: especifica la coordenada lógica x 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

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.

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

La posición de cursor gráfico no se actualiza por la función Arc.

Windows 95: la dirección de trazado es siempre en el sentido contrario a de avance de las agujas del reloj.

Windows NT: usar GetArcDirection y SetArcDirection para leer o modificar la dirección actual de trazado del contexto de dispositivo. La dirección de trazado por defecto es la del sentido contrario al de avance de las agujas del reloj.

Sólo en Windows 95: la suma de las coordenadas del rectángulo de borde no pueden exceder de 32,767. La suma de los parámetros nLeftRect y nRightRect o de nTopRect y nBottomRect no puede exceder de 32,767.