dLine (Función)

AYUDA EN LÍNEA
WINDEV, WEBDEV Y WINDEV MOBILE

Versión:

Inicio | Iniciar sesión | Español

Ayuda / WLanguage / Funciones WLanguage / Controles, páginas y ventanas / Funciones de dibujo

Coordenadas
Uso de las funciones de dibujo

WINDEV

WEBDEV

WINDEV Mobile

Otros

Ver también

dLine (Función)

Dibuja una línea:

en un control Imagen,
en una variable de tipo Image.
en una variable de tipo WDPic (en la capa de fondo),
en una variable de tipo picLayer.

Atención: Se requiere una configuración específica para usar esta función en Linux. Para obtener más información, consulte Los dibujos.

Ejemplo

Ver ejemplos adicionales

// Initialize the drawing in an Image control
dStartDrawing(IMG_Drawing)

// Draw a line in light yellow
dLine(10, 10, 50, 50, LightYellow)

// Draw a line in light yellow
dLine(IMG_Drawing, 10, 10, 50, 50, LightYellow)

Sintaxis

dLine([<Image>, ] <X1> , <Y1> , <X2> , <Y2> [, <Line color> [, <Line thickness>]])

<Image>: Nombre de control opcional o variable de tipo Image, WDPic o picLayer opcional

Imagen a manipular. Esta imagen puede corresponder a:
el nombre de un control Imagen.
el nombre de una variable de tipo Image.
el nombre de una variable de tipo WDPic. Solo se manipulará la capa de fondo.
el nombre de una variable de tipo picLayer.
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) del punto inicial de la línea.

<Y1>: Entero

Coordenada Y (en pixeles) del punto inicial de la línea.

<X2>: Entero

Coordenada X (en pixeles) del punto final de la línea.

<Y2>: Entero

Coordenada Y (en pixeles) del punto final de la línea.

<Line color>: Entero o constante (opcional)

Color de la línea. Este color puede corresponder a:
un color RGB (devuelto por la función RGB),
un color HSL (devuelto por la función HSL),
un color predefinido de WLanguage,
una variable de tipo Color.
Si no se especifica este parámetro, el color de la línea:
es Transparente si no se ha utilizado previamente la función dPen.
Novedad versión 2024
Para una variable de tipo Image, el color de la línea será negro.
corresponde al color especificado en la última llamada a la función dPen.

<Line thickness>: Entero opcional

Grosor (en pixeles) de la línea a dibujar. Si no se especifica este parámetro, el valor tenido en cuenta puede ser:
el último valor especificado en la última llamada a la función dPen.
1 si no se ha utilizado la función dPen previamente.

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.
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

Ver también

Versión mínima requerida

Versión 9

Esta página también está disponible para…

Comentarios

Haga clic en [Agregar] para publicar un comentario

Última modificación: 12/02/2024

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