FeatureLayer.ElevateToField (.NET)

La méthode FeatureLayer.ElevateToField modifie les coordonnées z des entités de la couche d’entités spécifiée et de toutes les entités TEXT liées à ces entités.

• Si aucun ensemble de sélection n’est inclus, toutes les entités de la couche d’entités sont modifiées.
• Cette fonction prend en charge les entités des couches d’entités ponctuelles, polylignes, surfaciques et annotations.

Déclaration

public int? Esri.ArcGISForAutoCAD.FeatureLayer.ElevateToField(Document doc, string flName, string field, string fieldUnits = null, double? zFactor = null, SelectionSet selectionSet = null)

Paramètres

Type	Nom	Description	Requis
Document	doc	Document AutoCAD sur lequel intervenir.	required
chaîne	flName	Nom d’une couche d’entités existante dans le dessin.	required
chaîne	field	Champ attributaire d’une entité numérique.	required
chaîne	fieldUnits	Unité de mesure : "Feet", "USFeet" ou "Meters".	facultatif (défini par défaut sur les unités de la carte)
réel double	zFactor	Multiplicateur de la valeur field de chaque entité pour la détermination de l’élévation. Ce paramètre remplace le paramètre fieldUnits.	facultatif (valeur par défaut : 1,0)
SelectionSet	selectionSet	Ensemble de sélection AutoCAD permettant de limiter les entités à modifier. Si aucune valeur n’est indiquée, toutes les entités de la couche d’entités sont modifiées.	facultatif (par défaut, les entités ALL de la couche d’entités)

Retours

Type	Description
int?	Nombre d’entités modifiées.

Remarques sur les conditions d’erreur

Si un paramètre n’est pas valide, cette méthode peut générer une exception, ou renvoyer 0 ou null.

Exemple 1

Modifier l’élévation de toutes les entités de la couche d’entités Contours (Isolignes) en fonction du champ attributaire de l’entité Elevation et affiche le nombre d’entités modifiées.

// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;

// Modify the z-values of the features
var count = Esri.ArcGISForAutoCAD.FeatureLayer.ElevateToField(doc, "Contours", "Elevation");

// Print the number of features with modified z-values
doc.Editor.WriteMessage ("Number of modified features: " + count);

/* Example output
Number of modified features: 49
*/

Exemple 2

Modifier l’élévation d’un ensemble d’entités sélectionnées dans la couche d’entités Spot_Elevation (Point côté), pour lesquelles les élévations stockées dans le champ Elevation doivent être multipliées par un facteur d’échelle afin d’effectuer la conversion des mètres en pieds, et affiche le nombre d’entités modifiées.

// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;
var selectionSet = doc.Editor.GetSelection().Value;

// Modify the z-values of the selected features
var count = Esri.ArcGISForAutoCAD.FeatureLayer.ElevateToField(doc, "Spot_Elevation", "Elevation", null, 3.28084, selectionSet);

// Print the number of features with modified z-values
doc.Editor.WriteMessage("Number of modified features: " + count);

/* Example output
Number of modified features: 3
*/

Voir aussi

esri_featurelayer_elevatetofield : fonction AutoLISP qui modifie les coordonnées z des entités de la couche d’entités spécifiée et de toutes les entités TEXT liées à ces entités.