|
LibreOffice
LibreOffice 25.2 SDK API Reference
|
specifies a user interface configuration manager interface which controls the structure of all customizable user interface elements. More...
import"XUIConfigurationManager.idl";
Public Member Functions | |
| void | reset () |
| resets the configuration manager to the default user interface configuration data. More... | |
| sequence< sequence< com::sun::star::beans::PropertyValue > > | getUIElementsInfo ([in] short ElementType) raises ( com::sun::star::lang::IllegalArgumentException ) |
| retrieves information about all user interface elements within the user interface configuration manager. More... | |
| ::com::sun::star::container::XIndexContainer | createSettings () |
| creates an empty settings data container. More... | |
| boolean | hasSettings ([in] string ResourceURL) raises ( com::sun::star::lang::IllegalArgumentException ) |
| determines if the settings of a user interface element is part the user interface configuration manager. More... | |
| ::com::sun::star::container::XIndexAccess | getSettings ([in] string ResourceURL, [in] boolean bWriteable) raises ( com::sun::star::container::NoSuchElementException, com::sun::star::lang::IllegalArgumentException ) |
| retrieves the settings of a user interface element. More... | |
| void | replaceSettings ([in] string ResourceURL, [in] ::com::sun::star::container::XIndexAccess aNewData) raises ( com::sun::star::container::NoSuchElementException, com::sun::star::lang::IllegalArgumentException, com::sun::star::lang::IllegalAccessException ) |
| replaces the settings of a user interface element with new settings. More... | |
| void | removeSettings ([in] string ResourceURL) raises ( com::sun::star::container::NoSuchElementException, com::sun::star::lang::IllegalArgumentException, com::sun::star::lang::IllegalAccessException ) |
| removes the settings of an existing user interface element. More... | |
| void | insertSettings ([in] string NewResourceURL, [in] ::com::sun::star::container::XIndexAccess aNewData) raises ( com::sun::star::container::ElementExistException, com::sun::star::lang::IllegalArgumentException, com::sun::star::lang::IllegalAccessException ) |
| inserts the settings of a new user interface element. More... | |
| com::sun::star::uno::XInterface | getImageManager () |
| retrieves the image manager from the user interface configuration manager. More... | |
| com::sun::star::ui::XAcceleratorConfiguration | getShortCutManager () |
| retrieves the keyboard short cut manager from the user interface configuration manager. More... | |
| com::sun::star::uno::XInterface | getEventsManager () |
| retrieves the events manager from the user interface configuration manager. 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... | |
specifies a user interface configuration manager interface which controls the structure of all customizable user interface elements.
| ::com::sun::star::container::XIndexContainer createSettings | ( | ) |
creates an empty settings data container.
| com::sun::star::uno::XInterface getEventsManager | ( | ) |
retrieves the events manager from the user interface configuration manager.
Every user interface configuration manager has one events manager instance which controls the mapping of events to script URLs of a module or document.
| com::sun::star::uno::XInterface getImageManager | ( | ) |
retrieves the image manager from the user interface configuration manager.
Every user interface configuration manager has one image manager instance which controls all images of a module or document.
| ::com::sun::star::container::XIndexAccess getSettings | ( | [in] string | ResourceURL, |
| [in] boolean | bWriteable | ||
| ) | |||
| raises | ( | com::sun::star::container::NoSuchElementException, | |
| com::sun::star::lang::IllegalArgumentException | |||
| ) | |||
retrieves the settings of a user interface element.
| ResourceURL | a resource URL which identifies the user interface element. A resource URL must meet the following syntax: "private:resource/$type/$name. It is only allowed to use ASCII characters for type and name. |
| bWriteable | must be TRUE if the retrieved settings should be a writable. Otherwise FALSE should be provided to get a shareable reference to the settings data. |
ResourceURL is not valid or describes an unknown type a com::sun::star::lang::IllegalArgumentException is thrown. | com::sun::star::ui::XAcceleratorConfiguration getShortCutManager | ( | ) |
retrieves the keyboard short cut manager from the user interface configuration manager.
Every user interface configuration manager has one keyboard short cut manager instance which controls all short cuts of a module or document.
| sequence< sequence< com::sun::star::beans::PropertyValue > > getUIElementsInfo | ( | [in] short | ElementType | ) | |
| raises | ( | com::sun::star::lang::IllegalArgumentException | |||
| ) | |||||
retrieves information about all user interface elements within the user interface configuration manager.
| ElementType | makes it possible to narrow the result set to only one type of user interface elements. If all user interface element types should be returned com::sun::star::ui::UIElementType::UNKNOWN must be provided. |
The following com::sun::star::beans::PropertyValue entries are defined inside the sequence for every user interface element.
| boolean hasSettings | ( | [in] string | ResourceURL | ) | |
| raises | ( | com::sun::star::lang::IllegalArgumentException | |||
| ) | |||||
determines if the settings of a user interface element is part the user interface configuration manager.
| ResourceURL | a resource URL which identifies the user interface element. A resource URL must meet the following syntax: "private:resource/$type/$name. It is only allowed to use ASCII characters for type and name. |
TRUE if settings have been found, otherwise FALSE. | void insertSettings | ( | [in] string | NewResourceURL, |
| [in] ::com::sun::star::container::XIndexAccess | aNewData | ||
| ) | |||
| raises | ( | com::sun::star::container::ElementExistException, | |
| com::sun::star::lang::IllegalArgumentException, | |||
| com::sun::star::lang::IllegalAccessException | |||
| ) | |||
inserts the settings of a new user interface element.
| NewResourceURL | a resource URL which identifies the new user interface element. |
| aNewData | the settings data of the new user interface element, which implements UIElementSettings. |
If the settings data is already present a com::sun::star::container::ElementExistException is thrown. If the NewResourceURL is not valid or describes an unknown type a com::sun::star::lang::IllegalArgumentException is thrown. If the configuration manager is read-only a com::sun::star::lang::IllegalAccessException is thrown.
| void removeSettings | ( | [in] string | ResourceURL | ) | |
| raises | ( | com::sun::star::container::NoSuchElementException, | |||
| com::sun::star::lang::IllegalArgumentException, | |||||
| com::sun::star::lang::IllegalAccessException | |||||
| ) | |||||
removes the settings of an existing user interface element.
| ResourceURL | a resource URL which identifies the user interface element settings to be removed. |
If the settings data cannot be found a com::sun::star::container::NoSuchElementException is thrown. If the ResourceURL is not valid or describes an unknown type a com::sun::star::lang::IllegalArgumentException is thrown. If the configuration manager is read-only a com::sun::star::lang::IllegalAccessException is thrown.
| void replaceSettings | ( | [in] string | ResourceURL, |
| [in] ::com::sun::star::container::XIndexAccess | aNewData | ||
| ) | |||
| raises | ( | com::sun::star::container::NoSuchElementException, | |
| com::sun::star::lang::IllegalArgumentException, | |||
| com::sun::star::lang::IllegalAccessException | |||
| ) | |||
replaces the settings of a user interface element with new settings.
| ResourceURL | a resource URL which identifies the user interface element to be replaced. If no element with the given resource URL exists a com::sun::star::container::NoSuchElementException is thrown. |
| aNewData | the new settings data of an existing user interface element, which implements UIElementSettings. |
If the settings data cannot be found a com::sun::star::container::NoSuchElementException is thrown. If the ResourceURL is not valid or describes an unknown type a com::sun::star::lang::IllegalArgumentException is thrown. If the configuration manager is read-only a com::sun::star::lang::IllegalAccessException is thrown.
| void reset | ( | ) |
resets the configuration manager to the default user interface configuration data.
This means that all user interface configuration data of the instance will be removed. A module based user interface configuration manager removes user defined elements, but set all other elements back to default. It is not possible to remove default elements from a module user interface configuration manager.
1.8.14