Clip

Clip  ....

The [Clip] Menu option opens a Dialog for Sources Templates. Select a Template with the two List Boxes, click on the[OK] button: The Template is copied to the ClipBoard, ready to be pasted in your source.

In the right part of the Dialog, two flags can be set for Data on/off and for  Local/Global symbols. In most cases they should be of no use.

Down there, you will see an Edit Box for some 'Generic Name'. The so called 'Generic Name' is to be added at the beginning of all the Templates symbols, in order to save you from renaming.

Let us take an example. In RosAsm Data, there is a recorded Template for MessageBox api calls, which looks like this:

[@Title: '' '', 0

  @Message: '' '', 0]

  call 'USER32.MessageBoxA'  &NULL,  @Message,  @Title,  &MB_SYSTEMMODAL

If you set, for example the flags to ''Without Data'' and ''Global Scope'' and the Generic Name record to 'MyBase'', after you hit [OK], the ClipBoard will hold:

call 'USER32.MessageBoxA'  &NULL, MyBaseMessage, MyBaseTitle,&MB_SYSTEMMODAL

If you set the flags to ''With Data'' and ''Local Scope'', your ClipBoard will hold:

Local @Title, @Message

call 'USER32.MessageBoxA'  &NULL,  D@Message,  D@Title,  &MB_SYSTEMMODAL

As you may guess, if you load, for example, a Macros Set, the flags and Generic Name are not used.

You can edit the Clip file (The default file name is 'Clip.txt') with any text editor for modifications and  additions. If you have something that might be useful to others, do not forget to send it to me for re-distribution. 

In order to preserve your own choices from overwriting  when downloading a new RosAsm release, you can rename it, or save it in a particular folder. Run [Configuration] / [Files Locations] to define your new Path/Name.

Adding a Template

If you select a Block of Source before running the Clip Dialog, the [Add Template] Button is enabled. If you choose this Option, you are asked for the Name that will be added in the second ListBox list. If no Item is selected in this second ListBox, the Template is appended at the end of the Group. If an Item is selected, the next Template is inserted at that place.

Deleting a Template

As it says: Select a Template and it will be deleted if you answer [Yes] to the Message Box.

Groups Management

It is the same for [Add Group] [Del Group Name] [Del Group with Templates] . 'Add' offers you to either insert at the current selection (first ListBox) or to append, at the end of this first List.

~~~~~~~