GdipIsVisibleRegionRect()



Syntaxe
Resultat.i = GdipIsVisibleRegionRect(*region, x.f, y.f, width.f, height.f, *graphics, @result.i)
Paramètres
*region

[in] Pointeur sur un objet region existant.

x.f

[in] Coordonnée x (nombre flottant) de l'angle supérieur gauche du rectangle à tester.

y.f

[in] Coordonnée y (nombre flottant) de l'angle supérieur gauche du rectangle à tester.

width.f

[in] Largeur du rectangle (nombre flottant) à tester.

height.f

[in] Hauteur du rectangle (nombre flottant) à tester.

*graphics

[in] Pointeur sur un objet Graphics existant. Ce paramètre peut être mis à #Null

result.i

[out] Variable qui recevra le résultat du test.

Description

Cette fonction permet de déterminer si le rectangle défini par les paramètres X, Y, width et height coupe la région.
Le graphique contient les transformations world et de page nécessaires pour calculer les coordonnées du périphérique pour la région concernée ainsi que pour le rectangle à tester. Si *graphics vaut #Null, aucune transformation n'est appliquée pour calculer ces coordonnées.

S'il y a intersection, result vaut #True sinon result vaut #False.

L'exemple crée une zone de découpage en forme de secteur (camembert), la remplie en bleu. Il y a un rectangle qui suit le curseur et que l'on peut redimensionner avec la molette de la souris. Les coordonnées du rectangle sont affichées dans la barre de titre de la fenêtre et lorsque le rectangle a une intersection avec la zone visible découpage, on affiche une chaîne qui l'indique dans la statusbar, sinon on affiche une chaîne indiquant le contraire.

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