tlaOpenTree
Open All Files in Directory Tree with Matching Filename
CodeWright® - API Macro - Royalty Free - 2005.01.01 17:15
Send Comments

Purpose

Open all files in directory tree with matching filename.

This function adds a new capability to CodeWright.

Operation

There are two methods for using this function: "assign to a button or menu item" and "prompt for input".

Assign to Button or Menu Item (prompt for input) ...

  • Position CodeWright to the directory to be the root of the open operations.
  • Issue the tlaOpenTree command with no filename specified.
  • When prompted, enter the filename (with wildcards).

Function call approach (no prompt for input) ...

  • Position CodeWright to the directory to be the root of the open operations.
  • Issue tlaOpenTree specifying the filename (with wildcards) for the comparison.

Example

Prompt - prompt for filename to use for comparison ...

tlaOpenTree( )

No Prompt - open all C# files in the directory tree ...

tlaOpenTree( *.cs )

Input Parameters

Optional file specification (wildcards permitted).

Return Codes

Code Message
-1 tlaOpenTree: Terminated by request.
number tlaOpenTree: number files found in tree but not loaded for 'filename'.
0 tlaOpenTree: No matching files found in tree for for 'filename'.
number tlaOpenTree: number files loaded from tree for 'filename'.

Reference

This function calls tlaError.

Compatibility

Current version verified under:

  • CodeWright 7.0b
  • CodeWright 7.0c
  • CodeWright 7.5.1
  • 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.

tlaOpenTree is included as a function in tlaTools.

Copyright © 1993-2005 Thom Little Associates, Ltd. revised 2005.01.01 17:15
One Central Square, Keene, NH 03431-3787 phone 603-357-7567