|
Collection
Clase Pública
Esta es la clase collection principal usada por todos los elementos con la interfaz de automatización. Contiene métodos para iterar a través de la collection, para actualizar la collection y para eliminar un ítem de la collection. Es importante darse cuenta que cuando se llama a AgegarNuevo, el ítem no se agrega automáticamente a la collection actual. Los pasos típicos son:
1. Llamar a AgregarNuevo para agregar un nuevo ítem
2. Modificar el ítem como se desee
3. Llamar a Update en el ítem para guardarlo en la base de datos
4. Llamar a Refresh en la collection para incluirla en el conjunto actual
La eliminación es bastante parecida -hasta que se llama a Refresh, la collection contendrá aún una referencia al item eliminado- la cual no se debería llamar.
Para cada uno - puede usarse para iterar a través de la collection para lenguajes que soportan este tipo de construcciones.
Atributos de Collection
Atributo
|
Tipo
|
Notas
|
Count
|
short
|
Solo lectura. El número de objetos referenciados por esta lista.
|
ObjectType
|
ObjectType
|
Solo lectura. Distingue los objetos de la interfaz de Despacho.
|
Métodos de Collection
Método
|
Tipo
|
Notas
|
GetAt (short)
|
Object
|
parámetro: índice [ short - in ]
Recupera el objeto arreglo usando un índice numérico; si el índice está fuera de los límites, se producirá un error.
|
Delete (short)
|
void
|
parámetro: índice [ short - in ]
Elimina el ítem en la referencia seleccionada
|
DeleteAt (Boolean, short)
|
void
|
parámetro: refresh [ Boolean - in ]
parámetro: índice [ short - in ]
Elimina el ítem en el índice seleccionado. También provee una opción para actualizar la collection después de la eliminación. No debería refrescar una collection mientras está recorriendola, porque se pueden alterar el contador y las posiciones de los ítems. No debería acceder al ítem en el índice seleccionado una vez que se eliminó porque se disparará una excepción.
|
GetLastError ()
|
String
|
Devuelve una cadena de caracteres describiendo el error más reciente que ocurrió en relación a este objeto.
Esta función se usa raramente debido a que disparará una excepción cuando se produzca un error.
|
GetByName (String)
|
Object
|
parámetro: Nombre [ String- in ]
Obtiene un ítem en la collection actual por un Nombre. Sólo se aplica a las siguientes colecciones: Modelos, Paquetes, Elementos, Diagramas y Valores Etiquetados.
|
Refresh ()
|
void
|
Refresque la collection al consultar nuevamente el modelo y cargar de nuevo la collection. Se debería llamar después de agregar un nuevo ítem o después de eliminar un ítem
|
AddNew (String, String)
|
Object
|
parámetro: Tipo [ String - in ]
parámetro: Nombre [ String - in ]
Agrega un nuevo ítem a la collection actual. Tenga en cuenta que la interfaz es la misma para todas las colecciones -debe proveer un Nombre y un tipo de Argumento-. Para qué se usan?depende del miembro de la collection actual. Tenga en cuenta también que debe llamar a Update() en el objeto de respuesta para completar a AddNew. Si no se llama a Update() el objeto se deja en un estado intermedio.
|
|