AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Ayuda / WLanguage / Funciones WLanguage / Controles, páginas y ventanas / Funciones de dibujo
  • Coordenadas
  • Uso de las funciones de dibujo
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Dibuja un rectángulo redondeado:
  • en un control Imagen,
  • en una variable de tipo Image.
Observación: Para dibujar rectángulos personalizados, le recomendamos utilizar la función dBorder.
Ejemplo
// Initialize the drawing in an Image control
dStartDrawing(IMG_Drawing)

// Draw a rounded rectangle whose background is light yellow
// and light blue borders
dRoundedRectangle(10, 10, 50, 50, 3, LightYellow, LightBlue)
iPhone/iPadIOS WidgetMac Catalyst
// Draw a rounded rectangle whose background is light yellow
// and light blue borders
dRoundedRectangle(IMG_Drawing, 10, 10, 50, 50, 3, LightYellow, LightBlue)
Sintaxis

Dibujar un rectángulo redondeado especificando las coordenadas del rectángulo y el diámetro de las esquinas Ocultar los detalles

dRoundedRectangle([<Image>, ] <X1> , <Y1> , <X2> , <Y2> , <Corner diameter> [, <Background> [, <Line>]])
<Image>: Nombre de control opcional o variable de tipo Image, WDPic o picLayer opcional
iPhone/iPadIOS WidgetMac Catalyst Imagen a manipular. Esta imagen puede corresponder a:
  • el nombre de un control Imagen.
  • el nombre de una variable de tipo Image.
Si no se especifica este parámetro, se debe definir el destino del dibujo con la función dStartDrawing.
<X1>: Entero
Coordenada X (en pixeles) de la esquina superior izquierda del rectángulo.
<Y1>: Entero
Coordenada Y (en pixeles) de la esquina superior izquierda del rectángulo.
<X2>: Entero
Coordenada X (en pixeles) de la esquina inferior derecha del rectángulo.
<Y2>: Entero
Coordenada Y (en pixeles) de la esquina inferior derecha del rectángulo.
<Corner diameter>: Entero
Diámetro de las esquinas del rectángulo.
<Background>: Entero o constante de tipo Integer (opcional)
  • Color de fondo del rectángulo. Este color puede ser:
  • Características del fondo:
    • variable de tipo Background. En este caso, se ignora el degradado definido en la variable.
    • características especificadas en la última llamada a la función dBackground si no se especifica este parámetro.
Para utilizar un color de fondo degradado, llame a la función dRectangleGradient.
<Line>: Entero, constante o variable de tipo Border (opcional)
Color de la línea del rectángulo. Este color puede ser:Si no se especifica este parámetro:
  • color especificado en la última llamada a la función dPen.
  • color idéntico al color utilizado para el fondo si no se ha utilizado la función dPen.

Dibujar un rectángulo redondeado especificando las coordenadas del rectángulo y el tipo de bordes Ocultar los detalles

dRoundedRectangle([<Image>, ] <X1> , <Y1> , <X2> , <Y2> , <Border> [, <Background>])
<Image>: Nombre de control opcional o variable de tipo Image, WDPic o picLayer opcional
iPhone/iPadIOS WidgetMac Catalyst Imagen a manipular. Esta imagen puede corresponder a:
  • el nombre de un control Imagen.
  • el nombre de una variable de tipo Image.
Si no se especifica este parámetro, se debe definir el destino del dibujo con la función dStartDrawing.
<X1>: Entero
Coordenada X (en pixeles) de la esquina superior izquierda del rectángulo.
<Y1>: Entero
Coordenada Y (en pixeles) de la esquina superior izquierda del rectángulo.
<X2>: Entero
Coordenada X (en pixeles) de la esquina inferior derecha del rectángulo.
<Y2>: Entero
Coordenada Y (en pixeles) de la esquina inferior derecha del rectángulo.
<Border>: Variable de tipo Border
Nombre de la variable de tipo Border que define las características del rectángulo. Solo se tienen en cuenta las siguientes propiedades:
  • Redondeado: si la propiedad corresponde a la constante RoundingUndefined, no se define ningún redondeado.
  • Color: si la propiedad corresponde a la constante ColorUndefined, se utiliza el color definido en la última llamada a la función dPen. Si no se ha utilizado esta función, se utiliza el color de fondo del rectángulo.
  • Grosor: si la propiedad corresponde a la constante ThicknessUndefined, se utiliza el grosor definido en la última llamada a la función dPen. Si no se ha utilizado esta función, el valor del grosor es 1.
  • Línea: si la propiedad corresponde a la constante LineUndefined, se utiliza el tipo de línea definido en la última llamada ala función dPen. Si no se ha utilizado esta función, la línea es una línea continua.
<Background>: Entero, constante o variable de tipo Background (opcional)
  • Color de fondo del rectángulo. Este color puede ser:
  • Características del fondo:
    • variable de tipo Background. En este caso, se ignora el degradado definido en la variable.
    • características especificadas en la última llamada a la función dBackground si no se especifica este parámetro.
Para utilizar un color de fondo degradado, llame a la función dRectangleGradient.

Dibujar un rectángulo redondeado con una variable de tipo Rectangle especificando el diámetro de las esquinas Ocultar los detalles

dRoundedRectangle([<Image>, ] <Rectangle> , <Corner diameter> [, <Background> [, <Line>]])
<Image>: Nombre de control opcional o variable de tipo Image, WDPic o picLayer opcional
iPhone/iPadIOS WidgetMac Catalyst Imagen a manipular. Esta imagen puede corresponder a:
  • el nombre de un control Imagen.
  • el nombre de una variable de tipo Image.
Si no se especifica este parámetro, se debe definir el destino del dibujo con la función dStartDrawing.
<Rectangle>: Variable de tipo Rectangle
Nombre de la variable de tipo Rectangle que define las coordenadas del rectángulo a dibujar.
<Corner diameter>: Entero
Diámetro de las esquinas del rectángulo.
<Background>: Entero, constante o variable de tipo Background (opcional)
  • Color de fondo del rectángulo. Este color puede ser:
  • Características del fondo:
    • variable de tipo Background. En este caso, se ignora el degradado definido en la variable.
    • características especificadas en la última llamada a la función dBackground si no se especifica este parámetro.
Para utilizar un color de fondo degradado, llame a la función dRectangleGradient.
<Line>: Entero, constante o variable de tipo Border (opcional)
Color de la línea del rectángulo. Este color puede ser:Si no se especifica este parámetro:
  • color especificado en la última llamada a la función dPen.
  • color idéntico al color utilizado para el fondo si no se ha utilizado la función dPen.

Dibujar un rectángulo redondeado con una variable de tipo Rectangle y Border Ocultar los detalles

dRoundedRectangle([<Image>, ] <Rectangle> , <Border> [, <Background>])
<Image>: Nombre de control opcional o variable de tipo Image, WDPic o picLayer opcional
iPhone/iPadIOS WidgetMac Catalyst Imagen a manipular. Esta imagen puede corresponder a:
  • el nombre de un control Imagen.
  • el nombre de una variable de tipo Image.
Si no se especifica este parámetro, se debe definir el destino del dibujo con la función dStartDrawing.
<Rectangle>: Variable de tipo Rectangle
Nombre de la variable de tipo Rectangle que define las coordenadas del rectángulo a dibujar.
<Border>: Variable de tipo Border
Nombre de la variable de tipo Border que define las características del rectángulo. Solo se tienen en cuenta las siguientes propiedades:
  • Redondeado: si la propiedad corresponde a la constante RoundingUndefined, no se define ningún redondeado.
  • Color: si la propiedad corresponde a la constante ColorUndefined, se utiliza el color especificado en la última llamada a la función dPen. Si no se ha utilizado esta función, se utiliza el color de fondo del rectángulo.
  • Grosor: si la propiedad corresponde a la constante ThicknessUndefined, se utiliza el grosor especificado en la última llamada a la función dPen. Si no se ha utilizado esta función, el valor del grosor es 1.
  • Línea: si la propiedad corresponde a la constante LineUndefined, se utiliza la línea especificada en la última llamada a la función dPen. Si no se ha utilizado esta función, la línea es una línea continua.
<Background>: Entero, constante o variable de tipo Background (opcional)
  • Color de fondo del rectángulo. Este color puede ser:
  • Características del fondo:
    • variable de tipo Background. En este caso, se ignora el degradado definido en la variable.
    • características especificadas en la última llamada a la función dBackground si no se especifica este parámetro.
Para utilizar un color de fondo degradado, llame a la función dRectangleGradient.
Observaciones

Coordenadas

Las coordenadas se especifican con respecto a la esquina superior izquierda del control Imagen o de la imagen (coordenadas (0,0)).

Uso de las funciones de dibujo

Las funciones de dibujo se pueden utilizar según 2 métodos:
  • Método 1: Uso de la función dStartDrawing
    • Se debe llamar a la función dStartDrawing antes de utilizar otras funciones de dibujo. La función dStartDrawing permite definir el elemento (control Imagen o variable) en el que se aplicarán las funciones de dibujo.
    • Al dibujar en un control Imagen:
      • Las funciones de dibujo trabajan en una copia ("bitmap") de la imagen. Se pueden utilizar las funciones de dibujo de Windows (con la función dStartDrawing o CallDLL32), pero estas funciones deben utilizar el DC (Device Context) devuelto por la función API.
      • las funciones dEndDrawing y dStartDrawing no deben llamarse en el mismo proceso.
        Si se llama a las funciones dEndDrawing y dStartDrawing en el mismo proceso, no se mostrará el dibujo: se borrará automáticamente.
  • iPhone/iPadIOS WidgetMac Catalyst Método 2: indicar el destino del dibujo directamente en la sintaxis (mediante un parámetro)
    El parámetro <Imagen> permite especificar directamente el destino del dibujo. Ya no es necesario utilizar dStartDrawing. Esta función debe ser eliminada.
Clasificación Lógica de negocio / UI: Código neutro
Componente: wd290pnt.dll
Versión mínima requerida
  • Versión 21
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 17/01/2024

Señalar un error o enviar una sugerencia | Ayuda local