Reusing the Form Displaying Method Source

You can specify whether you want to reuse the same form to display the source of a method, when possible, rather than creating a new form for each such request. The option to reuse the same method source window is used when:

• A method source window is restored when the JADE development environment is initiated.

• You double‑click an initialize or finalize method entry on the Application Browser.

• You double‑click on a method in a Class Browser.

• You double‑click on a method in the Methods List of a Class Browser.

• You double-click on a method displayed in the methods list of the Method Status List Browser or you double‑click a method entry while holding down the Shift key.

• You press F12 when in a method source window.

• You press F11 when a method identifier is selected in a method.

  The bubble help includes the creation timestamp and patch version of the entity that F11 selected.

• You double‑click on an entry in a breakpoint list browser.

• You double‑click on a method in a Library list browser.

• You copy a method using the Methods menu Copy command.

• You add a new method while the method source window has focus.

To reuse the same form to display method source, perform one of the following actions

• Check the Reuse Same Method Source Window For All check box on the Source Management sheet of the Preferences dialog, documented in "Maintaining Source Management Options", in Chapter 2.

• Select the Use Same Method Source Window For All command in the View menu, to toggle the reuse of the method source window.

  As this command controls only any request made from the current editor pane, you can use it to determine whether the Reuse Same Method Source Window For All check box on the Source Management sheet of the Preferences dialog is checked.

  From version 2016.0.01, when the Reuse Same Method Source Window For All check box on the Source Management sheet of the Preferences dialog is checked, pressing F11 on a method name in the editor pane logic adds the list of local implementors of that method to the methods list in the History List of the Reused Method Source form instead of displaying a separate window to display the list of implementors. A parent entry of those methods called Local Implementors of Method: method‑name is added to that list box.

When you have specified that you want to reuse the same form to display method source and you press F12 in the editor pane, JADE initially creates a new form to display the method source, and a list box that displays the history of how you got to that form. Each subsequent request to show another method uses the same window and adds the additional navigational history to the list box, as shown in the following example.

Click on an entry in the list box to display the method source for that entry, unless the currently displayed method has been changed, in which case the Save Method message box prompts you to save and compile your changes, to discard them, or continue editing the method. Conversely, if the method source in a shared window has been changed, when the new method source request is made, a message box is displayed informing you that the window cannot be shared (until the changes are saved or restored), and asking whether you want a new method source window to be opened. You can then cancel the request or click OK to open another window.

If you close a form that is displayed in the method source browsing history list box, that entry is removed from the list box when the form is next activated. Similarly, if a method that is displayed in the method source browsing history list box is deleted, that entry is removed from the list box.

The method source browsing history list box entries are updated to use the current form caption when the form is activated.

You can open a method source in a separate window that can be floated without first unchecking the Reuse Same Method Source Window For All check box preference, by double‑clicking a method entry while holding down the Shift key in the:

• Class Hierarchy Browser, Class References Browser, Method Status List Browser, or Senders Browser (search results list), to open a separate method source window for the method regardless of the setting of the reuse option.

• History List of the Reused Method Source form, to open a separate method source window for the method and to remove the method from the History List.

If there are no methods left in the History List, the Reused Method Source form is closed. In addition, the Methods menu Remove from List command is enabled for the Reuse Method Source window when a method entry is selected in the History List. Clicking that command removes the selected method from the History List. If there are no methods left in the History List, the Reused Method Source form is closed.

To reuse the same method source form for each browser origin, perform one of the following actions

• Check the Reuse Same Method Source Window For Each Origin check box on the Source Management sheet of the Preferences dialog, documented in "Maintaining Source Management Options", in Chapter 2.

• Select the Use Same Method Source Window For Each Origin command in the View menu, to toggle the reuse of the method source window.

  As this command controls only any request made from the current editor pane, you can use it to determine whether the Reuse Same Method Source Window For All check box on the Source Management sheet of the Preferences dialog is checked.

This results in one History List of the Reused Method Source form for each browser origin; for example, pressing F11 on a method name in a method in the editor pane opens an extended source window that is populated only with actions in the original browser or in the displayed extended source window (the History List of the Reused Method Source form). Performing actions that cause use of a source window in another browser opens a new extended source window rather than using any other open source window not initiated by that browser.

Clicking the form entry in the methods list in the History List of the Reused Method Source form returns you to the originating form. (As the original method can be modified, displaying another copy of the method source is not desirable.)

2016.0.01 and higher