Topic: DMD0287
Rung Comment Editor
Each rung of ladder logic in a Program or Task can have a Comment associated with it. The Rung Comment Editor is used to create and edit these comments. Text for the rung comment can be entered directly into the comment field, or the programmer can use cut and paste from another comment or another editor. All the traditional Windows editing keystrokes are available for editing, and for cutting and pasting text into and out of the comment editor.
The rung comment editor can be invoked by any of
the following methods:
selecting the Tools-> Comment Editor menu selection
pressing Ctrl + K
double clicking in the rung comment area of a rung - this will be identified by the mouse cursor changing from the simple pointer to a point with the word "Cmt".
Double clicking anywhere on an existing rung comment
Comments are Free-form
The Edit Comments dialog provides a free-form edit window. This allows the programmer to enter the comment text any way they want, within the confines of the edit window.
Each rung comment can contain up to 20 lines of text, with a maximum of 2400 characters. The number of characters per line will depend on the font and the width of the characters.
Text in the rung Comment can consist of any alphabetic character, alphanumeric value, punctuation mark, and arithmetic operator; essentially any printable ASCII character can be used.
When creating a new rung Comment or editing an existing rung Comment, many of the familiar Windows keyboard shortcuts for editing functions are available, such as selecting text (SHFT+ Arrow keys), Cut (CTRL + X), Copy (CTRL + C), Paste (CTRL + V), and Undo (CTRL + Z).
Creating New Rung Comments
The following is a list of the tape transport style controls that are used to navigate through the rungs of Tasks and Programs of the project. Starting with the button on the far left:
(First Rung) - Moves to the first rung in the current code block.
(Back 5) - Moves 5 rungs backwards in the current code block.
(Back 1) - Moves to the previous rung in the current code block.
(Forward 1) - Moves to the next rung in the current code block.
(Back 5) - Moves 5 comments backwards in the current code block
(Last Rung) - Moves to the last rung in the current code block.
Note: Page Up will move to the previous rung Comment, and Page Down will move to the next rung Comment.
Note: if you have made any changes to a rung comment, you will be prompted to save these changes before moving to a different rung.
Using Goto Comment for Rung
The Edit Comments provides a Goto Comment for Rung dialog to quickly navigate to a specific rung number (or address) in a specified Code Block.
Select the destination Code Block from the drop-down menu, then enter the Rung Number (or Address) and click OK.
Code Block - selects the code-block to use, click the down arrow to select from the list of Programs and Tasks.
Address / Rung Number - designates the rung number within the selected code-block to go to, click the up or down arrow to enter the rung number.
Moving
(Cut & Paste) Rung Comments
The keyboard shortcut keys can be used to Cut and Paste individual rung
Comments, or parts of rung Comments from one rung to another.
Use either the mouse or the SHFT + arrow keys to select (highlight) the source text
Use the keyboard shortcut CTRL + X (or right-click menu option) to Cut the text
Use the Previous, Next or Goto buttons to move to the destination rung number (or address)
Position the cursor where the text is to be pasted then press Ctrl +V (or right-click menu option) to Paste the text
If there are multiple rung Comments that need to be moved, the Move Comments dialog makes the process very simple. Click the Move&ldots; button to open the Move Comments dialog.
Note: This operation has the potential to overwrite existing rung Comments if the source and destination ranges overlap. Do-more Designer will prompt the programmer for confirmation before it completes the copy.
Source Rung Comment &endash; specifies the code block and the rung number (or address) of the first comment to move.
Destination Rung Comment &endash; specifies the code block and the rung number (or address) in the code block to receive the Comment text.
Number to do &endash; Enter the number of successive Comments to copy, or click the "Thru end of Source Code Block" radio button to select all of the rung Comments from the source code rung to the end of the code block.
Addr / Rung Num group &endash; this selection selects whether the Source and Destination are rung numbers or rung addresses
Click the Move Comments button to perform the copy operation.
Click the Close button to exit the dialog.
Note: Remember that these operations only move the rung Comment text from the source rung to the destination rung; they do not change the ladder logic in either the source or destination rung.
Copying Rung Comments
The keyboard shortcut keys can be used to Copy and Paste individual rung Comments or parts of rung Comments from one rung of ladder logic to another.
Use either the mouse or the SHFT + arrow keys to select (highlight) the source text
Use the keyboard shortcut CTRL + C (or right-click menu option) to Copy the text.
Use the Previous, Next or Goto buttons to move to the destination rung number (or address).
Position the cursor where the text is to be pasted then press Ctrl +V (or right-click menu option) to Paste the text.
If there are multiple rung Comments that need to be copied, the Copy Comments dialog makes the process very simple. Click the Copy&ldots; button to open the Copy Comments dialog.
Note: This operation has the potential to overwrite existing rung Comments if the source and destination ranges overlap. Do-more Designer will prompt the programmer for confirmation before it completes the copy.
Source Rung Comment &endash; specifies the code block and the rung number (or address) of the first comment to copy.
Destination Rung Comment &endash; specifies the code block and the rung number (or address) in the code block to receive the Comment text.
Number to do &endash; Enter the number of successive Comments to copy, or click the "Thru end of Source Code Block" radio button to select all of the rung Comments from the source code rung to the end of the code block.
Addr / Rung Num group &endash; this selection selects whether the Source and Destination are rung numbers or rung addresses
Click the Copy Comments button to perform the copy operation.
Click the Close button to exit the dialog.
Note: Remember that these operations only copy the rung Comment text from the source rung to the destination rung; they do not change the ladder logic in either the source or destination rung.