El método FeatureLayer.ElevateToField modifica las coordenadas z de las entidades de la capa de entidades especificada y cualquier entidad de TEXT vinculada a esas entidades.
- Si no se incluye ningún conjunto de selección, se modificarán todas las entidades de la capa de entidades.
- Esta función es compatible con entidades de capas de entidades de punto, polilínea, polígono y anotación.
Declaración
public int? Esri.ArcGISForAutoCAD.FeatureLayer.ElevateToField(Document doc, string flName, string field, string fieldUnits = null, double? zFactor = null, SelectionSet selectionSet = null)
Parámetros
| Tipo | Nombre | Descripción | Requerido |
|---|---|---|---|
Documento | doc | Documento de AutoCAD sobre el que se va a actuar. | obligatorio |
cadena | flName | Nombre de capa de entidades existente en el dibujo. | obligatorio |
cadena | field | Campo de atributos de entidades numérico. | obligatorio |
cadena | fieldUnits | Unidad de medida: "Feet", "USFeet" o "Meters". | opcional (configuración predeterminada de las unidades del mapa) |
doble | zFactor | Cantidad por la que se multiplica el valor de field de cada entidad para determinar la elevación. Este parámetro invalida el parámetro fieldUnits. | opcional (1,0 predeterminado) |
SelectionSet | selectionSet | Conjunto de selección de AutoCAD para limitar las entidades que se modificarán. Si no se proporciona ningún valor, se modificarán todas las entidades de la capa de entidades. | opcional (entidades ALL predeterminadas de la capa de entidades) |
Devoluciones
| Tipo | Descripción |
|---|---|
int? | Recuento de las entidades modificadas. |
Observaciones sobre las condiciones de error
Este método puede generar una excepción o devolver 0 o null si un parámetro no es válido.
Ejemplo 1
Modifique la elevación de todas las entidades de la capa de entidades de curvas de nivel en función del campo de atributo de entidad Elevation, e imprima el recuento de entidades modificadas.// 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
*/
Ejemplo 2
Modifique la elevación de un conjunto seleccionado de entidades en la capa de entidades Spot_Elevation, donde las elevaciones almacenadas en el campo Elevation deben multiplicarse por un factor de escala para realizar la conversión de metros a pies, e imprima el recuento de entidades modificadas.// 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
*/
Consulte también
esri_featurelayer_elevatetofield: función de AutoLISP que modifica las coordenadas z de las entidades de la capa de entidades especificada y cualquier entidad TEXT vinculada a esas entidades.