LibreOffice
LibreOffice 24.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.