Clase de Colección [Guía de Usuario de Enterprise Architect]

Top Previous Next

Clase de Colección

button_main button_prev button_next

Colección es la Clase de colección principal utilizada por todos los elementos dentro de la Interfaz de Automatización. Contiene métodos para iterar a través de una colección, actualice la colección y elimine un ítem de la colección.

Es importante darse cuenta cuando se llama AddNew, el ítem no es agregado automáticamente a la colección actual. Los pasos típicos son:

Llamada AddNew para agregar un nuevo ítem

Modificar el ítem como sea requerido

Llamada Actualizar en el ítem para guardarlo en la base de datos

Llamada Actualizar en la colección para incluirla en el conjunto actual

 

Eliminar es el mismo; hasta que se llama Actualizar, la colección todavía contiene una referencia al ítem eliminado, que no debería ser llamada.

Cada método puede ser utilizado para iterar a través de la colección para lenguajes que soportan este tipo de construcción.

Atributos de Colección

Atributo

Tipo

Notas

 

Cuenta

Short

Sólo lectura

El número de objetos referenciados por esta lista.

 

 

ObjectType

ObjectType

Sólo lectura

Distingue objetos referidos a través de una interfaz de Envío.

 

ObjectType

Métodos de Colección

Método

Tipo

Notas

Ver También

AddNew (

string Name,

string Type)

Objeto

Agrega un nuevo ítem a la colección actual.

Note que la interfaz es la misma para todas las colecciones; debe proporcionar un argumento de Nombre y Tipo . Para que son utilizados estos argumentos depende de la colección real que está siendo accedida. Por ejemplo, al agregar un nuevo elemento a la colección de Elementos, la cadena Tipo puede ser un tipo de elemento UML básico o un tipo de elemento completamente calificado (estereotipo) definido por un perfil, tal como SysML::Requisito, diferenciándolo de un requisito estándar.

También note que debe llamar aUpdate() en el objeto devuelto para completar AddNew. Si no se llama Update() el objeto queda en un estado indeterminado.

Parámetros:

Nombre: String

Tipo: Cadena (hasta 30 caracteres de largo)

 

 

Delete (

short index)

Vacío

Elimina el ítem en la referencia seleccionada.

Parámetros:

Índice: Short

 

 

DeleteAt (

short index,

boolean Refresh)

Vacío

Elimina el ítem en el índice seleccionado. El segundo parámetro está actualmente en desuso.

Parámetros:

Índice: Short

Actualizar: Boolean

 

 

GetAt (

short index)

Objeto

Recupera el objeto arreglo utilizando un índice numérico. SI el índice está fuera de los límites, ocurre un error.

Parámetros:

Índice: Short

 

 

GetByName (

string Name)

Objeto

Obtiene un ítem en la colección actual por nombre.

Si la colección no contiene ningún ítem, el método devuelve un valor nulo. Si la colección contiene ítems, pero no fue capaz de encontrar un objeto con el nombre especificado, el método lanza una excepción.

Sólo soportado para las siguientes colecciones: Modelo, Paquete, Elemento, Diagrama y elemento Valor Etiquetado.

Parámetros:

Nombre: String

 

Clase Paquete

Clase de Elemento

Clase Diagrama

Clase TaggedValue

GetLastError ()

String

Devuelve un valor de string describiendo el error más reciente que ocurrió en relación con este objeto.

 

 

Refresh ()

Vacío

Actualiza la colección al volver a consultar el modelo y volver a cargar la colección. Debería ser llamado después de agregar un nuevo ítem o después de eliminar un ítem.

 

 

Update ()

Boolean

Actualiza el objeto de Colección actual después de modificar o anexar un nuevo ítem.

Si se devuelve falso, revise la función GetLastError () para más información.