esri_feature_SetMValue (AutoLISP)

La fonction esri_feature_SetMValue définit la valeur m du sommet. Elle peut remplacer une valeur existante.

Syntaxe

(esri_feature_SetMValue ename mValue)

Arguments

• ename | nom d’entité AutoCAD | obligatoire | Nom d’entité AutoCAD de la sous-entité sommet polylinéaire 2D ou 3D d’une entité.
• mValue | double | obligatoire | Nouvelle valeur qui est le double de la valeur m du sommet.

Exemple d’utilisation

Définit la valeur m du premier sommet de l’entité sélectionnée surr 1,96.

(esri_feature_setmvalue (caar (esri_feature_mvalues (car (entsel)))) 1.96)

Exemple d’utilisation du résultat

Définit la valeur m du premier sommet de l’entité sélectionnée et renvoie une liste de valeurs True.

(T)

Valeurs renvoyées

Voici les valeurs de renvoi possibles :

• En cas de réussite, la fonction renvoie une liste de valeurs True : (T).
• En cas d’échec, elle renvoie une liste dont la première valeur est nil, puis une liste associée contenant la valeur de clé Error et un message d’erreur associé sous forme de chaîne : (nil ("Error" . "<message>")).

Valeurs d’échec renvoyées

Un échec peut être dû par exemple aux raisons suivantes :

• (nil ("Error" . "Missing required argument."))

  Un ou plusieurs des arguments obligatoires n’ont pas été fournis.

• (nil ("Error" . " Incorrect argument."))

  Le type de l’argument fourni n’est pas celui attendu.

Voir aussi

esri_feature_MValues : fonction AutoLISP qui renvoie une liste associée de noms de sous-entités sommet et leurs valeurs m sous forme d’une liste associée.