Purpose

Emulate Brief End and Home Commands.

This function, unlike the function in the CodeWright Brief keymap, provides a true emulation of the Brief editor End key.

Operation

With the tlaBriefEnd( ) assigned to the End key ...

• End of Line - hit End key one time,

  • Hit the End key one time and the cursor will move after the last character on the current line.

• End of Screen - hit End key two times.

  • Hit the End key two times and the cursor will move after the last character on the last line in the screen.
  • If the cursor started at the end of a line only one hit of the End key is needed.

• End of Buffer - hit End key three times.

  • Hit the End key three times and the cursor will move after the last character of the last line in the buffer.
  • If the cursor started at the end of the screen only one hit of the End key is needed.
  • If the cursor started at the end of a line only two hits of the End key is needed.

With tlaBriefHome( ) assigned to the Home key ...

• Start of Line - hit Home key one time,

  • Hit the Home key one time and the cursor will move to the first character of the current line.

• Start of Screen - hit Home key two times.

  • Hit the Home key two times and the cursor will move to the first character of the screen.
  • If the cursor started at the first character of a line only one hit of the Home key is needed.

• Start of Buffer - hit Home key three times.

  • Hit the Home key three times and the cursor will move to the first character of the buffer.
  • If the cursor started at the first character of the screen only one hit of the Home key is needed.
  • If the cursor started at the first character of a line only two hit of the Home key are needed.

Example

KmapAssign='<end>','tlaBriefEnd( )'
KmapAssign='<home>','tlaBriefHome( )'

Input Parameters

None.

Return Codes

Reference

This function calls tlaError.

Compatibility

Current version verified under:

• CodeWright 7.0b
• CodeWright 7.0c
• CodeWright 7.5.1
• CodeWright 7.5.2
• CodeWright for .NET 7.0

CodeWright for .NET Restriction

None.

Installation

There are three primary methods for installing this macro on your system. Method A uses the tlaMDE tool available for purchase from this website. Method B manipulates the macro repository directly. Method C uses the API Macro... tool provided in every copy of CodeWright (but not CodeWright for .NET).

Method A - tlaMDE - CodeWright or CodeWright for .NET

• Select the Code button on this page.
• When the second window opens, select all the text in the text box.
• Issue Ctl-C (copy).
• Create a new file in CodeWright or CodeWright for .NET.
• Issue Ctl-V (paste).
• Issue tlaMDE C (save and compile).

Method B - Copy to Repository - CodeWright or CodeWright for .NET

• Select the Code button on this page.
• When the second window opens, select all the text in the text box for a macro.
• Issue Ctl-C (copy).
• Load the macro repository "cwright.mac" from your CodeWright or CodeWright for .NET root:
• issue Ctl-End to go to the end of file.
• Issue Ctl-V (paste).
• Close the file and respond yes to the write request.

Method C - API Macro ... - CodeWright Only

• Select the Code button on this page.
• When the second window opens, select text from the text box for a macro:
  • Do not select the [API Macro ... header line.
  • Select all other lines in the macro.
• Issue Ctl-C (copy).
• Open the CodeWright Tools | API Macros... dialog.
• Press the New button.
• Select the Edit box.
• Issue Ctl-V (paste).
• Double-click on the function name in the header of the macro.
• Issue Ctl-C (copy).
• Select the Name box.
• Issue Ctl-V (paste).
• Delete the trailing blank from the name.
• Select the Save button.
• Select the Close button.
• Repeat this process for each macro in the text box.

Purchase

tlaTools is a Dynamic Link Library that contains most of the API macros on this website in a single easy to install package. The tlaTools DLL can be purchased by selecting the Buy button on this page.

tlaBrief is included as a function in tlaTools.