Author:halw

Date:2011-05-26T20:26:39.000000Z


git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@914 abb3cda0-5349-4a8f-a601-0c33ac3a8c38
This commit is contained in:
halw
2011-05-27 12:40:01 +00:00
parent c946682265
commit aa80d58a29

View File

@@ -12,9 +12,9 @@ EiffelRibbon is a library of classes with an associated tool which allows the in
{{note|''Although EiffelRibbon classes work with EiffelVision 2 which is multi-platform, systems using EiffelRibbon can be targeted only to the Microsoft Windows platform.''}} {{note|''Although EiffelRibbon classes work with EiffelVision 2 which is multi-platform, systems using EiffelRibbon can be targeted only to the Microsoft Windows platform.''}}
[[Image:EiffelRibbon window 01|A window with a ribbon]] [[Image:EiffelRibbon window 01|A ribbon on a window]]
Figure 1: A window with a ribbon. Figure 1: A ribbon at the top of a window.
The EiffelRibbon library contains the classes that are used to implement the ribbon facilities. The classes in the EiffelRibbon library all have class names beginning "EV_", the default prefix for EiffelVision 2 classes. So the EiffelRibbon classes can be seen as an extension to the EiffelVision 2 library. If you've used EiffelVision 2 to create applications with graphical user interfaces, then the EiffelRibbon class won't look unfamiliar to you. However, unlike other EiffelVision 2 classes, the EiffelRibbon classes only work in applications targeted to Microsoft Windows. The EiffelRibbon library contains the classes that are used to implement the ribbon facilities. The classes in the EiffelRibbon library all have class names beginning "EV_", the default prefix for EiffelVision 2 classes. So the EiffelRibbon classes can be seen as an extension to the EiffelVision 2 library. If you've used EiffelVision 2 to create applications with graphical user interfaces, then the EiffelRibbon class won't look unfamiliar to you. However, unlike other EiffelVision 2 classes, the EiffelRibbon classes only work in applications targeted to Microsoft Windows.
@@ -52,7 +52,7 @@ So, if you've used EiffelBuild, the the EiffelRibbon design tool should seem qui
The typical usage of the design tool is much like the typical usage of EiffelBuild. The typical usage of the design tool is much like the typical usage of EiffelBuild.
* Create a new project ( <code lang="text">File ->New Project...</code> ) and choose a location for your EiffelRibbon project. * Create a new project ( <code lang="text">File -> New Project...</code> ) and choose a location for your EiffelRibbon project.
* Configure the ribbon by adding elements, name the elements, and choose icons for buttons. * Configure the ribbon by adding elements, name the elements, and choose icons for buttons.
* Save the project. * Save the project.
* Generate the code. * Generate the code.
@@ -66,11 +66,14 @@ Initial distribution:
:A class <code>EV_RIBBON_TITLED_WINDOW</code> is provided with the library. <code>EV_RIBBON_TITLED_WINDOW</code> is a descendant of the standard EiffelVision 2 class <code>EV_TITLED_WINDOW</code>. The ribbon classes generated by EiffelRibbon tool can be added only to instances of <code>EV_RIBBON_TITLED_WINDOW</code>. :A class <code>EV_RIBBON_TITLED_WINDOW</code> is provided with the library. <code>EV_RIBBON_TITLED_WINDOW</code> is a descendant of the standard EiffelVision 2 class <code>EV_TITLED_WINDOW</code>. The ribbon classes generated by EiffelRibbon tool can be added only to instances of <code>EV_RIBBON_TITLED_WINDOW</code>.
:Custom size definition is not supported, but should be included in a release in the near term.
==Known issues and limitations== ==Known issues and limitations==
Initial distribution: Initial distribution:
* Not all elements shown in the Type selector can actually be used in a design. For the unusable elements, pick-and-drop is disabled. * The Contextual Tab is not supported. For this unsupported element, pick-and-drop is disabled.
* Resizing policy is not yet supported. * Resizing policy is not yet supported.
* It is necessary to freeze the target system each time the EiffelRibbon code is regenerated. * It is necessary to freeze the target system each time the EiffelRibbon code is regenerated.
* When using <code>EV_RICH_TEXT</code> within a ribbon, the <code>EV_RICH_TEXT</code> may not be refreshed right after the ribbon has been displayed. * When using <code>EV_RICH_TEXT</code> within a ribbon, the <code>EV_RICH_TEXT</code> may not be refreshed right after the ribbon has been displayed.