Die Methode FeatureLayer.ElevateToField ändert die Z-Koordinaten von Objekten des angegebenen Feature-Layers und aller TEXT-Objekte, die mit diesen Features verknüpft sind.
- Ohne einen Auswahlsatz werden alle Features des Feature-Layers geändert.
- Diese Funktion unterstützt Objekte aus Punkt-, Polylinien-, Polygon-Feature-Layer und Annotations-Feature-Layern.
Deklaration
public int? Esri.ArcGISForAutoCAD.FeatureLayer.ElevateToField(Document doc, string flName, string field, string fieldUnits = null, double? zFactor = null, SelectionSet selectionSet = null)
Parameter
| Typ | Name | Beschreibung | Erforderlich |
|---|---|---|---|
Dokument | doc | Das AutoCAD-Dokument, das bearbeitet werden soll. | Erforderlich |
Zeichenfolge | flName | Ein vorhandener Feature-Layer-Name in der Zeichnung. | Erforderlich |
Zeichenfolge | field | Ein numerisches Feature-Attributfeld. | Erforderlich |
string | fieldUnits | Die Maßeinheit: "Feet", "USFeet" oder "Meters". | Optional (standardmäßig auf Ihre Karteneinheiten festgelegt) |
Double | zFactor | Der Wert, mit dem der field-Wert jedes Features multipliziert wird, um die Höhe zu bestimmen. Dieser Parameter überschreibt den Parameter fieldUnits. | Optional (Standard: 1,0) |
SelectionSet | selectionSet | Der AutoCAD-Auswahlsatz, mit dem festgelegt wird, welche Features geändert werden. Wenn kein Wert angegeben wird, werden alle Features des Features-Layers geändert. | Optional (Standard ist ALL Features des Feature-Layers) |
Rückgaben
| Typ | Beschreibung |
|---|---|
Int? | Die Anzahl der geänderten Objekte. |
Anmerkungen zu Fehlerbedingungen
Diese Methode kann eine Ausnahme auslösen, 0 oder null zurückgeben, wenn ein Parameter ungültig ist.
Beispiel 1
Ändern der Höhe aller Features des Feature-Layers "Contours" basierend auf dem Feature-Attributfeld Elevation und Ausgeben der Anzahl der geänderten Features.// 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
*/
Beispiel 2
Ändern der Höhe eines ausgewählten Satzes von Features im Feature-Layer "Spot_Elevation", wobei die im Feld Elevation gespeicherten Höhen mit einem Skalierungsfaktor multipliziert werden müssen, um die Umrechnung von Metern in Fuß zu berücksichtigen, und Ausgeben der Anzahl der geänderten Features.// 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
*/
Weitere Informationen
esri_featurelayer_elevatetofield: Eine AutoLISP-Funktion, die die Z-Koordinaten der Objekte des angegebenen Feature-Layers und aller TEXT-Objekte, die mit diesen Features verknüpft sind, zurückgibt.