version 6.0
dr_POLYGONE VERS TABLEAU (zone; cible; tableauH; tableauV; bézier)
| Paramètre | Type | Description | |
| zone | Entier long | Zone 4D Draw | |
| cible | Entier long | -1 = Objet placé au dernier plan du document, | |
| 0 = Objet placé au dernier plan de la sélection, | |||
| >0 = ID d'objet | |||
| tableauH | Tableau num | Tableau contenant les valeurs horizontales | |
| tableauV | Tableau num | Tableau contenant les valeurs verticales | |
| bézier | Tableau num | 1 = poignée de Bézier, 0 = pas une poignée de Bézier |
Description
La commande dr_POLYGONE VERS TABLEAU retourne dans tableauH et tableauV la position de chaque sommet du polygone désigné par cible (sommet = clic souris indiquant un arrêt dans le tracé du polygone).
Si cible est égal à -1, dr_POLYGONE VERS TABLEAU retourne la position des sommets du polygone placé au dernier plan.
Si cible est égal à 0, dr_POLYGONE VERS TABLEAU retourne la position des sommets du polygone placé au dernier plan de la sélection.
Si cible est supérieur à 0, dr_POLYGONE VERS TABLEAU interprète la valeur passée comme étant le numéro d'identification d'un objet et renvoie la position de ses sommets. Si l'objet n'existe pas, dr_POLYGONE VERS TABLEAU retourne deux tableaux vides et dr_Erreur renvoie l'erreur n°2.
Si l'objet désigné par cible n'est pas un polygone, dr_POLYGONE VERS TABLEAU retourne deux tableaux vides et dr_Erreur renvoie l'erreur n°47.
tableauH et tableauV contiennent respectivement les positions horizontales et verticales des différents points du polygone désigné par cible. Ces valeurs sont exprimées dans l'unité de base, si vous souhaitez les convertir dans l'unité de l'échelle, utilisez la commande dr_TABLEAU BASE VERS ECHELLE.
tableauH et tableauV peuvent être de type Numérique (Réel), Entier ou Entier long. Dans tous les cas, ils devront être initialisés avant l'appel de la commande dr_POLYGONE VERS TABLEAU. Si vous utilisez des tableaux de type Entier ou Entier long, vos valeurs seront arrondies.
Le paramètre bézier permet de déterminer si une poignée est une poignée de Bézier. Les poignées de Bézier peuvent être créées à l'aide de la commande dr_COURBE POLYGONE.
Exemple
L'exemple suivant permet de connaître la position des sommets du polygone sélectionné et de renvoyer, à l'aide de la commande dr_TABLEAU VERS SELECTION, le contenu des tableaux dans des champs.
TABLEAU REEL(TableauH;0) TABLEAU REEL(TableauV;0) dr_POLYGONE VERS TABLEAU (LaZone;0;TableauH;TableauV;Bezier) Si (0=dr_Erreur) TABLEAU VERS SELECTION(TableauH;[Polygone]PositionH;TableauV;[Polygone]PositionV) Fin de si
Référence
dr_Lire type, dr_Tableau vers polygone.