FormContains (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

New WINDEV, WEBDEV and WINDEV Mobile 2024 feature!

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / Managing databases / HFSQL /

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

FormContains (Function)

In french: GeometryContain

Permet de savoir si une géométrie A contient une géométrie B.

Remarques :

Si la géométrie A contient la géométrie B, cela signifie que la géométrie B est complètement dans la géométrie A. Dans ce cas :
- Il n'existe pas de point de la géométrie B dans l'extérieur de la géométrie A : tout point de la géométrie B est soit dans l'intérieur de la géométrie A, soit dans son contour.
- Il existe au moins un point de l'intérieur de la géométrie B dans l'intérieur de la géométrie A.
Différence par rapport à la fonction GéométrieCouvre : Avec la fonction GéométrieCouvre, il n'est pas nécessaire d'avoir un point de l'intérieur de géométrie B à l'intérieur de géométrie A. Un polygone couvre son contour, mais il ne le contient pas.

Example

oPolygone2D_1 is Polygon2D
Linestring2DAddPoint(oPolygone2D_1.Outline, -4.00, -4.00)
Linestring2DAddPoint(oPolygone2D_1.Outline, -4.00, 2.00)
Linestring2DAddPoint(oPolygone2D_1.Outline, 5.00, 2.00)
Linestring2DAddPoint(oPolygone2D_1.Outline, 5.00, -4.00)
// Ajout du dernier point (identique au premier)
Linestring2DAddPoint(oPolygone2D_1.Outline, -4.00, -4.00)

oPolygone2D_2 is Polygon2D
Linestring2DAddPoint(oPolygone2D_2.Outline, -1.00, -2.00)
Linestring2DAddPoint(oPolygone2D_2.Outline, 2.00, 0.00)
Linestring2DAddPoint(oPolygone2D_2.Outline, 2.00, -2.00)
// Ajout du dernier point (identique au premier)
Linestring2DAddPoint(oPolygone2D_2.Outline, -1.00, -2.00)

let p2_dans_p1 = GeometryContain(oPolygone2D_1, oPolygone2D_2) // Renvoie "vrai"
GeometryWithin(oPolygone2D_2, oPolygone2D_1) // Renvoie "vrai"

Syntax

<Résultat> = GéométrieContient(<Géométrie A> , <Géométrie B>)

<Résultat>: Booléen

Vrai si la géométrie A contient la géométrie B,
Faux dans le cas contraire.
En cas d'erreur, la variable ErreurDétectée est à Vrai. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.

<Géométrie A>: Variable correspondant à des données spatiales

Nom de la variable correspondant à la géométrie dont on veut savoir si elle contient la géométrie B. Cette géométrie peut correspondre à un des types de variables suivants :
PointGéo.
Point2D.
PolyligneGéo.
Polyligne2D.
PolygoneGéo.
Polygone2D.
MultiPointGéo.
MultiPoint2D.
MultiPolyligneGéo.
MultiPolyligne2D.
MultiPolygoneGéo.
MultiPolygone2D.

<Géométrie B>: Variable correspondant à des données spatiales

Nom de la variable correspondant à la seconde géométrie manipulée. Cette géométrie peut correspondre à un des types de variables suivants :
PointGéo.
Point2D.
PolyligneGéo.
Polyligne2D.
PolygoneGéo.
Polygone2D.
MultiPointGéo.
MultiPoint2D.
MultiPolyligneGéo.
MultiPolyligne2D.
MultiPolygoneGéo.
MultiPolygone2D.

Remarks

Exemple :

// Définition d'un triangle délimitant une zone géographique
// Mémorisation de ce triangle dans une variable de type PolygoneGéo 
polyGeo is PolygonGeo
polyGeo.Contour.AjoutePoint(0n48.8187479172765, 0n1.9550104465229536)
polyGeo.Contour.AjoutePoint(0n48.685649220185574, 0n2.023674998054354)
polyGeo.Contour.AjoutePoint(0n48.82612543243871, 0n2.2106580854197566)
polyGeo = GeometryCorrect(polyGeo)

// Recherche des communes qui ont leur territoire contenu entièrement dans le triangle ciblé
nbEnregs is int
FOR EACH DatasCommunes where GeometryContain(DatasCommunes.geometry, polyGeo) 
	// Nom de la commune dans une trace
	Trace(DatasCommunes.NomCommune)
END

Business / UI classification: Business Logic

Component: wd290hf.dll