LibreOffice
LibreOffice 24.8 SDK API Reference
|
Allows to add Infobars to a frame. More...
import <XInfobarProvider.idl;
Public Member Functions | |
void | appendInfobar ([in] string id, [in] string primaryMessage, [in] string secondaryMessage, [in] long infobarType, [in] sequence< com::sun::star::beans::StringPair > actionButtons, [in] boolean showCloseButton) raises (com::sun::star::lang::IllegalArgumentException) |
Creates and displays a new Infobar. | |
void | updateInfobar ([in] string id, [in] string primaryMessage, [in] string secondaryMessage, [in] long infobarType) raises (com::sun::star::container::NoSuchElementException) |
Updates an existing Infobar. | |
void | removeInfobar ([in] string id) raises (com::sun::star::container::NoSuchElementException) |
Removes an existing Infobar. | |
boolean | hasInfobar ([in] string id) |
Check if Infobar exists. | |
![]() | |
any | queryInterface ([in] type aType) |
queries for a new interface to an existing UNO object. | |
void | acquire () |
increases the reference counter by one. | |
void | release () |
decreases the reference counter by one. | |
Allows to add Infobars to a frame.
This interface can be obtained via com::sun::star::frame::XController.
void appendInfobar | ( | [in] string | id, | |||
[in] string | primaryMessage, | |||||
[in] string | secondaryMessage, | |||||
[in] long | infobarType, | |||||
[in] sequence< com::sun::star::beans::StringPair > | actionButtons, | |||||
[in] boolean | showCloseButton ) | |||||
raises | ( | com::sun::star::lang::IllegalArgumentException ) |
Creates and displays a new Infobar.
id | The ID by which this Infobar is recognized. You can remove the Infobar afterwards using this ID. |
primaryMessage | The (short) primary message. Will appear at the start of the infobar in bold letters. May be empty. |
secondaryMessage | The (longer) secondary message. Will appear in normal letters after the primaryMessage |
infobarType | The type of the Infobar. See com::sun::star::frame::InfobarType for possible values. |
actionButtons | A sequence of action buttons. The buttons will be added from Right to Left at the right side of the info bar. Each button is represented by a com::sun::star::beans::StringPair. StringPair::First represents the button label, while StringPair::Second represents the button URL which will be called on button click. The URL can be any URL, either external (http://libreoffice.org), or internal (.uno:Save), or from your extension (service:your.example.Extension?anyAction). |
showCloseButton | Whether the Close (x) button is shown at the end of the Infobar. Set to false, when you don't want the user to close the Infobar. |
com::sun::star::lang::IllegalArgumentException | If an Infobar with the same ID already exists, or infobarType contains an invalid value. |
The example below adds a new infobar named MyInfoBar with type INFO and close (x) button.
boolean hasInfobar | ( | [in] string | id | ) |
Check if Infobar exists.
id | The ID which was used when creating this Infobar. |
void removeInfobar | ( | [in] string | id | ) | ||
raises | ( | com::sun::star::container::NoSuchElementException ) |
Removes an existing Infobar.
id | The ID which was used when creating this Infobar. |
com::sun::star::container::NoSuchElementException | If no such Infobar exists (it might have been closed by the user already) |
Remove MyInfoBar infobar
void updateInfobar | ( | [in] string | id, | |||
[in] string | primaryMessage, | |||||
[in] string | secondaryMessage, | |||||
[in] long | infobarType ) | |||||
raises | ( | com::sun::star::container::NoSuchElementException ) |
Updates an existing Infobar.
Use if you want to update only small parts of the Infobar.
com::sun::star::container::NoSuchElementException | If no such Infobar exists (it might have been closed by the user already) |
com::sun::star::lang::IllegalArgumentException | If infobarType contains an invalid value. |
Update the infobar and change the type to WARNING