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:
•
|
Tipo: Cadena (hasta 30 caracteres de largo)
|
|
|
Delete (
short index)
|
Vacío
|
Elimina el ítem en la referencia seleccionada.
Parámetros:
|
|
DeleteAt (
short index,
boolean Refresh)
|
Vacío
|
Elimina el ítem en el índice seleccionado. El segundo parámetro está actualmente en desuso.
Parámetros:
|
|
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:
|
|
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:
|
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.
|
|
|