Update wikipage EiffelRibbon Design Tool. (Signed-off-by:jocelyn).

git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@1461 abb3cda0-5349-4a8f-a601-0c33ac3a8c38
This commit is contained in:
eiffel-org
2015-11-24 09:11:53 +00:00
parent c2d80a5cda
commit 3e81a944e0

View File

@@ -1,6 +1,6 @@
[[Property:title|EiffelRibbon Design Tool]]
[[Property:weight|0]]
[[Property:uuid|0fe37d4f-3f5b-0ceb-e97e-69ae3f9960ad]]
[[Property:uuid|E0B7F3F8-F7B1-43C4-8B7E-D175BC9A7D9F]]
=Overview=
The EiffelRibbon design tool allows you to design a ribbon graphically, then generate the ribbon markup file and the Eiffel classes necessary to implement your design.
@@ -17,7 +17,7 @@ The interface of the design tool mimics that of [[EiffelBuild|EiffelBuild]]. Tha
# Layout constructor: A structured view of the organization of the elements used in a particular ribbon design.
# Object editor: The properties of the ribbon element which is currently selected in the Layout constructor.
So, if you've used EiffelBuild, the the EiffelRibbon design tool should seem quite familiar to you.
So, if you've used EiffelBuild, the EiffelRibbon design tool should seem quite familiar to you.
=Usage=
@@ -31,7 +31,7 @@ The typical usage of the design tool is much like the typical usage of EiffelBui
==Size definitions and scaling policies==
An important aspect of Microsoft's ribbon technology is called '''[http://msdn.microsoft.com/en-us/library/windows/desktop/dd316927(v=vs.85).aspx adaptive layout]'''. When the ribbon is resized by a user at runtime, adaptive layout makes corresponding changes to the size, format, organization and scale of the ribbon controls within each group based on size definition templates and scaling policies associated with the group. Size definitions are patterns for the use of a certain number of ribbon controls such as buttons. For a particular group of controls in an instance of ribbon, you can associate a size definition which will control the layout of the controls. At runtime, when the window hosting the ribbon is resized, a scaling policy, also associated with the group, will control how the controls in the group are reorganized in response to the resizing. When a group is selected in the EiffelRibbon tool, the group's size definition and scaling policy can be selected.
An important aspect of Microsoft's ribbon technology is called '''[http://msdn.microsoft.com/en-us/library/windows/desktop/dd316927(v=vs.85).aspx adaptive layout]'''. When the ribbon is resized by a user at runtime, the adaptive layout makes corresponding changes to the size, format, organization and scale of the ribbon controls within each group based on size definition templates and scaling policies associated with the group. Size definitions are patterns for the use of a certain number of ribbon controls such as buttons. For a particular group of controls in an instance of ribbon, you can associate a size definition which will control the layout of the controls. At runtime, when the window hosting the ribbon is resized, a scaling policy, also associated with the group, will control how the controls in the group are reorganized in response to the resizing. When a group is selected in the EiffelRibbon tool, the group's size definition and scaling policy can be selected.
{{note|Not all size definitions support all scaling policy choices. So it is important to know which scaling policies are supported by a size definition that you wish to associate with a group before you set the scaling policy for the group.}}
@@ -71,7 +71,7 @@ Figure 5. The Size Definition Editor naming field and '''Save''' button.
When you generate code which uses a custom size definition, the EiffelRibbon Design Tool generates the (XML) representation for your size definition and then invoke the Microsoft Ribbon Framework's User Interface Command Compiler (UICC.exe) to validate the generated size definition code. This process can result in [http://msdn.microsoft.com/en-us/library/windows/desktop/dd316918(v=VS.85).aspx certain types of errors].
User Interface Command Compiler errors will appear in the Ouput pane of the EiffelRibbon Design Tool.
User Interface Command Compiler errors will appear in the Output pane of the EiffelRibbon Design Tool.
===Scaling policy===
@@ -83,7 +83,7 @@ The EiffelRibbon tool allows you to specify ideal sizes and scale policy for a g
[[Image:EiffelRibbon design tool 02|Scaling policy elements: "Ideal sizes" and "Scale"]]
Figure 6. A group definition showing its size definition and the scaling policy elements "Ideal sizes" and "Scale".
Figure 6. A group definition showing it's size definition and the scaling policy elements "Ideal sizes" and "Scale".
In Figure 6, none of the Scale checkboxes is checked. This means that no scaling policy is in effect for the group ''group_context_popups''. So in a running application, a window with this ribbon might be rendered as shown in Figure 7: