mirror of
https://github.com/EiffelSoftware/eiffel-org.git
synced 2025-12-07 23:32:42 +01:00
added 18.07
git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@2049 abb3cda0-5349-4a8f-a601-0c33ac3a8c38
This commit is contained in:
eiffel-org
@@ -0,0 +1,5 @@
|
||||
[[Property:title|EiffelStudio interface mechanisms]]
|
||||
[[Property:weight|0]]
|
||||
[[Property:uuid|ae1b2f77-4853-b282-a80b-f9413bbe74a4]]
|
||||
|
||||
|
||||
@@ -0,0 +1,22 @@
|
||||
[[Property:title|Pick-and-drop mechanism]]
|
||||
[[Property:weight|0]]
|
||||
[[Property:uuid|68a85ff6-d28f-9ba5-0a5c-4eba546497b8]]
|
||||
Pick-and-drop is one of Eiffel Software's exclusive technologies and is provided by [[EiffelVision Introduction|EiffelVision]]. In EiffelStudio it allows you to send data easily from a component of the interface to another.
|
||||
|
||||
You can pick every reference to a '''development object''' (like a class, a feature or an execution object) with a single click on the '''right''' mouse button. Then as you start moving the mouse around - not pressing any of its buttons - a pebble tracks the cursor position, and a line continuously connects the pebble to the object's original position. The pebble's shape indicates the type of the development object that you picked (oval disk for a class, cross for a feature, folder for a cluster...).
|
||||
|
||||
<center> [[Image:editor-pick-and-drop]] </center>
|
||||
|
||||
You may terminate this situation in either of two ways:
|
||||
* If the pebble you are dragging is not crossed, you can right-click again to confirm the pick-and-drop and so effectively send the dragged development object to the targeted component. For a class, a droppable pebble looks like this: [[Image:context-class-cursor]]
|
||||
Right-clicking when the pebble is crossed will only stop the pick-and-drop because the component you are hovering with the mouse does not accept your development object. For a class, a not droppable pebble looks like this: [[Image:context-disabled-class-cursor]]
|
||||
|
||||
* If, for any reason, you change your mind, you can cancel the pick-and-drop by left-clicking anywhere or by pressing the Escape key.
|
||||
|
||||
{{seealso|<br/>
|
||||
[[Pick-and-drop shortcut|Pick-and-drop shortcut]] <br/>
|
||||
}}
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,14 @@
|
||||
[[Property:title|Pick-and-drop shortcut]]
|
||||
[[Property:weight|1]]
|
||||
[[Property:uuid|2cb70fcf-913c-0b74-d2a9-5928caa5904a]]
|
||||
Pressing the '''control''' key while right-clicking on a development object opens a new editor tab which is centered on the clicked object.
|
||||
|
||||
{{tip|The effect of control-picking is now configurable in the [[Preferences Reference|preferences]] . }}
|
||||
|
||||
|
||||
{{seealso|<br/>
|
||||
[[Pick-and-drop mechanism|Pick-and-drop mechanism]] }}
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,42 @@
|
||||
[[Property:title|Toolbar customization]]
|
||||
[[Property:weight|2]]
|
||||
[[Property:uuid|f02205ad-2d3e-a9f1-d104-ca96e1fd2d77]]
|
||||
It is possible to choose which icons appear in the EiffelStudio [[Main toolbars|toolbars]].
|
||||
|
||||
If you right-click on any toolbar you will see a context menu that allows you to choose which toolbars are visible and to customize the visible icons for each:
|
||||
|
||||
|
||||
[[Image:toolbar-context-menu]]
|
||||
|
||||
|
||||
You can also choose to customize a toolbar by clicking on the '''Toolbar Options''' drop-down menu at the right end of the toolbar, and select '''Customize''':
|
||||
|
||||
|
||||
[[Image:toolbar-options-dropdown]]
|
||||
|
||||
|
||||
|
||||
Whenever you choose to customize a toolbar, two lists of icons are displayed in the '''Customize Toolbar''' dialog window. The list on the right shows the icons that are currently displayed in the toolbar. The list on the left gathers the icons that are currently not in the toolbar and that may be added. It also contains a separator that may be used to organize icons. In the figure below, you see the Customize Toolbar dialog targeted to the project toolbar.
|
||||
|
||||
|
||||
[[Image:Customize toolbar dialog]]
|
||||
|
||||
|
||||
|
||||
To add an icon or a separator to the toolbar, select it in the left list and click on the '''Add ->''' button. It will then be inserted in the right list after the selected item. <br/>
|
||||
To remove an icon, click on it in the right list and click on '''<- Remove'''.
|
||||
|
||||
The order of the icons in the right list is the same as in the toolbar. If you want to move an icon in the list, select it and use '''Up''' and '''Down''' buttons. '''Up''' will move it to the top, i.e. to the left of the toolbar. '''Down''' will move it in the opposite direction.
|
||||
|
||||
|
||||
{{tip|You can also pick-and-drop icons to organize them. }}
|
||||
|
||||
|
||||
Once you made the changes you wanted, validate them by clicking on '''OK'''. You can also go back to the initial toolbar layout by clicking on '''Cancel'''.
|
||||
|
||||
|
||||
{{seealso|<br/>
|
||||
[[Main toolbars|EiffelStudio toolbars]] }}
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,230 @@
|
||||
[[Property:title|EiffelStudio: Key shortcuts]]
|
||||
[[Property:weight|3]]
|
||||
[[Property:uuid|8092b380-d7ca-2d99-d922-258fcdf6bd48]]
|
||||
Many operations in EiffelStudio do not require the use of the mouse. The same effect can be achieved through the keyboard only.
|
||||
|
||||
This page gathers all the keyboard shortcuts available in the environment. They are sorted in several categories, depending on their domain of application.
|
||||
|
||||
==Editor shortcuts==
|
||||
|
||||
===Clipboard shortcuts===
|
||||
|
||||
{|
|
||||
|-
|
||||
| '''Key shortcut'''
|
||||
| '''Purpose'''
|
||||
|-
|
||||
| Ctrl+C
|
||||
| Copy : Copy selected text into the clipboard.
|
||||
|-
|
||||
| Ctrl+Ins
|
||||
| Equivalent to Ctrl+C.
|
||||
|-
|
||||
| Ctrl+X
|
||||
| Cut: Copy selected text into the clipboard and remove it.
|
||||
|-
|
||||
| Shift+Del
|
||||
| Equivalent to Ctrl+X.
|
||||
|-
|
||||
| Ctrl+V
|
||||
| Paste: Insert clipboard content into the text.
|
||||
|-
|
||||
| Shift+Ins
|
||||
| Equivalent to Ctrl+V.
|
||||
|}
|
||||
|
||||
|
||||
===Undo/redo shortcuts===
|
||||
|
||||
{|
|
||||
|-
|
||||
| '''Key shortcut'''
|
||||
| '''Purpose'''
|
||||
|-
|
||||
| Ctrl+Z
|
||||
| Undo last action.
|
||||
|-
|
||||
| Ctrl+Y
|
||||
| Redo last undone action.
|
||||
|}
|
||||
|
||||
|
||||
===Search shortcuts===
|
||||
|
||||
{|
|
||||
|-
|
||||
| '''Key shortcut'''
|
||||
| '''Purpose'''
|
||||
|-
|
||||
| Ctrl+F
|
||||
| Display the quick search bar and give the focus to the "Search for..." text field. <br/>
|
||||
This shortcut may be customized.
|
||||
|-
|
||||
| Ctrl+H
|
||||
| Display the Search tool and give the focus to the "Replace with..." text field. <br/>
|
||||
This shortcut may be customized.
|
||||
|-
|
||||
| F3
|
||||
| Search the next occurrence of the last searched expression. <br/>
|
||||
This shortcut may be customized.
|
||||
|-
|
||||
| Shift+F3
|
||||
| Search the previous occurrence the last searched expression. <br/>
|
||||
This shortcut may be customized.
|
||||
|-
|
||||
| Ctrl+F3
|
||||
| Search the next occurrence of the current selected expression. <br/>
|
||||
This shortcut may be customized.
|
||||
|-
|
||||
| Ctrl+Shift+F3
|
||||
| Search the previous occurrence the current selected expression. <br/>
|
||||
This shortcut may be customized.
|
||||
|}
|
||||
|
||||
|
||||
===Shortcuts to modify selected text===
|
||||
|
||||
{|
|
||||
|-
|
||||
| '''Key shortcut'''
|
||||
| '''Purpose'''
|
||||
|-
|
||||
| Tab
|
||||
| Indent selection (only if several lines are selected).
|
||||
|-
|
||||
| Shift+Tab
|
||||
| Unindent the selected lines or the current line if there is no selection.
|
||||
|-
|
||||
| Ctrl+K
|
||||
| Comment the selected lines or the current line if there is no selection.
|
||||
|-
|
||||
| Ctrl+Shift+K
|
||||
| Uncomment the selected lines or the current line if there is no selection. <br/>
|
||||
A line is uncommented only if '--' is at its beginning.
|
||||
|-
|
||||
| Ctrl+I
|
||||
| Embed selection (or the current line if there is no selection)<br/>
|
||||
in an "if...then...end" structure.
|
||||
|-
|
||||
| Ctrl+D
|
||||
| Embed selection (or the current line if there is no selection)<br/>
|
||||
in an "debug...end" structure.
|
||||
|}
|
||||
|
||||
|
||||
===Other shortcuts===
|
||||
|
||||
{|
|
||||
|-
|
||||
| '''Key shortcut'''
|
||||
| '''Purpose'''
|
||||
|-
|
||||
| Ctrl+A
|
||||
| Select the entire text.
|
||||
|-
|
||||
| Ctrl+Space
|
||||
| Auto-complete current word. <br/>
|
||||
This shortcut may be customized.
|
||||
|}
|
||||
|
||||
|
||||
{{note|These shortcuts are not available everywhere. All operations that do not imply changes in the text are available both in the editor and in the class and feature tabs of the context tool. Other operations are available only in the editor. }}
|
||||
|
||||
==Compiler==
|
||||
|
||||
{|
|
||||
|-
|
||||
| '''Key shortcut'''
|
||||
| '''Purpose'''
|
||||
|-
|
||||
| F7
|
||||
| Melt the system. This is the standard way to compile a debuggable system.
|
||||
|-
|
||||
| Alt+F8
|
||||
| Look for externally added, unreferenced classes and recompile. This is normally not needed if classes are added in EiffelStudio or if they are referenced by another class that is in the system.
|
||||
|-
|
||||
| Shift+F8
|
||||
| Only check override clusters for changed classes and recompile.
|
||||
|-
|
||||
| Ctrl+F7
|
||||
| Freeze the system. This melts the system and recompile the generated C code.
|
||||
|-
|
||||
| Ctrl+Shift+F7
|
||||
| Finalize the system. This generates an optimized executable which is not debuggable.
|
||||
|}
|
||||
|
||||
|
||||
==Debugger==
|
||||
|
||||
{|
|
||||
|-
|
||||
| '''Key shortcut'''
|
||||
| '''Purpose'''
|
||||
|-
|
||||
| F5
|
||||
| Run. This is the standard way to run a system and debug it.
|
||||
|-
|
||||
| Ctrl+F5
|
||||
| Run without breakpoints. Same as run except that breakpoints are ignored.
|
||||
|-
|
||||
| Shift+F5
|
||||
| Kill the debugged application
|
||||
|-
|
||||
| Ctrl+Shift+F5
|
||||
| Pause the debugged application.
|
||||
|-
|
||||
| F11
|
||||
| Step into.
|
||||
|-
|
||||
| F10
|
||||
| Step by step.
|
||||
|-
|
||||
| Shift+F11
|
||||
| Step out.
|
||||
|}
|
||||
|
||||
|
||||
==Miscellaneous==
|
||||
|
||||
===File shortcuts===
|
||||
|
||||
{|
|
||||
|-
|
||||
| '''Key shortcut'''
|
||||
| '''Purpose'''
|
||||
|-
|
||||
| Ctrl+S
|
||||
| Save the file currently edited in the editor.
|
||||
|-
|
||||
| Ctrl+N
|
||||
| Open a new window.
|
||||
|}
|
||||
|
||||
|
||||
===Editor views shortcuts===
|
||||
|
||||
{|
|
||||
|-
|
||||
| '''Key shortcut'''
|
||||
| '''Purpose'''
|
||||
|-
|
||||
| Ctrl+Shift+T
|
||||
| Display the text view in the editor.
|
||||
|-
|
||||
| Ctrl+Shift+C
|
||||
| Display the clickable view in the editor.
|
||||
|-
|
||||
| Ctrl+Shift+F
|
||||
| Display the flat view in the editor.
|
||||
|-
|
||||
| Ctrl+Shift+O
|
||||
| Display the contract view in the editor.
|
||||
|-
|
||||
| Ctrl+Shift+I
|
||||
| Display the flat contract view in the editor.
|
||||
|}
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,74 @@
|
||||
[[Property:title|EiffelStudio window overview]]
|
||||
[[Property:weight|1]]
|
||||
[[Property:uuid|db4e1555-8bf3-7418-f754-9defe584044b]]
|
||||
==Window layout==
|
||||
|
||||
In EiffelStudio all windows have the same components. However, components to be displayed are chosen by the user. Moreover, windows have two modes: the edition mode and the debug mode. Basically, a standard window looks like this:
|
||||
|
||||
[[Image:general-edition-mode]]
|
||||
|
||||
As you can see, it is divided in several parts: a top section, a left panel, a right panel and a status bar.
|
||||
|
||||
The top part is rather not surprising. It first contains a menu bar, which adapts itself to the context of the current project. It also contains two toolbars (the main toolbar and the project toolbar). Between the toolbars is located the main address bar.
|
||||
|
||||
The left panel contains various ''tools'' that help the navigation in the system.
|
||||
|
||||
The right panel contains two major tools: the editor and the context tool.
|
||||
|
||||
The status bar supplies various information:
|
||||
* Its first field gives punctual information concerning a recent operation (such as loading a project, syntax errors in a class text, etc.).
|
||||
* The second field contains the name of the current project, which can come quite handy if you work on several projects simultaneously.
|
||||
* The next field contains the current line and column in the main editor of the window (lines and columns start at position 1).
|
||||
* The last three fields contain icons representing the state of the project, according to several points of view.
|
||||
** The first icon indicates whether some class files have been edited since the last compilation. This makes it easy to know whether you have changes to take into account ( [[Image:16x16--general-edit-icon]] ) and whether you should recompile.
|
||||
** The second icon gives the compilation state of the project. It may indicate either that the last compilation was successful [[Image:compile-success-icon]] , or that it failed [[Image:compile-error-icon]] or that the project is being compiled [[Image:compile-animation-6-icon]] .
|
||||
** The last icon gives the state of the debugger. It may indicate that the application is running [[Image:run-animation-4-icon]] , paused [[Image:debug-pause-icon]] or dead (no icon).
|
||||
|
||||
|
||||
In debug mode, a window looks like this:
|
||||
|
||||
[[Image:general-debug-mode]]
|
||||
|
||||
In debug mode, the same tools are present, but there are three extra tools. Two are located in the left panel, which display respectively the call stack and the dynamic value of expressions. The other is in the right panel and can be used to view the state of objects while debugging.
|
||||
|
||||
==Layout configuration==
|
||||
|
||||
===Tool configuration===
|
||||
|
||||
All tools have similar controls to give their display options. It is possible to minimize, restore and maximize all tools by using the proper button in their top right-hand corner. Most tools can also be closed. These tools have a close button in the corner.
|
||||
* The minimize button [[Image:toolbar-minimize-icon]]
|
||||
* The maximize button [[Image:toolbar-maximize-icon]]
|
||||
* The restore button [[Image:toolbar-restore-icon]]
|
||||
* The close button [[Image:toolbar-close-icon]]
|
||||
|
||||
Tools that can be closed have a corresponding entry in the '''View/Explorer Bar''' menu. They also have a corresponding button in the main toolbar.
|
||||
|
||||
The only tools that cannot be closed are the editor, and when in debug mode the debug tools.
|
||||
|
||||
===Toolbar configuration===
|
||||
|
||||
Both main toolbars can be customized. This allows to select buttons that should be displayed in the toolbars, as well as whether an explanatory text should be displayed next to icons.
|
||||
|
||||
==Context tool==
|
||||
|
||||
The context tool, located in the right panel, is a major part of EiffelStudio. It itself contains several tabs that each correspond to some powerful functionality.
|
||||
* The '''Output''' tab is where general information and error messages are displayed
|
||||
* The '''Diagram''' tab uses the BON notation to analyze and design a project
|
||||
* The '''Class''' tab gives advanced information concerning a class
|
||||
* The '''Feature''' tab gives advanced information concerning a feature
|
||||
* The '''Metrics''' tab provides quantitative information concerning a system or some of its components
|
||||
|
||||
By default, the context tool is unlinked from the rest of the window, which means all left tools refer to the object that is in the editor and the main toolbar, while the context tool (and the debug tools if they are present) displays information concerning a different object. It is possible to link the context tool, so that the whole development window displays information relative to the same development object.
|
||||
|
||||
{{seealso|<br/>
|
||||
[[Introducing EiffelStudio]] <br/>
|
||||
[[Browsing tools|Browsing tools]] <br/>
|
||||
[[Main toolbars|Toolbar customization]] <br/>
|
||||
[[EiffelStudio Editor]] <br/>
|
||||
[[Formatted information about compiled classes and features]] <br/>
|
||||
[[Diagram tool]] <br/>
|
||||
[[Metrics tool|Metric tool]] }}
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,6 @@
|
||||
[[Property:title|EiffelStudio: General interface description]]
|
||||
[[Property:link_title|General Description]]
|
||||
[[Property:weight|-14]]
|
||||
[[Property:uuid|9202a4d2-4fee-f4e6-1b7e-12dad9adc3d0]]
|
||||
In addition to this information describing the EiffelStudio user interface, you may also want to check out the section on [[Docking|docking]] in the EiffelBuild documentation.
|
||||
|
||||
@@ -0,0 +1,49 @@
|
||||
[[Property:title|Main toolbars]]
|
||||
[[Property:weight|2]]
|
||||
[[Property:uuid|56116a68-5881-0393-63d3-dc2044dd4613]]
|
||||
At the top of a development window, the toolbars are displayed by default. The four toolbars are:
|
||||
# '''Standard buttons''' toolbar
|
||||
# '''Project''' toolbar
|
||||
# '''Address''' toolbar
|
||||
# '''Refactoring''' toolbar
|
||||
|
||||
You can choose which toolbars are displayed by right-clicking one of the toolbars, or by following the menu path:
|
||||
|
||||
<code lang="text">
|
||||
View --> Toolbars
|
||||
</code>
|
||||
|
||||
In the figure below, all four toolbars are visible.
|
||||
|
||||
|
||||
[[Image:standard-toolbars]]
|
||||
|
||||
|
||||
The standard buttons toolbar and the project toolbar are docked next to each other on the same toolbar line. So the standard buttons toolbar is indicated here:
|
||||
|
||||
[[Image:standard-buttons-toolbar]]
|
||||
|
||||
|
||||
and the project toolbar is indicated here:
|
||||
|
||||
|
||||
[[Image:project-toolbar]]
|
||||
|
||||
|
||||
The address toolbar shows the currently targeted class and feature, and has button-holes for advanced views:
|
||||
|
||||
|
||||
[[Image:address-toolbar]]
|
||||
|
||||
|
||||
The refactoring toolbar has button-holes for Pull-Up and Rename Class/Feature [[Refactoring|refactoring actions]]:
|
||||
|
||||
|
||||
[[Image:refactoring-toolbar]]
|
||||
|
||||
|
||||
{{note|For each toolbar, it is possible to choose which buttons are displayed and which ones are not. See the [[Toolbar customization|Toolbars customization page]] for more information. Also, you can change the location of the toolbars by undocking and/or redocking them. See more at [[Customizing the tools layout and toolbars]].}}
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user