ColdFusion Builder provides a CFML Editor that has feature-rich code editing capabilities for CFM, CFC, HTML, JavaScript, and CSS files. The CFML Editor assists you in writing code by including features like, code completion, and streamlined code navigation. The CFML Editor lets you use different colors and fonts to display your code in the workspace.

You can customize your development environment by setting editor profiles and preferences.

Editor profiles

An editor profile lets you group  and save  the following editor preferences under one profile.

• Code Assist
• Syntax Coloring
• Keys
• Outline
• Syntax Checking
• Typing
• Task

Editor profiles are useful when you have different editor preferences for various development needs. For example, you can select a set of preferences like Code Assist, code colorization, and keyboard shortcut preferences and save them under a single editor profile. You can apply all these settings at once by selecting the editor profile.

To create an editor profile, do the following:

You can also modify default settings and save the modified settings as a new profile. Additionally, you can also import or export profiles.

By default, ColdFusion Builder provides three editor profiles:

• Default - Sets the ColdFusion Builder default editor preferences
• Dreamweaver - Sets editor preferences similar to Dreamweaver editor preferences
• CFEclipse - Sets editor preferences similar to CFEclipse editor preferences

To select an editor profile, click the Active Profile drop-down list in the Profiles dialog box, and select the profile.

Editor preferences

You can specify default filenames for the CFM and CFC files that you create. To remove any trailing whitespaces in the file, select Trim Spaces Before Saving Files.

You can also specify any text or boilerplate code that must appear, by default, in every CFM and CFC file. For example, suppose you want copyright information to appear in every CFC file that you create. In this case, you can specify the copyright text in the CFC tab under New File Settings.

The editor preferences that you can set include code assist, code colorization, keyboard shortcuts, outline view, syntax checking, and typing preferences.

Optimizing ColdFusion Builder performance

The preference options that you select affect the performance of ColdFusion Builder. For faster editor performance, you can apply preset editor preferences

To apply preset editor preferences, click Optimize Editor Preferences. The following preference settings are applied:

Code Assist

The following options are deselected.

• Automatically Display Code Assist When Typing
• Automatically Display SQL Code Assist When Typing
• Automatically Insert A Single Proposal
• Automatically Insert A Closing Tag

The following options are selected.

• Append Space After Inserting Selection
• Automatically Insert Equal Sign (=)
• Automatically Quote Attributes

Typing

• Enable Auto-insertion is selected.
• All the Auto-insert Matching Character For options are deselected.
• Auto-close Tags is selected as Never.

Code Assist

Code Assist is designed to assist you with code completion. Depending on the code that you enter, hints relevant to complete the code appear. As you type the code in the CFML editor, Code Assist prompts you with a list of valid CFML tags, parameters, and attributes. These suggestions appear in a pop-up menu. If you have HTML, JavaScript, or CSS content within the CFML code, Code Assist displays code completion hints for this code as well. Double-click or press Enter, to insert the code completion hint in the CFML Editor.

Code Assist is also available for script-based syntax; for example, code hints appear for functions and components in the script syntax. When you import Ajax libraries into ColdFusion projects, Code Assist is available even for the JavaScript code.

Using Code Assist

Code hints appear whenever the framework or language (CFML, HTML, JavaScript, and CSS) provides options for you to complete the current expression. For example, if you type within a CFML tag, you are prompted with a list of all the attributes of that tag.

In a CFML page, begin entering a CFML tag by typing:<cf Relevant code hints are displayed as follows:

Code hints

The Smart Tag Assist feature of the CFML editor identifies if a tag attribute is already entered for a particular tag. If you have already entered a tag attribute, that attribute does not appear in the list of suggested attributes.

Code Assist for CFM pages

• Displays methods and component list when you use the <cfinvoke> tag in a CFM file.
• Displays a drop-down list of predefined attributes and values when you press <cf+Ctrl+<space>.
• Displays a list of components (CFC) that can be loaded using createobject() or the <cfobject> tag.
• Displays methods created in a CFC, which can be called using the component object created in a CFM. Also displays a list of methods of all extended CFC files.
• Displays a drop-down list of all built-in and user-defined functions.
• Provides a list of variables, like, struct, array, query. These variables are declared in a page. The variables also appear as Code Assist for attribute values.
• Displays all the queries created using <cfquery> or queryNew(). To view the recordset, type <cfoutput query="">, and press Enter. or use  queryname . (that is, query name followed by dot).
• Includes the functions, variables, tags, and queries from another CFM page once it is included in the current CFM page using the {{<cfinclude> }}tag.
• Allows you to browse and select a file as the input value for an attribute of CFM tags. CFM tags that require a file as the input value include <cfinclude>, <cfimage>, <cfdirectory>, <cfpdf>, <cffile>, <cfzip>, <cfspreadsheet>, and <cfcollection>.

Code Assist for CFC pages

• Displays a list of components (CFC) that can be loaded using  createobject ().
• Displays a list of components (CFC) that can be loaded using the <cfobject> tag.
• Displays methods created in a CFC, which can be called using the component object created in a CFM.Examples:
  • <cfset obj1 = createobject("component", "c1")><cfset x = obj1.method1()>
  • <cfset obj2 = createobject("component", "c2").init()>
  • <cfset obj3 = new "c3"().method3()>
  • <cfinvoke component="c4" method="method4">
• Displays a list of methods of all extended CFC files. The "extends" and "implements" keyword/attribute lists the available components and interfaces.

• Displays a list of components that can be extended in the current CFC file.

• Displays a list of interfaces that can be used in a CFC with the implement keyword.
• Allows you to browse and select a file as the input value for an attribute of CFM tags or functions like <cfif fileexists()>. CFM tags that require a file as the input value include <cfinclude>, <cfimage>, <cfdirectory>, <cfpdf>, <cffile>, <cfzip>, <cfspreadsheet>, and <cfcollection>.

Code Assist for scoped variables using variable mapping

Many ColdFusion frameworks create CFCs during application startup and store these CFCs as scope variables. To provide Code Assist for such CFCs, ColdFusion Builder must determine the content and data type (fully qualified name of the CFC).

To enable Code Assist for CFCs that are stored in scoped variables, define a project-level mapping for the variable name and its corresponding CFC type. ColdFusion Builder uses this mapping information and displays a list of CFC methods for the mapped variable, without creating an object of that data type. For example, you can map mycfc1 to com.adobe.mycfcs.cfc1. When you type mycfc1 and press Ctrl+<space>, all the methods available for com.adobe.mycfcs.cfc1 appear.

To configure a variable mapping, in the Properties dialog box, Specify the variable to map as mycfc1 and the mapped to value as com.adobe.mycfcs.cfc1. For more information, see Configure variable mappings.

Code Assist for ColdFusion ORM

Object Relational Mapping (ORM) is a programming technique that lets you define a mapping strategy using object models. You can use Object Relational Mapping to store and retrieve data from a relational database.

ColdFusion Builder provides Code Assist for the following ColdFusion ORM settings:

• Entity names in entityLoad, entityNew, and entityFindByPK functions.
• Methods and properties returned by entityLoad, entityNew, and entityFindByPK functions.
• Code hyperlinks for entity names and methods.
• Data sources in application.cfc. For example, <cfset this.datasource = >.
• Table attribute of the  cfcomponent  tag.

For more information about using ColdFusion ORM, see ColdFusion ORM in the ColdFusion Developer Guide.

Code Assist for Application.cfm and Application.cfc files

Code Assist is available for Application.cfm and Application.cfc files.

Application.cfm is considered an included file and Code Assist is available for all variables and functions within the file.

For Application.cfc, Code Assist is available only for scoped variables that are declared in onApplicationStart.

Set CFML Editor Code Assist preferences

• You can choose to automatically quote attributes and select closing tags.

Code hyperlinks for CFCs and UDFs

Component names and UDFs are hyperlinked on Ctrl+hover. If you click the hyperlink, the corresponding code is opened in ColdFusion Builder. Code hyperlinks are available for:

• UDFs: local, included, and cfc.udfName
• Template in <cfinclude template=””>
• CFCs in createobject(), <cfobject>, <cfinvoke>, new keyword, and extends attribute.

CFC name resolution using server mapping

Use ColdFusion Administrator to define server mapping for CFCs. The server mappings allow you to view these CFCs as part of Code Assist when you use the extend or implement keywords.

ColdFusion server mappings let cfobject and cfinvoke tags, or functions like createObject or new, access pages and find ColdFusion components outside the document root.

If you specify a path in these tags that starts with the mapping's logical path, ColdFusion looks for the CFC using the mapping's directory path. You can define server mapping for the CFCs using the ColdFusion Administrator. After mapping, you can view the CFCs in Code Assist when you use the extend or implement keywords, and component or method attributes. The CFCs suggested in Code Assist are resolved with their fully qualified names.

Once mappings are created for the CFC name resolution from the server, the server settings are cached and available even when the server is not running. The server settings are collected when the server is started or refreshed from ColdFusion Builder.

Specify server settings

CFML Dictionaries

ColdFusion Builder provides in-built dictionaries that assist you with CFML code completion. The CFML dictionary is an XML file that contains information about each tag and function contained in the library. For example, the CF9 dictionary file (cf9.xml) contains information about all the available CF9 tags and functions.

ColdFusion Builder provides dictionary support for ColdFusion 11, ColdFusion 10, ColdFusion 9, ColdFusion 8, and ColdFusion MX7 versions.

To select a dictionary version, do the following:

Create custom CFML dictionaries

You can create a custom CFML dictionary (XML file) and make it available to use for Code Assist and Tag Editor within ColdFusion Builder.

See the cf9.xml or cf8.xml files as reference to create the custom CFML dictionary.

Auto-insertion of required attributes

In the Code Assist (Window > Preferences > ColdFusion > Profiles > Editor > Code Assist), select Auto Insert Required Tag Attributes to insert the required attributes of a tag.

For example, if you select cfpdf "action=write", all the required attributes destination, source, and name are automatically inserted.

If the preference is not selected, the attributes are not inserted but only proposed.

Separate list of required and optional attributes

Code Assist prompts you with a list of tag attributes as follows:

• Shows required tag attributes at the top of the proposal list with check marks to indicate that the attributes are mandatory.
• A line separates the mandatory and optional attributes.

Proposals for createObject

Code Assist proposes all objects (and the corresponding arguments) supported by the function createObject.

Cyclic Code Assist proposals

In the Code Assist (Window > Preferences > ColdFusion > Profiles > Editor > Code Assist), select Cycling Code Assist Proposals for cyclical code assistance.

Consider the scenario where when you press Ctrl+<Space>:

• Variables, scopes, and UDFs are listed
• On this list, if you further press Ctrl+<Space>, all built-in functions are proposed
• On this list, if you further press Ctrl+<Space>, all proposals are listed.
• The cyclic proposals continue on subsequent use of Ctrl+<Space>.

Filter proposals containing text

In the Code Assist (Window > Preferences > ColdFusion > Profiles > Editor > Code Assist), select Filter Proposals Containing Text to filter proposals based on the text you specify.

All proposals that contain the filter text you specified are listed with selection set to the proposal that starts with the specified text.

Datatype-aware Code Assist

Shows Code Assist proposals based on expected data types.

For example, when you load Code Assist within the function Abs, it shows functions and variables of type numeric, Any, or complex data types such as array, struct, or component.

Auto-insertion of function arguments

When you insert a function, all required arguments are automatically inserted. By default, the first argument is selected.

Function context assist

• ColdFusion Builder displays function context assist whenever you load Code Assist inside function parameters.

• Parameter that you currently edit is highlighted in bold.

• Optional parameters are displayed inside [].

Smart Code Assist for connection attributes

Smart Code Assist displays connection variables created for tags such as cfexchangeconnection and cfftp.

Usage-based Code Assist for cfloop

Based on the type of loop, the required attribute is auto-inserted. For example, if you loop over an array, the attribute index is auto-inserted.

Select tag blocks of your choice

Use the shortcut Ctrl+Alt+B (Windows) or Command+Option+B (Mac) to select tag blocks. The enclosing tag block from the caret position is selected.

Retain the selection and repeat the shortcut for cumulative selection of code.

For example, in the following snippet, when you press Ctrl+Alt+B/Command+Option+B, the cfform tag block is selected. If you retain the selection and then press Ctrl+Alt+B/Command+Option+B, code selection is extended to the next level of enclosure. That is, the entire code block is selected.

Jump to matching tag

Use the shortcut Ctrl+Alt+M (Windows) or Command+Option+M (Mac) to move the caret position from beginning to end or end to beginning of a tag block.

Quick Fix

Quick Fix recognizes the usage of methods, classes, and CFC/CFM files in the code and helps you generate them.

For example, if you type a user-defined function {{test() }}that is not defined in the page or any included page, Quick Fix helps you generate the function. The function call is inserted in the file.

When you open/edit a file, ColdFusion Builder automatically identifies the function calls, CFCs, and CFMs that are not defined. A bulb icon appears in the left margin of the editor which, if clicked, prompts you to perform the appropriate quick fix.

You can turn off the Quick Fix by unchecking Enable Quick Fix (Window > Preferences > ColdFusion > Profiles > Editor > Syntax Checking).

Quick Fix helps you in the following scenarios:

• Call to local UDF in any language construct, for example cfset or cfscript assignment, function arguments, or any other expression. If you specify any arguments in the UDF, then Quick Fix also creates the arguments. Depending on where the function is called, ColdFusion Builder generates the code.Both tag and script-style syntax are supported, depending on the context. That is, Quick Fix generates a method in script-style if it is called in script-based syntax.
• Method call on a CFC, for example cfc1.function1(). If function1 is not defined in CFC1, then Quick Fix creates it.
• Create CFC from createObject, new, cfobject, and cfinvoke. ColdFusion Builder provides options to create CFC with respect to wwwroot (if the server is associated with the project), project, or in a folder selected by the user.
• Create CFM page from cfinclude and cfmodule
• Create CFCs and CFMs from extends and implement attributes.

Example

Code Formatter

Formatting your code

Customizing the preferences

Code Formatter has an off-the-shelf set of preferences defined in a profile. To customize the preferences, create a profile or modify the default profile after giving a new name.

Sharing the preferences

You can share the formatting preferences in XML format.

Use the appropriate buttons in the Formatter section of the Preferences dialog box (Window > Preferences > ColdFusion > Profiles > Editor > Formatter) to export your preferences or import preferences shared by somebody.

Auto-formatting

ColdFusion Builder automatically indents lines of code and adjusts the ending tag, to improve readability.

Auto-formatting works in the following scenarios:

When you type code

• Indents when you press  Enter with the cursor placed after
• > of the start tag
• Opening curly brace ({)
• > for  closing  tag.
• the closing tag if it is auto-completed while typing </.
• When closing, curly brace (}) is placed in alignment with the opening curly brace ({).

When you use Code Assist

• If you auto-insert closing tag, while typing forward slash (/), it is placed at the correct location with respect to the start tag.
• If you auto-insert closing tag, it is aligned to the start tag.

Code colorization

ColdFusion Builder can highlight the syntax for CFML tag names, attributes, attribute values, keywords, comments, and various other elements in different colors. Code colorization is also supported in script-style coding. You can customize the color preferences and override the default Eclipse editor color preferences.

Set CFML Editor color preferences

Set SQL Editor color preferences

SQL Editor

The CFML editor has an integrated SQL editor that lets you edit, write, and execute SQL statements.

To use the SQL editor, you must have a server configured and running in ColdFusion Builder. The SQL editor does not support offline databases.

The SQL Editor supports Code Assist and code colorization for the following types of SQL statements:

• Select
• Insert
• Update
• Delete

Using SQL Editor

For more information about basic SQL syntax and writing SQL statements, see Using SQLin the ColdFusion Developer Guide.

SQL Code Assist

SQL Code Assist is available only for database table names and field names in the SQL statement.

By default, SQL Code Assist is turned on in ColdFusion Builder, and code hints for SQL statements are automatically displayed in the CFML Editor. To turn off the automatic display of SQL Code Assist, do the following:

Even with the automatic display of SQL Code Assist turned off, you can still get code hints within your SQL statements as follows:

ColdFusion Builder provides Code Assist for the query attribute of the <cfoutput> tag. For example, when you type, <cfoutput query="">, and press Ctrl+<Space> with the caret position between the double quotes "". A list of queries created in that file or included files appears.

Code Assist is also provided for query names that are used in expressions.

For example, if you create a query like:

When you type the expression <cfset name = q1.> and press Ctrl+<Space>, ColdFusion Builder displays the columns selected in that SQL query.

SQL Code colorization

In the CFML editor, SQL code colorization is supported only within the  cfquery  tag. You can colorize SQL keywords, comments, and text within the  cfquery  tag. Colorization is supported only for the following types of SQL comments:

• /* */
• –

To set SQL code colorization preferences, see Set SQL Editor color preferences.

Code folding and unfolding

The CFML editor provides many shortcuts for navigating through your code. Shortcuts include folding and unfolding code blocks, opening the source of code definitions, and browsing and opening types. You can collapse and expand multiline code blocks to navigate, view, and manage complex code documents. In ColdFusion Builder, collapsing and expanding multiline code statements is called code folding and unfolding. You can use this feature in a CFM, CFC, or HTML file.

You can hide and display code blocks of your preference. The code folding that you define is saved and therefore is available for future sessions.

• In the CFML Editor, click the fold icon (-) or the unfold icon (+) in the left margin of the editor.

Folding a code block hides all but the first line of code.

Move the pointer over the unfold icon  to show the folded code in a tool tip.

Unfold a code block to make the code visible

• By default, all the lines of code are expanded. To fold or collapse all the lines of code except the first line, right-click in the left margin of the editor. Then select Folding > Collapse All.

Add code folding

Remove code folding

To remove code folding for a block of code,

1. Place the cursor on the first line of code and then repeat the steps used to fold the code.

Syntax checking and highlighting

When you select a tag or code bracket in a CFM file, the matching pair of the tag or bracket is automatically highlighted.

If you type code that is not recognized as valid CFML code, you are notified in the following ways:

• A cross-mark appears next to the line of code.
  Hovering your pointer on the cross-mark gives more details about the error.
• The Problems view lists the errors
  
  Each message contains a brief description of the error, the file and folder in which the error occurs, and its line number in the file. When you double-click the error, the file is opened in the editor and the line of code is highlighted.

Depending on the nature and severity of the errors, your application sometimes does not run properly until the errors are corrected.

Syntax checking preferences

Navigate through code

Code navigation

Use the shortcuts Ctrl + Shift + Up arrow key and Ctrl + Shift + Down arrow key (Windows) or Command + Shift + Up arrow key and Command + Shift + Down arrow key (Mac) to easily navigate inside your code.

Code navigation works for both tag and script-based syntax.

The following sections explain how code navigation functions in various scenarios:

In CFM files

Caret position changes from a user-defined function to the next or previous one.For example, in the following snippet, if the caret position is on or within func1, if you press Ctrl + Shift + Down arrow key, then the caret position moves to func2 and selects the function name. From anywhere on or within funct2, }}if you press Ctrl + Shift + Up arrow key, then the caret position changes to {{func1 function and selects the function name.

In CFC files

Caret position changes

• From a user-defined function to the next or previous one.

• To the top-level members of the CFC, for example to  cfproperty  directly inside the CFC. For example, in the following snippet, if you navigate from line number 1 (<cfcomponent>) downward, then caret position first changes to line 2 (<cfproperty name="prop1">), and further to line 4 (<cffunction name="func1">), and line 6 (<cffunction name="func2">). Moving upward, the caret position changes, taking the same path in the reverse order.When the caret position changes to  cfproperty , the name is selected.

In flow-control statements

For flow-control statements provided in CFScript (for example, in statements if-else, switch-case, and try-catch), in both CFC page and CFM page, caret position changes to the next or previous code blocks if the caret position is within any of these statements.For instance, if you press the same key combination withincfif tag, then caret position changes to the next cfelseif or cfelse statement.In the following example, if you navigate down from

• Line 1 (<cffunction name="func1">), caret position changes directly to line 10 (<cffunction name="func2">).
• Within  cfif  in line 2 (<cfif a eq 10>), caret position changes to line 4 (<cfelseif a gt 10>) andcfelseif  is selected, provided the caret position is on line 2.
• Line 4 (<cfelseif a gt 10>), caret position changes to line 6 (<cfelse>)and cfelse is selected
• Line 6 (<cfelse), caret position changes to line 8 (</cfif>).
• Line 8 (</cfif>), caret position changes to line 10(<cffunction name="func2">) and func2 is selected.

If you do a reverse navigation (Ctrl + Shift + Up arrow key),

• From line 6 (<cfelse), caret position changes to line 4 (<cfelseif a gt 10>) and {{cfelseif }}is selected.
• From line 10, caret position changes to line 1{{ (<cffunction name="func1">}}).

Smart tab navigation

You can quickly navigate to the next (use Ctrl + ] on Windows or Command + ] on Mac) and previous (use Ctrl + [ on Windows or Command + [ on Mac) function argument or tag attribute.

If caret position is at function call or tag name, for downward navigation, the position changes to the first parameter/attribute value.

For nested function calls, caret position changes to the next or previous parameter when you reach the end/beginning of parameters.

Smart tab navigation is applicable to cffunction arguments also in the case of function definition, for example

<cfscript>function abc(int a, int b) access=”package” output=”false”</cfscript>

In this case, when the caret position is on abc or function, it navigates to int a, int b , package, andfalse.

Smart tab navigation applies to both tag-based and script-based syntax.

Code refactoring

Code refactoring is the process of improving the source code of a program without changing the overall result. Generally, code refactoring improves code readability and maintainability.

ColdFusion Builder supports various refactoring techniques like renaming, searching, and previewing of CFCs, CFMs, and UDFs at the project and workspace levels.

Refactor CFC or CFM filenames

When you rename a CFC or CFM, you can refactor all valid instances of the CFM or CFC, including all references to the CFM or CFC.

Refactor UDFs in CFC or CFM filesTo undo refactoring, use the keyboard shortcut Ctrl+Z (Windows) or Command+Z (Mac).

Notes and considerations

• The location of a CFM or CFC file cannot be changed although the inherent Eclipse editor provides the capability to move files using the Move option.
• The CFML Editor does not support renaming a folder although Eclipse provides this option.

Refactoring methods

You can refactor methods created for application variables by creating variable mappings.

For example, consider a scenario where an application variable is defined for a CFC object as follows:

Say, you have a CFC function, Method(), that you call as follows:

Reference search

To refactor the Method() function, create a variable mapping for the application variableApplication.appVar as follows:

You can search for a CFC, CFM, or UDF in a project or workspace.

Other than searching for references at the project or workspace level, you can search for references while working in the CFML code editor. Right-click in the CFML editor and select References > File to search for file references. You can also search for references at the project and workspace level from within the CFML editor.

Tag Editor

The Tag Editor assists you in adding tags and their attributes, even if you are not familiar with CFML. To use the Tag Editor in ColdFusion Builder, do the following:

Typing preferences

When typing CFML tags, you can customize your typing preferences. You can specify preferences like the following:

• Auto-insert closing tags and matching characters (like, quotes and curly brackets)
• Auto-indent child tags on pressing Enter and replace whitespace with indentation character
• Auto-change the matching tag when you modify a pair tag
• Auto-suggest single quote and double quote when you quote attributes

Set CFML Editor typing preferences

Auto-insertion is enabled, by default. You can auto-insert matching characters for single and double quotes, brackets, and the ’#’ sign.

To turn off auto-insertion, do the following:

CFML Editor keyboard shortcuts

ColdFusion Builder lets you:

• Use a Quick Assist that displays a catalog of shortcuts related to wizards, tags, and custom shortcuts
• Create custom keyboard shortcuts
• Modify and remove shortcuts
• Search shortcuts for specific action based on filter text
• Export shortcuts in CSV format and import
• Restore defaults shortcut settings

Default shortcuts

Default shortcuts are the factory defaults listed in the Preferences dialog box (Window > Preferences > ColdFusion > Profiles > Keys).

You can import and export default shortcuts, but cannot change their name or description.

You can temporarily remove default shortcuts or modify them. When you click Restore Defaults in the Keys section of the Preferences dialog box, you lose all shortcuts you added, and any modifications. Also, the default shortcuts you deleted are restored.

Shortcut conventions

For ease of organizing and use, it would be a best practice to follow a standard format for your keyboard shortcuts. For the default shortcuts, ColdFusion Builder follows the following formats:

• For tags, Ctrl + T (Windows) or Command+T (Mac). For example, Ctrl + T, A (Windows) or Command+T, A (Mac) for  cfabort .

• For wizard-related shortcuts, Ctrl+Alt+W (Windows) or Command+Option+W (Mac).

Similarly, follow a convention which can make your shortcuts intuitive.

Also, to avoid shortcut conflicts, ensure that you define unique key bindings.

Create custom keyboard shortcuts

Define caret position

You can use macros to define caret position in the text (for which you create the shortcut) when it appears in the editor.

In the Keys section of Preferences dialog box, when you insert the text, specify the $${cp} macro in the position where you want the cursor to appear.

For example, if you specify

if($${cp}){ <cfoutput>#A#</cfoutput>}

with the binding Alt + T, when you use the shortcut, the block of text is inserted in the editor with the cursor between the parentheses that follows{{ if}}.

Quick Assist

Quick Assist shows up the catalog of shortcuts for quick reference:

• Press Ctrl+T (Windows) or Command+T (Mac) to launch Quick Assist for tag-related shortcuts and custom keyboard shortcuts.
• Press Ctrl+Alt+T (Windows) or Command+Option+T (Mac) to launch Quick Assist for wizards-related shortcuts.
• Press the part of the custom keyboard shortcut that precedes comma. For example, assume that you have set the bindings Alt+T, A and Alt+T, B. Then, if you press Alt+T, Quick Assist lists both the shortcuts.

Additional resources

• A cheat sheet of keyboard shortcuts in ColdFusion Builder ColdFusion Builder engineering team member Sagar Ganatra lists all the shortcuts in ColdFusion Builder.
• ColdFusion Search vs Eclipse Search ColdFusion Builder engineering team member Kiran Sakhare provides a comparison between Eclipse Search and ColdFusion Builder search.
• Keyboard shortcuts in ColdFusion Builder ColdFusion Builder engineering team member Sagar Ganatra explains the keyboard shortcut enhancements in ColdFusion Builder 2.

ColdFusion Builder Search

ColdFusion Builder Search provides specialized find and replace functionality to search text or tag. Apart from searching the current document, the scope of search can be any open document, selected resources in the Navigator pane, project, working set, workspace, local directory, FTP location, or RDS location. The feature also supports regular expressions and multi-line search.

To save time, you can run remote search in the background and continue with other tasks. The Search View provides the results with details of matches in each file you search.

ColdFusion Builder search applies only to the following file types: CFC, CFM, HTML, XML, CSS, and JS.

Performing search

1. To search (and not perform any action), click Find or Find All.

• Find jumps to and selects the next occurrence of the search text (only) in the current document.If  tag  is selected, the tag block is highlighted.
• Find All lists the files and the number of matches in each file in the Search View.

1. To replace found text/perform  action  on  tag , click Replace or Replace All.

Search options are saved when you close ColdFusion Builder.

ColdFusion Builder Search View

ColdFusion Builder Search View displays the search results of  current  search and maintains the history of previous searches.

ColdFusion Builder Search View

• Shows results only if the user clicks Find All.
• Displays results with folder hierarchy; click the file to see the search instances.
• Displays the line numbers for  code  if search criteria  matches . Double-click the line to open the file and see the specific occurrence.
• Indicates if no matches are found.

Additional resources

• ColdFusion Builder Search\Replace ColdFusion Builder engineering team member Sagar Ganatra explains the features of ColdFusion Builder search.
• Tag search ColdFusion Builder engineering team member Sagar Ganatra explains how to find tags that match your search criteria.

Add tasks to Task View

If you define tasks as CFML comments, the Task View (Window > Show View > Tasks) displays them based on the priority you set. The tasks are listed according to the default TODO and FIXME tags or the custom task tag prefix.

Add tasks

or in cfscript

and

View tasks

The Task View (Window > Show view > Tasks) displays the first line of the CFML task comments.The priority column indicates if the task is of high, normal, or low priority. High priority tasks are indicated using red color.Tasks in all open CFM files are displayed. Since the tasks are saved, they are displayed in the later sessions, when you open the files.

Create a custom Task Tag

Removing tasks

Manually delete the tasks from the source code.This is unlike the tasks you manually create in the Task View, which can be deleted in the View itself.