:: com :: sun :: star :: container ::

interface XNameAccess
Base Hierarchy
::com::sun::star::uno::XInterface
 |
 +-XElementAccess
    |
    +-XNameAccess
Description
is used to access named objects within a container.

To implement inaccurate name access, support the ::com::sun::star::beans::XExactName interface.

See also
::com::sun::star::beans::XExactName
Developers Guide
3.3.3 Professional UNO - UNO Concepts - Using UNO Interfaces - Collections and Containers

Methods' Summary
getByName
getElementNames
hasByName
Methods' Details
getByName
any
getByName(
 
[in] string 

raises(

 
aName ) 
NoSuchElementException,
::com::sun::star::lang::WrappedTargetException );

Returns
the object with the specified name.
Parameter aName
the name of the object.
Throws
NoSuchElementException if an element under Name does not exist.
Throws
com::sun::star::lang::WrappedTargetException If the implementation has internal reasons for exceptions, then wrap these in a ::com::sun::star::lang::WrappedTargetException exception.
getElementNames
sequence< string >
getElementNames();
 
 

Returns
a sequence of all element names in this container.

The order of the names is not specified.

hasByName
boolean
hasByName(
 
[in] string
 
aName );

Returns
true if an element with this name is in the container, false otherwise.

In many cases the next call is XNameAccess::getByName . You should optimize this case.

Parameter aName
the name of the object.
Top of Page