GdipGetRegionData()

Resultat.i = GdipGetRegionData(*region, *buffer.byte, bufferSize.i, @sizeFilled.i)

*region

[in] Pointeur sur un objet region existant.

*buffer

[out] Tableau d'octets qui recevra les données de la région.Ce pointeur peut être l'adresse d'un tableau d'octets PureBasic.

bufferSize.i

[in] Nombre entier non signé qui indique la taille en octets du buffer (paramètre *buffer). La taille du buffer peut être supérieure ou égal au nombre d'octets requis pour stocker les données de la région. Le nombre exact d'octets requis peut être déterminé en appelant la fonction GdipGetRegionDataSize().

sizeFilled.i

[out] sizeFilled recevra le nombre d'octets de données réellement reçu dans le buffer.

Une région stocke ses données de définitions sous la forme d'un tableau d'octets.

Cette fonction permet de retrouver le tableau de données ainsi que la taille réellement remplie du tableau (par la fonction).
Cette fonction est à utiliser avec la fonction GdipCreateRegionRgnData() qui permet de créer une région qui est définie par les données obtenues à partir d'une autre région.

Pour obtenir le tableau de données nécessaire pour créer la région ainsi que sa taille en mémoire (paramètre bufferSize), il faut utiliser d'abord la fonction GdipGetRegionDataSize() pour retrouver la taille du tableau. Lorsque les données de la région sont copiées dans le buffer, sizeFilled recevra le nombre d'octets de données réellement reçu dans le buffer.

L'exemple crée un path, lui ajoute une ellipse puis un rectangle, puis une région est créée à partir du path, le tableau de données de la région ainsi que sa taille sont retrouvés et une nouvelle région est créée depuis ces données puis la nouvelle région est remplie en bleu semi-transparent et affichée.

La fonction GdipSetPathFillMode() peut être utilisée pour modifier le mode de remplissage du path.