La función esri_featurelayer_setDefaultElementType establece el tipo de elemento predeterminado de una capa de entidades y, si es correcto, devuelve esa configuración.
Sintaxis
(esri_featurelayer_setDefaultElementType flname subtype element_settings)
Argumentos
- flname | cadena de caracteres | obligatorio | El nombre de una capa de entidades existente en el dibujo.
- subtype | cadena de caracteres | obligatorio | Nombre de subtipo de capa de entidad existente en el dibujo. Utilice "" para una cadena de caracteres vacía si no se proporciona ningún subtipo.
- element_settings | lista asociada | obligatorio | Una lista asociada de configuraciones como pares de puntos definidos del siguiente modo:
| Etiqueta asociada | Tipo de valor | Descripción del valor | Obligatorio u opcional |
|---|---|---|---|
| TYPE | Cadena de caracteres | El valor de tipo es el tipo de entidad de AutoCAD o Civil 3D utilizado cuando se crean nuevas entidades en ArcGIS for AutoCAD. Los valores válidos son POINT, Block Reference y AECC_COGO_POINT. Para las tramas de polígonos, los valores de tipo son Hatch y Automatic. Automatic omite cualquier símbolo de relleno de trama para polígonos. | Requerido |
| DESCRIPTION | Cadena de caracteres | Nombre de bloque si el tipo es Block Reference, descripción si el tipo es AECC_COGO_POINT o nombre de patrón de trama para polígonos. | Requerido |
Uso de ejemplo
En este ejemplo se establece la configuración predeterminada del elemento de una capa de entidades denominada Damage_to_Residential_Buildings sin subtipo para que sea una referencia de bloque AutoCAD denominada Damaged_Structure.(esri_featurelayer_setDefaultElementType
"Damage_to_Residential_Buildings"
""
(list (cons "TYPE" "Block Reference") (cons "DESCRIPTION" "Damaged_Structure"))
)
Uso de ejemplo de resultado
En este ejemplo se establece el tipo de elemento predeterminado de la capa de entidades y se devuelve el argumento element_settings como una lista asociada:
(("TYPE"."Block Reference")("DESCRIPTION"."Damaged_Structure"))Valores de retorno
Los siguientes son los valores de retorno posibles:
- Si todo va bien, se devuelve una lista asociada en la que el valor TYPE es el tipo de entidad POINT, Block Reference o COGO Point para puntos y multipuntos o Hatch o Automatic para polígonos, y el valor de DESCRIPTION es el nombre de referencia de bloque, el prefijo de descripción del punto COGO o el nombre del patrón de trama.
- Si se produce un error, devuelve una lista con el primer valor de nil y, a continuación, se devuelve una lista asociada que contiene el valor de clave Error y un mensaje de error asociado como cadena de caracteres: (nil ( "Error" . "<message>")).
Valores de retorno fallido
Se puede producir un valor de retorno fallido por cualquiera de los siguientes motivos:
- (nil ("Error" . "Missing required argument."))
No se proporcionó uno de los tres argumentos requeridos.
- (nil ("Error" . "Unsupported geometry type."))
La función funciona con capas de puntos, multipuntos y de polígonos.
- (nil ("Error" . "No feature layer specified."))
No se ha proporcionado ninguna capa de entidades válida.
- (nil ("Error" . "Feature layer not found."))
La capa de entidades especificada no existe en el archivo.
- (nil ("Error" . "Subtype name does not exist."))
El subtipo especificado no existe.
- (nil ("Error" . "Incorrect argument."))
El valor TYPE especificado podría ser un tipo no válido.