| Navigation: Application Generator >====== Embedded Source Dialog ====== |    |
This dialog allows you to access Embed points from the Procedure Properties dialog.
By adding embedded source code to a procedure, you gain powerful customization capability. You can specify or create code to execute at any defined point in the source code. You can write your own code, or use a code template to write the code for you. The Application Generator adds your code to the code it generates, at precisely the point at which you specify.
This dialog lists all the available embed points, as defined by the procedure template.
To see your embedded source code in context, use the Embeditor instead (from this window, press the Source button. From the Application Tree, RIGHT-CLICK on the procedure and choose Source).
Edit Options
The Edit Toolbar Menu (and the edit buttons on the right) allow you to manipulate your embedded source code.
| Save and Close | Save your editing session and closes the Embeds dialog |
| Cancel | Cancels your editing session and closes the Embeds dialog. |
| Save | Saves any changes and keep the Embeds window opened. |
| Actions | Opens the Actions dialog for the target template where approproiate. |
| Cut (CTRL+X) | Cuts the highlighted embedded source to the clipboard, allowing you to paste it into another embed point in this or any other procedure (including procedures in other applications). |
| Copy (CTRL+C) | Copies the highlighted embedded source to the clipboard, allowing you to paste it into another embed point in this or any other procedure (including procedures in other applications). |
| Paste (CTRL+V) | Pastes embedded code from the clipboard into the highlighted embed point. |
View Options
This toolbar section allows you to adjust the display to show only what you want to see.
| Show Filled Only | Show only filled embeds. |
| Show Priority Labels | Show template generated embed point labels so you can precisely interleave your code with template generated code. |
| Show Window Embeds | Available only when editing embeds for a control, this button allows you to expand the view to show embeds for the window. |
| Show Legacy Embeds | Show Clarion 2.x embed points.You may set the default for legacy embed points with the Application tab of the Application Options dialog. Choose Tools  Application Options. |
| Previous Filled (CTRL+P) | Moves the selection to previous filled embed point. It expands the tree as needed. |
| Next Filled (CTRL+N) | Moves the selection to next filled embed point. It expands the tree as needed. |
| Refresh | Refresh the Embeds Tree |
Embed Buttons
| Insert (INS) | Opens the Select Embed Type dialog, which allows you to add handwritten source code, call a procedure, and/or choose a code template. |
| Properties (ENTER) | Allows you to edit the embedded code. If it is hand written code, then the Text Editor appears. If it's a code template, the prompts dialog for the code template appears. |
| Delete (DEL) | Allows you to delete embedded code you previously added. |
| Move Up (CTRL+UP) | Moves the embedded code item up above another (modifying the Priority). Each executes in the order they appear at an embed point. |
| Move Down (CTRL+DOWN) | Moves the embedded code item down below another (modifying the Priority). Each executes in the order they appear at an embed point. |
| Priority | Sets the Priority for the embedded source. The Priority of each block within an embed point controls the execution sequence of the code relative to any other code in the same embed point. Lower priority numbers execute before higher priority numbers.Moving an embed up or down changes its priority. |
| Filled button | Press this button to only show embed points that actually have had source code entered into them. |
| Source button | Press this button to call the Embeditor, allowing you to see your embedded source in context. |
| Expand All | Fully expand the embeds list. |
| Contract All | Fully contract the embeds list. |
| Expand Filled | Expand only the filled embeds. |
See Also: