This menu contains commands for working with the text editor built into RadiaCode. The commands in this menu apply to the currently active editor window. | Button | Command | Description | | ---------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ![[ImagesPC1/Edit_Undo.bmp]] | Undo | Reverts the last text editing operation in this window. The number of undo steps is set in the Configuration menu on the Editor Options tab of the Editor Options dialog. | | ![[ImagesPC1/Edit_Copy.bmp]] | Copy Block | Copies the selected block to the clipboard. The text format in the clipboard is standard, making the block available to other programs. | | ![[ImagesPC1/Edit_Cut.bmp]] | Cut Block | Deletes the selected block and places it in the clipboard. | | ![[ImagesPC1/Edit_Paste.bmp]] | Paste Block | Inserts the block from the clipboard starting at the cursor. <br>If the block was copied from RadiaCode, the block type remains unchanged (line, vertical, or stream). Blocks from other applications will default to the standard stream type. | | ![[ImagesPC1/Edit_ClipHistory.bmp]] | Clipboard/Repository History | Opens the Clipboard/Repository History dialog. | | ![[ImagesPC1/Edit_Append.bmp]] | Append Block to Clipboard | Copies the selected text block and adds it to the end of the current clipboard contents. | | ![[ImagesPC1/Edit_CutAppend.bmp]] | Cut Block and Append to Clipboard | Deletes the selected block and appends it to the end of the current clipboard contents. | | ![[ImagesPC1/Edit_Search.bmp]] | Search Text | Opens the Search Text dialog. | | ![[ImagesPC1/Edit_NextSearch.bmp]] | Repeat Search | Repeats the search with the same parameters set for the previous search. | | ![[ImagesPC1/Edit_Replace.bmp]] | Search/Replace Text | Opens the Search/Replace Text dialog. | | ![[ImagesPC1/Edit_SearchResults.bmp]] | Show Search Results in Files | Reopens the search results from multiple files in the Search Results dialog. | | | Go to Line Number | Opens the Go to Line dialog, displaying the text starting from the specified line. | | ![[ImagesPC1/Edit_AddBookMark.bmp]] | Add Bookmark | Opens the Add Bookmark dialog for local bookmarks. | | ![[ImagesPC1/Edit_RetrieveBookMark.bmp]] | Retrieve Bookmark | Opens the Retrieve Bookmark dialog for local bookmarks. | | ![[ImagesPC1/Edit_Condensed.bmp]] | Condensed Text Mode | Toggles Condensed Text Mode. | | ![[ImagesPC1/Edit_CondensedSetup.bmp]] | Condensed Text Mode Settings | Opens the Condensed Text Mode Settings dialog. | | | Find Matching Bracket/Comment | Finds the matching bracket or comment tag for the bracket or tag at the cursor position. If a match is found, the cursor will move to it.<br><br>Brackets can be: parentheses ( ), square brackets [ ], or curly braces { }. Comment tags can be /* or */. | | ![[ImagesPC1/Misc_LastEditContext.bmp]] | Restore Edit Context | Activates the editor window of the previous editing session and moves the cursor to the last edit location. If that editor window was closed, RadiaCode<br><br>will reopen it. During debugging, frequent switching between several files is common. This command allows you to quickly return to the last edit location. | | | User Scripts | Provides an additional menu to access text editing automation functions. | ### Search Text Dialog This dialog sets parameters for searching text phrases in files. The parameters in this dialog and the Search/Replace Text dialog are equivalent. You can specify file names with one or more wildcard characters. File paths can also be specified. You can search multiple files simultaneously using the options in the Search in Files panel. | Dialog Element | Description | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Search String | Specifies the text fragment to search for (search string). | | Match Case | Enables case-sensitive matching. Disabled by default. | | Match Whole Words Only | Searches for whole words only: the string will only be found if it is surrounded by punctuation or delimiters (spaces, tabs, commas, quotes, etc.). Disabled by default. | | Use Expressions | Specifies that the search string is a search expression. Disabled by default. | | Entire Scope | Searches the entire file. Enabled by default. | | Search Selected Text Only | Searches only in the selected text. | | Start from Cursor | Begins the search from the current cursor position. | | Search Entire Scope | Searches from the beginning or end of the file (depending on search direction). Enabled by default. | | Search in Files | Enables searching across multiple project files (see notes below). If unchecked, the search will only occur in the active editor window. | | File Masks | Contains a mask or masks for file names to search in. If there are multiple masks, separate them with semicolons. To specify long file names as used in Windows, no quotes are needed. Example: *.txt;*.c;c:\prog\*.h. | | Search in Subdirectories | Searches in subdirectories of all folders specified by the masks. | | Starting Path | Starts the search from the folder specified here. This folder serves as a common path, useful when combining several masks like:<br><br>c:\prog\text\source\*.txt;c:\prog\text\source\*.doc<br><br>In this case, use the masks (*.txt;*.doc) and the common path (c:\prog\text\source). | | | | >[!note] If searching in a file open in the **Editor** window, the search will be performed in the window's buffer, not in the file on disk. ### Search/Replace Text Dialog This dialog sets the parameters for searching and replacing text phrases in files. The parameters in this dialog are equivalent to those in the **Search/Replace Text** dialog. You can specify file names with one or more wildcard characters. You can also include the file path and perform a search across multiple files using the options in the **Search in Files** panel. | Dialog Element | Description | | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Search String | Specifies the text fragment to search for (search string). | | Replace With | Specifies the text fragment that will replace the found text. | | Match Case | Enables case-sensitive matching. Disabled by default. | | Match Whole Words Only | Searches for whole words only: the string will only be found if it is surrounded by punctuation or delimiters (spaces, tabs, commas, quotes, etc.). Disabled by default. | | Use Expressions | Specifies that the search string is a search expression. Disabled by default. | | Confirm Replacement | Enables the "Confirm Replacement" dialog to confirm each instance of text replacement. Enabled by default. | | Entire Scope | Searches the entire file. Enabled by default. | | Search Selected Text Only | Searches only within the selected text. | | Start from Cursor | Begins the search from the current cursor position. | | Search Entire Scope | Searches from the beginning or end of the file, depending on the search direction. Enabled by default. | | Search in Files | Enables searching across multiple project files (see notes below). If unchecked, the search will only occur in the active editor window. | | File Masks | Contains one or more file name masks for the search. If there are multiple masks, they should be separated by semicolons. Long file names as used in Windows do not need quotes. Example: *.txt;*.c;c:\prog\*.h. | | Search in Subdirectories | Searches in the subdirectories of all folders specified by the masks. | | Starting Path | Specifies the folder to start the search from. This folder serves as a common path, useful when combining several masks like:<br>c:\prog\text\source\*.txt;c:\prog\text\source\*.doc<br>In this case, use the masks (*.txt;*.doc) and the common path (c:\prog\text\source). | | Search | Replaces the first found instance of the search string. | | Replace All | Replaces all found instances of the search string. | >[!note] >1. If searching in a file open in the **Editor** window, the search will be performed in the window's buffer, not the file on disk. > 2. If searching across multiple files, a **Search Results in Files** dialog will open once the search is completed. This translation preserves the detailed functionality of the search and replace dialog, ensuring the user can understand how to set the appropriate search and replace parameters for working with multiple files. ## Dialog Confirm Replace This dialog asks for confirmation to replace the found instance of the search string. To enable or disable this dialog, use the **Confirm Replace** flag in the Find/Replace Text dialog. | Button | Function | | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | Yes | Replace this instance of the search string. | | None | Do not replace. If the procedure was started by clicking Replace All for all found rows in the search scope, the search and replace process will continue. | | Non-Stop | From now on, replace all lines found in this file without prompting for confirmation. | | Cancel | Stop the search and replace process. <br> | | Skip this file | Stop searching this file and move on to the next file. | | Replace in all files | Replace all rows found in all other files without prompting for confirmation. | | Place the cursor on the Yes/No buttons | When the flag is set, the cursor will be automatically placed on the Yes button in each request for confirmation of replacement, for ease of use. | ### Dialog File Search Results This dialog displays search results in multiple files. For more information about multi-file search, see Dialog **Text Search.** **The list of files in which** is found contains all files where the search string was found: on the left is the file name, and its folder is on the right. A line of green text immediately below this list displays information about the file highlighted in the list. The entry "File in memory" means that the file is open in the **Editor** window. If this line shows general data about the file (according to the file system), then this file is not loaded into memory. The String panel displays the source file string containing the fragment you are looking for. The **Sort files** by radio button sets the sorting method. When the **Include directory** flag is set, the files in the list will be sorted based on their folders. The **Edit** button opens the selected file in a new **Editor** window and places the cursor in the line with the found fragment. The found fragment will be marked with the background color. To check if there are other instances of the search fragment in this file, press **Ctrl + R** or use the **Editor** menu, the Search Again command. The **Close** button closes the dialog, but the search results are not lost. To open this dialog again, use the **Show search results for files** button on the editor toolbar, the **Shift + F5** keys or the Editor menu command of the same name. In this case, the files in the List of files in which the line was found opened in the **Editor windows are** indicated by an asterisk on the left. ### Search Expressions The text editor supports so-called "search expressions," which can be used for special text strings. Search expressions contain control characters in the text string you are searching for: | | | | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ? | Means any one character at this position. Example: if you set? ell as the search string, the words "bell," "tell," "cell," etc. will be found. | | % | Indicates the beginning of a line. Characters following "%" must start at position 1. Example:% Counter - find the word "Counter," which begins with the first position in the line. | | $ | End of line. Characters preceding "quot; must be in the last position in the string. Example: Counter $ - find the word "Counter" at the end of lines. | | @ | Find the symbol itself; "@" allows you to specify control characters like regular letters. Example: @? -Find a question mark. | | \xNN | Hexadecimal character value. Example :\xA7 - find a character whose hexadecimal code is A7. | | + | Undefined number of units of the previous character. For example, if you specify 1T + 2, the editor will find lines containing "1," followed by "2," between which there is any number of letters T. < br > | | [c1-c2] | Equals any character between c1 and c2. Example: [A-Z] means any letter from A to Z. | | [~ c1-c2] | Equals any character that is not between c1 and c2, that is, between 0 and c1-1, or between c2 + 1 and 255. Example: [~ A-Z] means any character other than uppercase letters. | | text1\| text2 | The character "\| "denotes a logical OR and the editor will look for text1 or text2. Example: LPT\| COM\| CON - find "LPT," or "COM," or "CON." | Do not forget that in order to use search expressions, you need to set the corresponding flag in the dialog. ### Dialogs Bookmark/Reset Bookmark Bookmarks are used to return to the next marked position of the cursor in the source text file. There are local and global bookmarks. Local bookmarks operate within the same file. Global bookmarks store not only the cursor position, but also the file name. Using these dialogs, you can define and use up to 10 local bookmarks. Each local tab is assigned an individual button with a number. To open the **Bookmark** dialog, press **Alt + [**. To open the ** Restore Bookmark ** dialog, press **Alt +]**. To set a bookmark or go to it, click its button with a number. The line number in which the bookmark is set, the position of the bookmark in the line (in parentheses) and the text of this line are displayed to the right of the button. Local bookmarks are stored in the configuration file and can be returned to in the next session. The button **Global Bookmarks** opens the corresponding dialog **Set/Restore Global Bookmark.** ### Dialogs Set Reset Global Bookmark Bookmarks are used to return to the next marked position of the cursor in the source text file. There are local and global bookmarks. Local bookmarks operate within the same file. Global bookmarks store not only the cursor position, but also the file name. When you go to the global tab and the corresponding source file is not open in the **Editor** window, RadiaCode will open it and place the cursor in the bookmarked position. The **Delete** button removes the selected bookmark from the list. Global bookmarks are stored in a configuration file and can be returned to in the next session. ### Compressed text mode In Condensed mode, the window displays only the rows that meet the specified criteria. There are two criteria in total: - The string must contain the specified fragment (character sequence) - The first character in the string that is not a space must be in the specified position. Examples: (a) the first of the criteria and the "counter" fragment are specified, the result - only lines with the word "counter" will be displayed; (b) the second criterion and position 4 are given, the result - only lines in which the text starts from the 4th position will be displayed. Compressed text mode "collects" lines with a common feature. For example, if you strictly adhere to the rule to start declaring data from position 2, procedures from position 3, and interrupt handlers from position 4, then the compressed text mode will really speed up the search for the desired announcement. If you comment on certain places in the text with the same string of characters and use the compressed text mode with the specified fragment, then this style makes it easy to find the desired sections of the text. In compressed text mode, you can move the cursor in the same way as in normal mode. ---- **How to manage Line display criteria are set in the dialog **Compressed text mode parameters**. To enable or disable the compressed text mode, use the **Editor** menu command, or the **Compressed Text Mode** button on the editor toolbar, or the **F11** key. Press Esc to exit compressed text mode. In this case, when you exit this mode, the cursor returns back to its place where it was before starting this mode. To leave the cursor in the line where you placed it while the mode was turned on, press Enter or start editing this line. ### Dialog Compressed text mode parameters This dialog controls the compressed text mode settings in the **Editor window.** The Display Rows radio button sets one of two criteria: 1. **Containing text** specifies the display of lines with the text fragment specified in the text field. Optionally, you can specify to check the case of letters, search for only whole words, or use a search expression. 2. **In which the text begins with the position** specifies the display of lines in which the text (the first character not equal to the space) begins with the position specified in the Position field. Mandatory parameters additionally characterize the criterion: - **Equal to** the first character of the text must be exactly at the specified position. For example, if you specify the 2nd position, the window displays only lines in which the text starts at the 2nd position. - **Not equal to** The first character of the text must be in any position other than the specified position. For example, if you specify the 2nd position, the window displays only lines where the text does NOT start from the 2nd position. - **Smaller than** display only lines where the text starts at a position less than specified. - **Larger than** display only lines where the text starts at a position greater than the specified position. After clicking OK, the Editor window switches to compressed text mode. ### Clipboard History/Repository | Dialog Item | Description | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Clipboard History | List of clipboard entries since the start of RadiaCode. records are collected regardless of the applications from which they were copied. < br > Clipboard history is lost after exiting RadiaCode. | | Insert | Insert the selected text into the active Editor window. | | Max. | Maximum number of records that can be saved in clipboard history. When the maximum number of records is reached, the old record is deleted. | | Don't remember more than: | Sets the maximum size of a text block that can be written to the clipboard history. If the block size for a write exceeds the set block size, the write will be ignored. | | Clipboard Repository | The Clipboard Repository is a permanent set of clipboard records (blocks of text) represented as a tree. You can add records to the repository for later use. Records can be arranged as "branches" ("folders"). Use drag-and-drop operations to organize folders and records. | | Insert | Insert the text of the selected repository entry into the active Editor window. | | Add Branch | Add a "branch" ("folder") to the active repository entry. | | Delete Branch/Record | Delete the selected branch or record. | | Edit | Edit the name of the selected branch. | | Move Up | Move the selected branch or entry up the tree. | | Move Down | Move the selected branch or entry down the tree. | ### Editor Toolbar The **Editor Toolbar** contains buttons for basic editing operations that correspond to the commands in the **Editor** menu. Almost all buttons are available only when the **Editor** window is active. Information messages sent by the editor are duplicated in the information The commands of the editor toolbar are represented by several icons (Copy Block, Text Search, Set Bookmark, etc.). You can adjust the commands to a convenient amount. After that, only the buttons you select will be visible. To select the **Screen options** dialog, right-click on the empty right side of the upper panel. In the pop-up window, select **Customize...** Enter the **Screen options** dialog box (via the **Configuration** menu). On the right panel of the dialog box, you can mark which buttons **of the Editor Toolbar** you need to work with.