Go Up to Using the Code Editor and the IDE
The Code Editor and the Form Designer occupy the center pane of the IDE window. The Code Editor is a full-featured, customizable UTF8 editor that provides syntax highlighting, multiple undo capability, and context-sensitive help for language elements.
As you design the user interface for your application, Appmethod generates the underlying code. When you modify object properties, your changes are automatically reflected in the source files.
Because all of your programs share common characteristics, Appmethod autogenerates code to get you started. You can think of the autogenerated code as of an outline that you can examine to create your program.
Code Editor Context Menu describes the context menu commands for the Code Editor.
To help you write code, the Code Editor provides the features described in this section.
- 1 Change Bars
- 2 Indenting Code
- 3 Formatting Code
- 4 Code Insight
- 5 Code Navigation
- 6 Live Templates
- 7 Code Folding
- 8 Refactoring
- 9 SyncEdit
- 10 To-Do Lists
- 11 Keystroke Macros
- 12 Bookmarks
- 13 Block Comments
- 14 See Also
The left margin of the Code Editor displays a green change bar to indicate lines that have not been changed in the current editing session. A yellow change bar indicates that changes have been made since the last File > Save operation.
You can, however, customize the change bars to display in colors other than the default green and yellow. Select Tools > Options > Editor Options > Color. In the Element drop-down menu, select Modified Line then change the foreground and the background colors.
You can use the
Tab key to indent the current line of code or a block of code in the Code Editor. The number of spaces that the
Tab key indents is determined by the Block indent option on the Tools > Options > Editor Options > Source Options dialog box.
- To indent a line of code, place the cursor at the beginning of the line and press
- To indent an entire block of code, highlight the code block and press
- To move text to the left ("outdent"), use
Shift + Tab.
Appmethod provides the customizable source code formatter. Editing code in the Code Editor, you can apply the Format Source context menu command (or the Edit > Format Source menu command) to format the source code. You can set the Indentation, Spaces, Line Breaks, Capitalization, and Align formatting options under the Formatter group in the Options dialog box (Tools > Options > Formatter). Notice that the Format Source command implements automatic formatting of your code. It takes into account only formatting options specified in the Options dialog box and totally overwrites all your manual formatting implemented in the Code Editor. For example, it ignores your manual code indenting. You can select a block of code and call the Format Source command, so that only this block will be formatted.
Code Insight refers to a subset of features embedded in the Code Editor (such as Code Parameter Hints, Code Hints, Help Insight, Code Completion, Class Completion, Block Completion, and Code Browsing) that aid in the code writing process. These features help identify common statements you want to insert into your code, and assist you in the selection of properties and methods. Some of these features are described in more detail in the following subsections.
To invoke Code Insight, press
Ctrl+Space while using the Code Editor. A pop-up window displays a list of symbols that are valid at the cursor location.
To enable and configure Code Insight features, choose Tools > Options > Editor Options and click Code Insight.
When you're using the Object Pascal Language, the pop-up window filters out all interface method declarations that are referred to by property read or write clauses. The window displays only properties and stand-alone methods declared in the interface type. Code insight supports WM_xxx, CM_xxx, and CN_xxx message methods based on like-named constants from all units in the uses clause.
Code Parameter Hints
Displays a hint containing argument names and types for method calls. Available between the parenthesis of a call, for example, ShowMessage ( | );.
You can invoke Code Parameter Hints by pressing
Displays a hint containing information about the symbol such as type, file, and line # declared at.
You can display Code Hints by hovering the mouse over an identifier in your code, while working in the Code Editor.
Note: Code Hints only work for Object Pascal when you have disabled the Help Insight feature. To disable Help Insight, cancel the selection of Tooltip help insight on the Tools > Options > Editor Options > Code Insight dialog box.
Invoke Help Insight by hovering the mouse over an identifier in your code, while working in the Code Editor. You can also invoke Help Insight by pressing
The Code Completion feature displays a drop-down list of available symbols at the current cursor location. To invoke Code Completion:
Ctrl+Space(always invokes Code Completion).
.(only works when Auto Invoke is enabled on the Code Insight page).
To cancel a Code Completion request, press the
Class completion simplifies the process of defining and implementing new classes by generating skeleton code for the class members that you declare. By positioning the cursor within a class declaration in the interface section of a unit and pressing
Ctrl+Shift+C (or right-clicking and selecting Complete class at cursor on the Code Editor context menu), any unfinished property declarations are completed. For any methods that require an implementation, empty methods are added to the implementation section.
You can also use class completion to fill in interface declarations for methods that you define in the implementation section.
When you press
Enter while working in the Code Editor and there is a block of code that is incorrectly closed, the Code Editor enters the closing block token at the next available empty line after the current cursor position. For instance, if you are using the Code Editor with the Object Pascal language, and you type the token begin and then press
Enter, the Code Editor automatically completes the statement so that you now have: begin end.
Code Browsing (Ctrl+Click)
While using the Code Editor to edit an application such as a FireMonkey Forms application, you can use
Ctrl+click to automatically "jump to" the code that defines an identifier. To browse code, hold down the
Ctrl key while passing the mouse over the name of any class, variable, property, method, or other identifier. After the mouse pointer turns into a hand and the identifier is highlighted and underlined, click the highlighted identifier, and the Code Editor jumps to the declaration of the identifier, opening the source file, if necessary.
You can do the same thing by right-clicking an identifier and choosing Find Declaration from the context menu.
Code browsing can find and open only the units that exist in the project Search path or in the global Browsing path. Directories are searched in the following order:
- Either the project-specific Search path for Object Pascal (Project > Options > Object Pascal Compiler) or the Include path for C++ (Project > Options > Directories and Conditionals).
- The global Browsing path (for Object Pascal: Tools > Options > Environment Options > Object Pascal Options > Library , or for C++: Tools > Options > Environment Options > C++ Options > Paths and Directories).
An alternative to using
Ctrl+click to go to the declaration of an identifier is to use
Alt+Up (arrow). For other useful key combinations, see Default Keyboard Shortcuts.
The sections below describe features that you can use to navigate your code while you are using the Code Editor.
You can navigate between methods using a series of editor hotkeys. You can also lock the hopping to occur only within the methods of the current class. For example, if class lock is enabled and you are in a method of TComponent, then hopping is only available within the methods of TComponent.
The keyboard shortcuts for Method Hopping are as follows:
Ctrl+Q^L-- toggles class lock.
Ctrl+Alt+Up arrow-- moves to the top of the current method, or the previous method.
Ctrl+Alt+Down arrow-- moves to the next method.
Ctrl+Alt+Home-- first method in source.
Ctrl+Alt+End-- last method in source.
Ctrl+Alt+Mouse_Wheel-- scrolls through methods.
Allows you to find classes. Use the Search > Find Class command to see a list of available classes that you can select. After you choose one, the IDE navigates to its declaration.
If you are programming in the Object Pascal language, you can use a refactoring feature to locate namespaces or units. Use the Find Unit command to locate and add units to your code file.
Finding the Next and Previous Changes
As you edit code, you can use keystrokes to quickly navigate to the Next and the Previous changes that you have made. The keyboard shortcuts are:
Ctrl+Shift+F7-- moves to the previous line modified since the file was opened (green marking in the gutter).
Ctrl+Shift+F8-- moves to the next line modified since the file was opened (green marking in the gutter).
Alt+Shift+F7-- moves to the previous line modified since the last save (yellow marking in the gutter).
Alt+Shift+F8-- moves to the next line modified since the last save (yellow marking in the gutter).
If the next or previous line is in an elided (folded) block, the block is unfolded. Code folding is described later in this topic.
Keystrokes are the same for the following keyboard mappings: Default, IDE classic, Brief, and Epsilon. The Visual Studio and Visual Basic keyboard mappings do not have keystrokes for Next/Previous change.
Searching Source Code for Usages
If you are programming in the Object Pascal language, you can use the Search for Usages feature to find usages of classes, methods, variables, and overriding methods, derived classes and implemented interfaces in your source code projects.
Live Templates allow you to have a dictionary of pre-written code that can be inserted into your programs while you're working with the Code Editor. This reduces the amount of typing that you must do.
Use the links at the end of this topic to learn more about creating and using Live Templates.
Code folding lets you collapse or expand regions or blocks of code. Collapsing your code creates a hierarchical view of the code and makes it easier to read and navigate. The collapsed code is not deleted, but hidden from view until you expand it. Code folding is on by default.
To use code folding, click the plus (+) and minus (-) signs located on the left edge of the Code Editor:
- Click the plus (+) sign to expand the associated region of code.
- Click the minus (-) sign to collapse the associated region of code.
To enable/disable code folding:
- Use the Code Folding check box on the Tools > Options > Editor Options dialog box.
- Use the keyboard shortcut
You can also use the context menu Fold command to fold specific types of regions, such as Types, Methods, XML Doc comments (for Object Pascal), and the 'Nearest' region. The Fold and Unfold commands are described in Code Editor Context Menu. For more information about code folding, including how to create code folding regions, see Using Code Folding.
Refactoring is the process of improving your code without changing its external functionality. For example, you can turn a selected code fragment into a method by using the extract method refactoring. The IDE moves the extracted code outside of the current method, determines the needed parameters, generates local variables if necessary, determines the return type, and replaces the code fragment with a call to the new method. Several other refactoring methods, such as renaming a symbol and declaring a variable, are also available.
The Sync Edit feature lets you simultaneously edit identical identifiers in code. As you change the first identifier, the same change is performed automatically on the other identifiers. You can also set jump points to navigate to specific sections of your code.
A To-Do List records tasks that need to be completed for a project. After you add a task to the To-Do List, you can edit the task, add it to your code as a comment, indicate that it has been completed, and then remove it from the list. You can filter the list to display only those tasks that interest you.
You can record a series of keystrokes as a macro while editing code. After you record a macro, you can play it back to repeat the keystrokes during the current IDE session. Recording a macro replaces the previously recorded macro.
Bookmarks provide a convenient way to navigate long files. You can mark a location in your code with a bookmark and jump to that location from anywhere in the file.
You can drag-and-drop bookmark icons in the gutter of the Code Editor, and a moved bookmark has the number of the original bookmark.
You can comment-out a section of code by selecting the code in the Code Editor and pressing
Ctrl+/ (slash). Each line of the selected code is prefixed with // and is ignored by the compiler. Pressing
Ctrl+/ adds or removes the slashes, based on whether the first line of the code is prefixed with
//. When using the Visual Studio or Visual Basic key mappings, use
Ctrl+K+C to add and remove comment slashes.
- Code Editor Context Menu
- Customizing the Code Editor
- Formatting Source Code
- Using Bookmarks
- Using Class Completion
- Using Code Folding
- Using Code Insight
- Using the History Manager
- Using Sync Edit
- Using the HTML Tag Editor
- Creating Live Templates
- Using Live Templates
- Creating Template Libraries
- Recording a Keystroke Macro
- Refactoring Code
- Code Completion
- XML Documentation Comments
- Using To-Do Lists
- Form Designer
- History Manager