# Set Region

Définit un contrôle de modification de région contenu dans une cellule ; le contrôle de modification de région est toujours une fonction EditRegion.

## Set Region – entrées

Syntaxe : SR[NomBalise][Espace][X][Espace][Y][Espace][Largeur][Espace][Hauteur][Espace][Angle][Espace][Courbure]

Paramètre | Description
--- | ---
NomBalise | Le nom publié de la cellule.
Espace | Un espace pour séparer cette valeur de la valeur suivante.
Ligne | Le décalage en x de l’origine, en coordonnées d’image.
Espace | Un espace pour séparer cette valeur de la valeur suivante.
Col | Le décalage y de l’origine, en coordonnées d’image.
Espace | Un espace pour séparer cette valeur de la valeur suivante.
Hauteur | La dimension le long de l’axe des x de la région.
Espace | Un espace pour séparer cette valeur de la valeur suivante.
Largeur | La dimension le long de l’axe des y de la région.
Espace | Un espace pour séparer cette valeur de la valeur suivante.
Angle | Orientation de l’image.
Espace | Un espace pour séparer cette valeur de la valeur suivante.
Courbure | La courbure de la région.

## Set Region – sorties

Renvoie un code d’état. Les codes d’état sont :

Codes d’état | Description
--- | ---
1 | La commande a été exécutée avec succès.
0 | La commande est inconnue.
-1 | L’ID n’est pas valide.
-2 | La commande n’a pas pu être exécutée parce que la cellule spécifiée ne contient pas de contrôle de modification de région ou le contrôle de modification de région n’a pas été créé par la fonction EditRegion.
-4 | Type d’argument erroné.
-6 | L’utilisateur ne dispose pas de l’accès complet nécessaire à l’exécution de la commande.

## Set Region – exemple

Vous pouvez définir la région d’un emplacement EasyBuilder ou d’un outil d’inspection en envoyant une commande Set Region contenant la position, les dimensions, l’orientation et la forme de la nouvelle région.

1. Supposons que votre projet contienne un outil de recherche de transition et que la région de l’outil se trouve actuellement dans une autre position, avec des dimensions, une orientation et une forme différentes.

2. Vous souhaiterez alors déplacer et réorienter les paramètres de région de l’outil avec la commande en mode natif Set Region. Envoyez la commande SREdge_1.Region 192.000 119.000 167.000 20 0.5 0:

3. Le système de vision In-Sight répond par 1, ce qui indique que la commande a été exécutée avec succès.