Framework/Specification/Background Bitmap For Dialogs And Tabs
Background Image for UNO AWT dialogs and tabpages
The UNO awt library should support to set a background image for dialogs and tab pages to create a more attractive user interface.
|Reference Document||Check||Location (URL)|
|Specification Process Entry Check||[passed]||n/a|
|Product Requirement, RFE, Issue ID (required)||[available]||https://so-web.germany.sun.com/iBIS/servlet/edit.ControlPanel?tid=i83238|
|Product Concept Document||[not available]||-|
|Test case specification (required)||[available/not available]||<PLEASE ENTER LOCATION HERE>|
|IDL Specification||[available/not available]||<PLEASE ENTER LOCATION HERE>|
|Software Specification Rules||n/a||n/a|
|Other, e.g. references to related specs||<PLEASE ENTER LOCATION HERE>|
|Quality Assurance||Jörg Skottkeemail@example.com|
|User Experience||<First Name, Last Name>||<User@openoffice.org>|
Acronyms and Abbreviations
|Acronym / Abbreviation||Definition|
|property||A value with a type which represents a specific state. Normally addressed by a unique name.|
The UNO awt library should be extended to support a new property for dialogs and tab pages. The property contains the URL for an image that is displayed in the background of a dialog or tab page. Developers would be able to make their dialogs or tab pages more attractive to users.
To accomplish the task two new properties were added to the com.sun.star.awt.UnoControlDialogModel. You can see the name and type of the properties below.
/** specifies a URL that references a graphic that should be used as a
background image. @see Graphic
@since OOo 2.4.0
[optional, property] string ImageURL;
/** specifies a graphic to be displayed as a background image
If this property is present, it interacts with the <member>ImageURL</member>in the following way:
- If <member>ImageURL</member> is set, <member>Graphic</member> will be reset to an object as loaded from the given image URL, or <NULL/> if <member>ImageURL</member> does not point to a valid image file.
- If <member>Graphic</member> is set, <member>ImageURL</member> will be reset to an empty string.
@since OOo 2.4.0
[optional, property, transient] com::sun::star::graphic::XGraphic Graphic;
The property browser for dialogs and tab pages is extended to select an image file via a file selection dialog.
When the user selects an image file for the tab page or dialog the background will be painted with the selected image.
The controls which reside in the tab page or dialog will be transparent when the background color is set to default. Otherwise the would use their own background color.
The new property called "Graphics" is not completely new as some controls already support to set an image (e.g. radio button, image control). Therefore no new strings will be added, resulting in no additional translation work.
There is no migration necessary for this enhancement.
There are no configuration items involved.
There are no changes to the file format necessary.
<State a bulleted list of issues Issue here>