dPolyline (Función)

AYUDA EN LÍNEA
WINDEV, WEBDEV Y WINDEV MOBILE

Versión:

Inicio | Iniciar sesión | Español

Este contenido se ha traducido automáticamente. Haga clic aquí para ver la versión en inglés.

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

Coordenadas
Uso de las funciones de dibujo
Dibujo en PHP
Dibujo en código Navegador

WINDEV

WEBDEV

WINDEV Mobile

Otros

Ver también

dPolyline (Función)

Dibuja una línea compuesta de varios segmentos:

en un control Imagen,
en una variable de tipo Imagen.
Este tipo de variable no está disponible.
en una variable de tipo WDPic (en la capa de fondo),
en una variable de tipo picLayer.

La primera coordenada indica el punto de partida del primer segmento, luego cada coordenada indica el final del segmento anterior y el inicio del siguiente segmento.

Ejemplo

dStartDrawing(IMG_Dessin)
// Dessine un trait vert en pointillés d'une épaisseur de 4 pixels
dPen(DarkGreen, 2, 4)
// Ligne composée de 4 segments
dPolyline(4, 10, 100, 50, 60, 80, 90, 150, 13)

dStartDrawing(IMG_Dessin)
dPen(DarkGreen, 2, 4) 
// Dessin d'une ligne à partir d'un tableau de coordonnées de points (syntaxe 2)
tabCoordonnéesXY is array of 0 by 2 int = [[2, 3], [14, 100], [10,70], [50, 80]]
dPolyline(tabCoordonnéesXY)

dPen(IMG_Dessin, DarkGreen, 2, 4) 
tabCoordonnéesXY2 is array of 0 int = [2, 2, 140, 2, 150, 70, 0, 100, 200, 100]
dPolyline(IMG_Dessin, tabCoordonnéesXY2)

Sintaxis

Construir una línea punto por punto Ocultar los detalles

dPolyline([<Image>, ] <NbPoint> , <X1> , <Y1> , <X2> , <Y2> [, <Xn> [, <Yn> [, <Line color>]]])

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

<NbPoint>: Integro

Número de segmentos de la línea. Este parámetro define el número de parejas <X>, <Y> a especificar en la función.

<X1>: Integro

Coordenada X del primer segmento de la línea. Estas coordenadas se expresan en pixeles.

<Y1>: Integro

Coordenada Y del primer segmento de la línea. Estas coordenadas se expresan en pixeles.

<X2>: Integro

Coordenada X del segundo segmento de la recta. Estas coordenadas se expresan en pixeles.

<Y2>: Integro

Coordenada Y del segundo segmento de la línea. Estas coordenadas se expresan en pixeles.

<Xn>: Entero opcional

Coordenada X del segmento N de la recta. Estas coordenadas se expresan en pixeles.

<Yn>: Entero opcional

Coordenada Y del segmento N de la línea. Estas coordenadas se expresan en pixeles.

<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.
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.
Para una variable de tipo Imagen, el color de la línea será negro.
corresponde al color especificado en la última llamada a la función dPen.

Construir una línea mediante un array de coordenadas X e Y Ocultar los detalles

dPolyline([<Image>, ] <Array of coordinates> [, <Line color>])

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

<Array of coordinates>: Array de enteros o puntos

Array WLanguage de números enteros que contiene las coordenadas de los segmentos que componen la línea. Los índices pares representan las coordenadas X, mientras que los impares representan las coordenadas Y de los puntos. Estas coordenadas se expresan en pixeles.

<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.
Para una variable de tipo Imagen, el color de la línea será negro.
corresponde al color especificado en la última llamada a la función dPen.

Construir una línea utilizando una variable de tipo Polygon Ocultar los detalles

dPolyline([<Image>, ] <Polygon> [, <Line color>])

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

<Polygon>: Variable de tipo Polygon

Nombre de la variable de tipo Polígono que describe los diferentes puntos del polígono.

<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.
Para una variable de tipo Imagen, el color de la línea será negro.
corresponde al color especificado en la última llamada a la función dPen.

Observaciones

Coordenadas

Las coordenadas se especifican con respecto a la esquina superior izquierda 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.

Dibujo en código Navegador

Algunas funciones de dibujo están disponibles en código Navegador. Las funciones de dibujo en código Navegador se basan en el estándar HTML 5. Más concretamente, en la etiqueta "canvas" de HTML 5.

Las funcionalidades de dibujo en código Navegador solo están disponibles en navegadores recientes (compatibles con el estándar HTML 5). Para saber si el navegador utilizado propone funcionalidades de dibujo, utilice la función DrawingAvailable.

Atención: Para utilizar las funciones de dibujo con Internet Explorer 9, el proyecto debe incluir la referencia en el archivo DTD. Para ello, el modo HTML debe ser "HTML 4.01 Transitional + DTD". Esta opción está disponible en la pestaña "Avanzado" de la ventana de descripción del proyecto.
Recordatorio: Para abrir la ventana de descripción del proyecto, en la pestaña "Proyecto", en el grupo "Proyecto", haga clic en "Descripción".

Caso especial: Dibujar en el navegador de un teléfono Android: Las funciones de dibujo del navegador solo están disponibles a partir de la versión 3 de Android.

Clasificación Lógica de negocio / UI: Código neutro

Componente: wd300pnt.dll

Ver también

Versión mínima requerida

Versión 24

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

Comentarios

Haga clic en [Agregar] para publicar un comentario

Última modificación: 30/05/2025

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