:: com :: sun :: star :: beans ::

interface XIntrospectionAccess
Base Interfaces
::com::sun::star::uno::XInterface
  |  
  +--XIntrospectionAccess
::com::sun::star::uno::XInterface
(referenced interface's summary:)
base interface of all UNO interfaces
Description
represents the result of an introspection operation done by the inspect method of ::com::sun::star::beans::XIntrospection .

This interface gives information about an object's properties and methods as detected in the introspection process. It's not possible to access properties or call methods directly using this interface but it provides access to other interfaces to do so. See ::com::sun::star::beans::XIntrospectionAccess::queryAdapter()

The ::com::sun::star::beans::XExactName interface has to be supported in order to implement inaccurate name access for all objects which implement the ::com::sun::star::container::XNameAccess interface or ::com::sun::star::beans::XPropertySet .

The ::com::sun::star::beans::XMaterialHolder interface has to be supported to give access to the inspected object.

See also
::com::sun::star::beans::XPropertySet
See also
::com::sun::star::beans::XExactName

Methods' Summary
getSuppliedMethodConcepts returns information about which method concepts described in the ::com::sun::star::beans::MethodConcept constants group are supported by this ::com::sun::star::beans::XIntrospectionAccess implementation.  
getSuppliedPropertyConcepts returns information about which property concepts described in the ::com::sun::star::beans::PropertyConcept constants group are supported by this ::com::sun::star::beans::XIntrospectionAccess implementation.  
getProperty returns information about a property if a property with the demanded name exists and if it accords to one of the demanded ::com::sun::star::beans::PropertyConcept s. The information is provided as ::com::sun::star::beans::Property struct.  
hasProperty allows to ask if a property with the demanded name exists and if it accords to one of the demanded ::com::sun::star::beans::PropertyConcept s.  
getProperties returns a sequence of properties of the introspected object  
getMethod returns information about a method if a method with the demanded name exists and if it accords to one of the demanded MethodConcepts. The information is provided as ::com::sun::star::reflection::XIdlMethod .  
hasMethod allows to ask if a method with the demanded name exists and if it accords to one of the demanded ::com::sun::star::beans::MethodConcept s.  
getMethods returns a sequence of methods of the introspected object.  
getSupportedListeners returns the listener types supported by the introspected object.  
queryAdapter creates an adapter that implements an interface with the specified type.  
Methods' Details
getSuppliedMethodConcepts
long
getSuppliedMethodConcepts();

Description
returns information about which method concepts described in the ::com::sun::star::beans::MethodConcept constants group are supported by this ::com::sun::star::beans::XIntrospectionAccess implementation.

The minimum supported concepts should be:

  • MethodConcept::PROPERTY ,
  • MethodConcept::LISTENER ,
  • MethodConcept::ENUMERATION ,
  • MethodConcept::NAMECONTAINER
  • MethodConcept::INDEXCONTAINER ;
Returns
zero or more constants of the ::com::sun::star::beans::MethodConcept constants group combined by an arithmetical or-operation.
getSuppliedPropertyConcepts
long
getSuppliedPropertyConcepts();

Description
returns information about which property concepts described in the ::com::sun::star::beans::PropertyConcept constants group are supported by this ::com::sun::star::beans::XIntrospectionAccess implementation.

The minimum supported concepts should be:

  • PropertyConcept::PROPERTYSET ,
  • PropertyConcept::ATTRIBUTES and
  • PropertyConcept::METHODS .
Returns
zero or more constants of the ::com::sun::star::beans::PropertyConcept constants group.combined by an arithmetical or-operation.
getProperty
::com::sun::star::beans::Property
getProperty( [in] string  aName,
[in] long  nPropertyConcepts )
raises( ::com::sun::star::container::NoSuchElementException );

Description
returns information about a property if a property with the demanded name exists and if it accords to one of the demanded ::com::sun::star::beans::PropertyConcept s. The information is provided as ::com::sun::star::beans::Property struct.
Returns
A ::com::sun::star::beans::Property struct providing information about the demanded property, if a corresponding property exists.
Parameter aName
the name of the property.
Parameter nPropertyConcepts
zero or more constants of the ::com::sun::star::beans::PropertyConcept constants group combined by an arithmetical or-operation.
Throws
NoSuchElementException when a property with the demanded name doesn't exist or if it accords to a wrong ::com::sun::star::beans::PropertyConcept .
hasProperty
boolean
hasProperty( [in] string  aName,
[in] long  nPropertyConcepts );

Description
allows to ask if a property with the demanded name exists and if it accords to one of the demanded ::com::sun::star::beans::PropertyConcept s.
Returns
true if the property exists and accords to one of the demanded ::com::sun::star::beans::PropertyConcept s, otherwise false is returned.
Parameter aName
the name of the property.
Parameter nPropertyConcepts
zero or more constants of the ::com::sun::star::beans::PropertyConcept constants group combined by an arithmetical or-operation.
getProperties
sequence< ::com::sun::star::beans::Property >
getProperties( [in] long  nPropertyConcepts );

Description
returns a sequence of properties of the introspected object
Returns
all properties of the introspected object which accord to the demanded ::com::sun::star::beans::PropertyConcept s.
Parameter nPropertyConcepts
zero or more constants of the ::com::sun::star::beans::PropertyConcept constants group combined by an arithmetical or-operation.
getMethod
::com::sun::star::reflection::XIdlMethod
getMethod( [in] string  aName,
[in] long  nMethodConcepts )
raises( ::com::sun::star::lang::NoSuchMethodException );

Description
returns information about a method if a method with the demanded name exists and if it accords to one of the demanded MethodConcepts. The information is provided as ::com::sun::star::reflection::XIdlMethod .
Returns
A ::com::sun::star::reflection::XIdlMethod providing information about and access to the demanded method if a corresponding method exists.
Parameter aName
the name of the method.
Parameter nMethodConcepts
zero or more constants of the ::com::sun::star::beans::MethodConcept constants group combined by an arithmetical or-operation.
Throws
NoSuchElementException when a method with the demanded name doesn't exist or if it accords to a wrong ::com::sun::star::beans::MethodConcept .
hasMethod
boolean
hasMethod( [in] string  aName,
[in] long  nMethodConcepts );

Description
allows to ask if a method with the demanded name exists and if it accords to one of the demanded ::com::sun::star::beans::MethodConcept s.
Returns
true if the method exists and accords to one of the demanded ::com::sun::star::beans::MethodConcept s, otherwise false is returned.
Parameter aName
the name of the method.
Parameter nMethodConcepts
zero or more constants of the ::com::sun::star::beans::MethodConcept constants group combined by an arithmetical or-operation.
getMethods
sequence< ::com::sun::star::reflection::XIdlMethod >
getMethods( [in] long  nMethodConcepts );

Description
returns a sequence of methods of the introspected object.
Returns
all methods of the introspected object which accord to the demanded ::com::sun::star::beans::MethodConcept s.
Parameter nMethodConcepts
zero or more constants of the ::com::sun::star::beans::MethodConcept constants group combined by an arithmetical or-operation.
getSupportedListeners
sequence< type >
getSupportedListeners();

Description
returns the listener types supported by the introspected object.

If the introspected object has the methods addFooListener( XFooListener xFoo ) and removeFooListener( XFooListener xFoo ) the type of XFooListener will be one of the elements in the returned sequence.

Returns
a sequence of the types of listener interfaces which are supported by the introspected object.
queryAdapter
::com::sun::star::uno::XInterface
queryAdapter( [in] type  aInterfaceType )
raises( ::com::sun::star::beans::IllegalTypeException );

Description
creates an adapter that implements an interface with the specified type.

To access properties, query for the ::com::sun::star::beans::XPropertySet interface. If the ::com::sun::star::beans::XPropertySet can be queried, the ::com::sun::star::beans::XFastPropertySet interface must be supported too.

If the introspected object implements a name container, the introspection should return the ::com::sun::star::container::XNameAccess and ::com::sun::star::container::XNameContainer interfaces.

If the introspected object implements an index container, the introspection should return the ::com::sun::star::container::XIndexAccess and ::com::sun::star::container::XIndexContainer interfaces.

If the introspected object implements an enumeration container, the introspection should return the ::com::sun::star::container::XEnumerationAccess interface.

If the introspected object implements the ::com::sun::star::reflection::XIdlArray interface, the introspection should return this.

To implement inaccurate name access, at all objects, which implement the ::com::sun::star::container::XNameAccess or ::com::sun::star::beans::XPropertySet interface, the ::com::sun::star::beans::XExactName interface has to be supported.

See also
::com::sun::star::beans::XExactName
Top of Page