wingdi.h


Pie

Traza un sector circular, resultado de la intersección de una elipse y dos radios. La figura se traza usando la pluma actual y se rellena usando el pincel actual.

Sintaxis

BOOL Pie(
    HDC hdc,         // manipulador a contexto de dispositivo
    int nLeftRect,   // coordenada x de la esquina superior izquierda del rectángulo que limita la elipse 
    int nTopRect,    // coordenada y de la esquina superior izquierda del rectángulo que limita la elipse 
    int nRightRect,  // coordenada x de la esquina inferior derecha del rectángulo que limita la elipse
    int nBottomRect, // coordenada x de la esquina inferior derecha del rectángulo que limita la elipse
    int nXRadial1,   // coordenada x del radio que define el primer extremo
    int nYRadial1,   // coordenada y del radio que define el primer extremo
    int nXRadial2,   // coordenada x del radio que define el segundo extremo
    int nYRadial2    // coordenada y del radio que define el segundo extremo
   );

Parámetros:

hdc: identifica el contexto de dispositivo.

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

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

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

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

nXRadial1: especifica la coordenada x del radio que define el primer extremo de la curva.

nYRadial1: especifica la coordenada y del radio que define el primer extremo de la curva.

nXRadial2: especifica la coordenada x del radio que define el segundo extremo de la curva.

nYRadial2: especifica la coordenada y del radio que define el segundo extremo de la curva.

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. Para obtener más información, llamar a GetLastError.

Observaciones

La curva de la figura se define por una elipse inscrita en el rectángulo. La curva empieza en el punto en que la elipse se cruza con el primer radio y se extiende en el sentido de las agujas del reloj hasta el punto en que la elipse se cruza con el segundo radio. Un radio es un segmento de línea que parte del centro de la elipse hasta el punto extremo de la elipse. La figura se cierra mediante el trazado de los dos radios.

La posición actual del cursor gráfico no se modifica por esta función.

Sólo en Windows 95: La suma de las coordenadas del rectángulo que define la elipse no puede sobrepasar el valor 32767. La suma de los parámetros nLeftRect y nRightRect o nTopRect y nBottomRect no puede exceder 32767.