GdipIsOutlineVisiblePathPoint()



Syntaxe
Resultat.i = GdipIsOutlineVisiblePathPoint(*path, x.f, y.f, *pen, *graphics, @result.i)
Paramètres
*path

[in] Pointeur sur un objet GraphicsPath.

x.f

[in] Coordonnée x (nombre flottant) du point à tester.

y.f

[in] Coordonnée y (nombre flottant) du point à tester.

*pen

[in] Pointeur sur un objet Pen.
La fonction détermine si le point test (paramètres x.f et y.f) touche le contour du GraphicsPath qui serait dessiné par ce Pen. Plus la largeur du pen est grande, plus le nombre de points touchant le contour est important.

*graphics

[in] Pointeur sur un objet graphics.
La fonction détermine si le point test (paramètres x.f et y.f) touche le contour du GraphicsPath avec la matrice de transformation du paramètre *graphics appliquée au GraphicsPath de manière temporaire lors du test. La transformation du paramètre *graphics est de type world-to-device. Ce paramètre peut être mis à #Null; dans ce cas le test est fait en world coordinates.

result.i

[out] Variable qui recevra le résultat du test. Si le point à tester touche le contour du GraphicsPath, result vaudra #True sinon result vaudra #False.

Description
Cette fonction permet de tester si le point défini par les coordonnées x et y touche le contour du Path passé en paramètre. Les paramètres *pen et *graphics influencent le résultat du test (voir la description des paramètres).

La fonction exécute un test sans que le GraphicsPath ne soit réellement modifié par les deux paramètres *pen et *graphics. Ces valeurs ne sont utilisées que pour le test.

Le fichier d'exemple trace un contour avec un pen rouge d'une largeur de 6. En déplaçant la souris, on affiche les coordonnées ainsi que le fait que le point pointé par la souris appartient ou non au contour du tracé.

Résultat de la fonction
Si la fonction réussit, elle retourne #Ok qui est une constante de l'énumération status.
Si la fonction échoue, elle retourne une des autres valeurs de l'énumération status.
PB - OS
PureBasic v4.30 bêta 4 (Windows - x86)
Testé avec Windows Vista édition familiale Premium