LibreOffice
LibreOffice 6.2 SDK API Reference
Exported Interfaces | List of all members
FormComponents Service Referencepublished

specifies the capabilities of a collection of FormComponents. More...

import"FormComponents.idl";

Inheritance diagram for FormComponents:
XContainer XNameContainer XIndexContainer XEnumerationAccess XEventAttacherManager XInterface XNameReplace XIndexReplace XElementAccess XInterface XNameAccess XIndexAccess XInterface XElementAccess XElementAccess XInterface XInterface Form GridControl DataForm HTMLForm

Exported Interfaces

interface com::sun::star::container::XContainer
 allows to register listeners to be notified of changes in the container. More...
 
interface com::sun::star::container::XNameContainer
 allows to add/remove elements by name. More...
 
interface com::sun::star::container::XIndexContainer
 gives access to the elements by index. More...
 
interface com::sun::star::container::XEnumerationAccess
 creates an enumeration of the elements. More...
 
interface com::sun::star::script::XEventAttacherManager
 This interface has to be implemented to supply the scripting environment for the contained components. More...
 

Additional Inherited Members

- Public Member Functions inherited from XContainer
void addContainerListener ([in] com::sun::star::container::XContainerListener xListener)
 adds the specified listener to receive events when elements are inserted or removed. More...
 
void removeContainerListener ([in] com::sun::star::container::XContainerListener xListener)
 removes the specified listener so it does not receive any events from this container. More...
 
- Public Member Functions inherited from XInterface
any queryInterface ([in] type aType)
 queries for a new interface to an existing UNO object. More...
 
void acquire ()
 increases the reference counter by one. More...
 
void release ()
 decreases the reference counter by one. More...
 
- Public Member Functions inherited from XNameContainer
void insertByName ([in] string aName, [in] any aElement) raises ( com::sun::star::lang::IllegalArgumentException, com::sun::star::container::ElementExistException, com::sun::star::lang::WrappedTargetException )
 inserts the given element at the specified name. More...
 
void removeByName ([in] string Name) raises ( com::sun::star::container::NoSuchElementException, com::sun::star::lang::WrappedTargetException )
 removes the element with the specified name. More...
 
- Public Member Functions inherited from XNameReplace
void replaceByName ([in] string aName, [in] any aElement) raises ( com::sun::star::lang::IllegalArgumentException, com::sun::star::container::NoSuchElementException, com::sun::star::lang::WrappedTargetException )
 replaces the element with the specified name with the given element. More...
 
- Public Member Functions inherited from XNameAccess
any getByName ([in] string aName) raises ( com::sun::star::container::NoSuchElementException, com::sun::star::lang::WrappedTargetException )
 
sequence< string > getElementNames ()
 
boolean hasByName ([in] string aName)
 
- Public Member Functions inherited from XElementAccess
type getElementType ()
 
boolean hasElements ()
 
- Public Member Functions inherited from XIndexContainer
void insertByIndex ([in] long Index, [in] any Element) raises ( com::sun::star::lang::IllegalArgumentException, com::sun::star::lang::IndexOutOfBoundsException, com::sun::star::lang::WrappedTargetException )
 inserts the given element at the specified index. More...
 
void removeByIndex ([in] long Index) raises ( com::sun::star::lang::IndexOutOfBoundsException, com::sun::star::lang::WrappedTargetException )
 removes the element at the specified index. More...
 
- Public Member Functions inherited from XIndexReplace
void replaceByIndex ([in] long Index, [in] any Element) raises ( com::sun::star::lang::IllegalArgumentException, com::sun::star::lang::IndexOutOfBoundsException, com::sun::star::lang::WrappedTargetException )
 replaces the element at the specified index with the given element. More...
 
- Public Member Functions inherited from XIndexAccess
long getCount ()
 
any getByIndex ([in] long Index) raises ( com::sun::star::lang::IndexOutOfBoundsException, com::sun::star::lang::WrappedTargetException )
 
- Public Member Functions inherited from XEnumerationAccess
com::sun::star::container::XEnumeration createEnumeration ()
 
- Public Member Functions inherited from XEventAttacherManager
void registerScriptEvent ([in] long nIndex, [in] com::sun::star::script::ScriptEventDescriptor aScriptEvent) raises ( com::sun::star::lang::IllegalArgumentException )
 registers one event for an object identified by its index. More...
 
void registerScriptEvents ([in] long nIndex, [in] sequence< com::sun::star::script::ScriptEventDescriptor > aScriptEvents) raises ( com::sun::star::lang::IllegalArgumentException )
 registers several events for an object identified by its index. More...
 
void revokeScriptEvent ([in] long nIndex, [in] string aListenerType, [in] string aEventMethod, [in] string aRemoveListenerParam) raises ( com::sun::star::lang::IllegalArgumentException )
 revokes the registration of an event. More...
 
void revokeScriptEvents ([in] long nIndex) raises ( com::sun::star::lang::IllegalArgumentException )
 revokes all events which are registered for the given index. More...
 
void insertEntry ([in] long nIndex) raises ( com::sun::star::lang::IllegalArgumentException )
 creates an empty entry at the given position. More...
 
void removeEntry ([in] long nIndex) raises ( com::sun::star::lang::IllegalArgumentException )
 removes the entry at the given position. More...
 
sequence< com::sun::star::script::ScriptEventDescriptorgetScriptEvents ([in] long Index) raises ( com::sun::star::lang::IllegalArgumentException )
 
void attach ([in] long nIndex, [in] com::sun::star::uno::XInterface xObject, [in] any aHelper) raises ( com::sun::star::lang::IllegalArgumentException, com::sun::star::lang::ServiceNotRegisteredException )
 attaches all the ScriptEvents which are registered for the given index to the given object. More...
 
void detach ([in] long nIndex, [in] com::sun::star::uno::XInterface xObject) raises ( com::sun::star::lang::IllegalArgumentException )
 detaches all the ScriptEvents from the given object which are registered at this object for the given index. More...
 
void addScriptListener ([in] com::sun::star::script::XScriptListener xListener) raises ( com::sun::star::lang::IllegalArgumentException )
 adds an XScriptListener that will be notified when an event takes place. More...
 
void removeScriptListener ([in] com::sun::star::script::XScriptListener Listener) raises ( com::sun::star::lang::IllegalArgumentException )
 removes a XScriptListener from the listener list. More...
 

Detailed Description

specifies the capabilities of a collection of FormComponents.

The collection must provide the possibility of adding and removing components by name and by index. The name of a component is not necessarily unique, so the collection must be able to handle duplicate entry names.

See also
FormComponent
Developers Guide
Forms - FormComponents Service

Exported Interfaces

allows to register listeners to be notified of changes in the container.

creates an enumeration of the elements.

gives access to the elements by index.

allows to add/remove elements by name.

This interface has to be implemented to supply the scripting environment for the contained components.

The interface allows managing of scripts associated with dependent components, accessed by index. However, as a client of the FormComponents service, there's no need to bother with the container aspect of the com::sun::star::script::XEventAttacherManager directly. A FormComponents container will automatically synchronize the elements you put into it with the scripting information obtained at the com::sun::star::script::XEventAttacherManager interface.

For instance, at any time you can obtain the events associated with the nth element in the form components by calling com::sun::star::script::XEventAttacherManager::getScriptEvents() with parameter n. In particular, this invariant is always met, even after you inserted/removed elements into/from the container.


The documentation for this service was generated from the following file: