Accessors for class IliRepository

Description

Variable

IliRepository.dataSourcesCount

Functions

IliRepository.getDataSourc
IliRepository.getDataSourceAt
IliRepository.getScopeClass
IliRepository.setScopeClass

Verbose: The IliRepository object allows you to:

retrieve a data source given its name
enumerate all data sources available in the system

In addition, each time a global data source appears in the system, it becomes a property of the IliRepository object so that it can be accessed directly using the dot notation.

Type Name Description Notes

Int IliRepository Contains the number of available data sources. read-only

IliDataSource IliRepository Attempts to find a registered data source named name, which must be visible from the location of the near parameter.
The near parameter can be:

A container (IlvContainer)
A data source within the scope of the container is searched for.

An graphic object (IlvGraphic)
A data source within the scope of the holder (container or manager) in which this graphic object is located is searched for.

null
A global data source located in any container or manager is searched for.

Note that following Rogue Wave Views terminology, the holder of a graphic object designates the container or manager in which the graphic object is located.
The data source is searched for according to the following rules:

Same holder
If a data source named name exists in the same holder as the near parameter, this data source is returned. The scope of the data source can be local or global.

Same scope class
If the near parameter is a graphic located in a container or if it is itself a container and this container has been assigned a scope class, all containers with the same scope class are considered (see the IliRepository.setScopeClass function). If a data-source named name exists in any of these containers, this data source is returned. The scope of the data source can be local or global. If more than one data source matches, one is picked at random and returned.

Same container hierarchy
If the near parameter is a graphic object located in a holder, if it is a holder and the holder is contained in another holder, or if it contains other holders (this situation occurs when you use an IlvNotebook gadget: each notebook page contains a container), all containers and managers related directly or indirectly to the holder via the containment relation are considered. If a data source named name exists in any of of the holders, the data source is returned. The scope of the data source can be local or global. If more than one data source matches, one is picked at random and returned.

Global scope
If a global data source named name exists, this data source is returned. The scope of the data source must be global. If more than one data source matches, one is picked at random and returned.

Otherwise, the IliRepository.getDataSource function returns null.

IliDataSource IliRepository Returns the data source positioned at index, which must be >= 0 and < IliRepository.dataSourcesCount.

String IliRepository Returns the scope class assigned to the container cont. Initially, the scope class of a container is null.

Void IliRepository Adds the container cont to the scope class named scopeClass. If the scopeClass parameter is null, the container cont is removed from the scope class to which it was previously added.
Caution: This function should be called before any graphics are added to the container or else the repository subscription mechanism may not function properly.

Type	Name	Description	Notes
`Int`	`IliRepository`	Contains the number of available data sources.	read-only
`IliDataSource`	`IliRepository`	Attempts to find a registered data source named `name,` which must be visible from the location of the `near` parameter. The `near` parameter can be: A container (`IlvContainer`) A data source within the scope of the container is searched for. An graphic object (`IlvGraphic`) A data source within the scope of the holder (container or manager) in which this graphic object is located is searched for. null A global data source located in any container or manager is searched for. Note that following Rogue Wave Views terminology, the holder of a graphic object designates the container or manager in which the graphic object is located. The data source is searched for according to the following rules: Same holder If a data source named `name` exists in the same holder as the `near` parameter, this data source is returned. The scope of the data source can be local or global. Same scope class If the `near` parameter is a graphic located in a container or if it is itself a container and this container has been assigned a scope class, all containers with the same scope class are considered (see the `IliRepository.setScopeClass` function). If a data-source named `name` exists in any of these containers, this data source is returned. The scope of the data source can be local or global. If more than one data source matches, one is picked at random and returned. Same container hierarchy If the `near` parameter is a graphic object located in a holder, if it is a holder and the holder is contained in another holder, or if it contains other holders (this situation occurs when you use an `IlvNotebook` gadget: each notebook page contains a container), all containers and managers related directly or indirectly to the holder via the containment relation are considered. If a data source named `name` exists in any of of the holders, the data source is returned. The scope of the data source can be local or global. If more than one data source matches, one is picked at random and returned. Global scope If a global data source named `name` exists, this data source is returned. The scope of the data source must be global. If more than one data source matches, one is picked at random and returned. Otherwise, the `IliRepository.getDataSource` function returns `null`.
`IliDataSource`	`IliRepository`	Returns the data source positioned at `index,` which must be `>= 0` and `<` `IliRepository.dataSourcesCount`.
`String`	`IliRepository`	Returns the scope class assigned to the container `cont`. Initially, the scope class of a container is `null`.
`Void`	`IliRepository`	Adds the container `cont` to the scope class named `scopeClass.` If the `scopeClass` parameter is `null`, the container `cont` is removed from the scope class to which it was previously added. Caution: This function should be called before any graphics are added to the container or else the repository subscription mechanism may not function properly.